Visão Geral
Codespaces são automaticamente excluídos depois que forem interrompidos e permanecerem inativos por um número definido de dias. O período de retenção para cada codespace é definido quando o código é criado e não muda.
Todos os que têm acesso a GitHub Codespaces podem configurar um período de retenção para os codespaces que criam. A configuração inicial para este período de retenção padrão é de 30 dias. Usuários individuais podem definir este período dentro do intervalo de 0 a 30 dias. Para obter mais informações, consulteConfigurando a exclusão automática dos seus codespaces".
Como proprietário da organização, você pode querer configurar restrições no período máximo de retenção de codespaces criados para os repositórios pertencentes à sua organização. Isso pode ajudar você a limitar os custos de armazenamento associados aos codespaces que são interrompidos e deixados sem uso até que sejam automaticamente excluídos. Para obter mais informações sobre as cobranças de armazenamento, consulte "Sobre a cobrança para o GitHub Codespaces." É possível definir um período máximo de retenção para todos ou para repositórios específicos pertencentes à sua organização.
Definindo políticas específicas da organização e do repositório
Ao criar uma política, você define se ela se aplica a todos os repositórios da organização ou apenas a repositórios específicos. Se você criar uma política de toda a organização com uma restrição de retenção de codespace, as restrições de retenção em todas as políticas direcionadas a repositórios específicos devem ser mais curtas do que a restrição configurada para toda a organização ou não terão efeito. Aplica-se o período de retenção mais curto - em uma política de toda a organização, uma política orientada a determinados repositórios, ou o período de retenção padrão em configurações pessoais de alguém.
Se você adicionar uma política para toda a organização com uma restrição de retenção, você deverá definir o período de retenção para o período mais longo aceitável. Em seguida, é possível adicionar políticas separadas que definam o período de retenção máximo para um período mais curto para repositórios específicos na sua organização.
Adicionando uma política para definir um período máximo de retenção de codespace
-
In the top right corner of GitHub.com, click your profile photo, then click Your organizations.
-
Ao lado da organização, clique em Configurações.
-
Na seção "Código, planejamento e automação" da barra lateral, selecione Codespaces e, em seguida, clique em Políticas.
-
Na página "Políticas do codespace", clique em Criar política.
-
Insira um nome para sua nova política.
-
Clique Adicionar restrição e escolha Período de retenção.
-
Clique para editar a restrição.
-
Insira o número máximo de dias que os codespaces podem permanecer parados antes de serem excluídos automaticamente e, em seguida, clique em Salvar.
Atenção:
- Um dia, neste contexto, é um período de 24 horas, que começa no momento do dia em que o codespace foi interrompido.
- O intervalo válido é de 0 a 30 dias.
- Definir o período para
0
resultará em codespaces excluídos imediatamente quando forem interrompidos ou quando vencerem devido a inatividade.
-
Na área "Alterar destino da política", clique no botão suspenso.
-
Selecione Todos os repositórios ou Repositórios selecionados para determinar em quais repositórios esta política será aplicada.
-
Se você escolheu repositórios selecionados:
-
Clique em .
-
Selecione os repositórios aos quais você quer que esta política seja aplicada.
-
Na parte inferior da lista de repositórios, clique em Selecionar repositórios.
-
-
Se você quiser adicionar outra restrição à política, clique em Adicionar restrição e escolha outra restrição. Para obter informações sobre outras restrições, consulte "Restringindo o acesso aos tipos de máquina, "Restringindo a visibilidade das portas encaminhadas" e "Restringindo o período de tempo limite".
-
Após terminar de adicionar restrições à sua política, clique em Salvar.
A política será aplicada a todos os novos codespaces que forem criados.
Editando uma política
Você pode editar uma política existente. Por exemplo, você deve adicionar ou remover restrições de uma política.
A restrição do período de retenção só é aplicada aos codespaces quando são criados. A edição de uma política não tem qualquer efeito sobre os codespaces existentes.
- Exibir a página "Políticas de codespaces". Para obter mais informações, consulte "Adicionando uma política para definir um período máximo de retenção de codespace".
- Clique no nome da política que você deseja editar.
- Faça as alterações necessárias e, em seguida, clique em Salvar.
Excluindo uma política
Você pode excluir uma política a qualquer momento. A exclusão de uma política não tem efeito sobre os codespaces existentes.
-
Exibir a página "Políticas de codespaces". Para obter mais informações, consulte "Adicionando uma política para definir um período máximo de retenção de codespace".
-
Clique no botão excluir à direita da política que você deseja excluir.