Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Como restringir o período de retenção de codespaces

Você pode definir um período máximo de retenção de cada codespace pertencente à organização.

Quem pode usar esse recurso

To manage retention constraints for an organization's codespaces, you must be an owner of the organization.

Organizations on GitHub Team and GitHub Enterprise plans can enable use of GitHub Codespaces, billable to the organization. These organizations can then access settings that apply to codespaces paid for by the organization. For more information, see "Como habilitar o GitHub Codespaces em sua organização" and "Produtos do GitHub."

Visão geral

Os GitHub Codespaces são excluídos automaticamente depois que são parados e ficam inativos por um número definido de dias. O período de retenção de cada codespace é definido quando o codespace é criado e não é alterado. O período de retenção padrão é de 30 dias.

Os usuários do GitHub podem definir um período de retenção pessoal inferior a 30 dias para os codespaces que criam. Para obter mais informações, confira "Como configurar a exclusão automática de seus codespaces".

Como proprietário da organização, você pode configurar restrições no período máximo de retenção dos codespaces criados para os repositórios pertencentes à organização. Isso ajuda a limitar os custos de armazenamento associados a codespaces que são parados e ficam sem uso até que sejam excluídos automaticamente. Para saber mais sobre preços de armazenamento, confira "Sobre o faturamento do GitHub Codespaces". Você pode definir um período máximo de retenção para todos os repositórios ou para alguns específicos pertencentes à organização.

Observação: a definição de uma política de retenção máxima para um repositório impede que as pessoas isentem um codespace da exclusão automática. A opção "Manter codespace" não estará disponível para codespaces criados para esse repositório. Para obter mais informações, confira "Como configurar a exclusão automática de seus codespaces".

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 para toda a organização com uma restrição de retenção de codespace, as restrições de retenção nas políticas direcionadas a repositórios específicos deverão ser menores do que a restrição configurada para toda a organização. Caso contrário elas não terão efeito. É aplicado o menor período de retenção em uma política para toda a organização, em uma política direcionada a repositórios especificados ou nas configurações pessoais de alguém.

Se você adicionar uma política para toda a organização com uma restrição de retenção, defina o período de retenção para o período mais longo aceitável. Depois, você pode adicionar políticas separadas que definam a retenção máxima para um período mais curto em repositórios específicos da organização.

Observação: as políticas de codespace só se aplicam aos que são cobrados na organização. Se um usuário individual criar um codespace para um repositório em sua organização e a organização não for cobrada, o codespace não será associado a essas políticas. Para obter informações sobre como escolher quem pode criar codespaces que são cobrados da sua organização, confira "Como habilitar o GitHub Codespaces em sua organização".

Como adicionar uma política para definir um período máximo de retenção de codespace

  1. No canto superior direito do GitHub.com, clique na foto do seu perfil e clique em Suas organizações.

    Captura de tela do menu suspenso na imagem de perfil do @octocat. "Suas organizações" está contornado em laranja escuro. 2. Ao lado da organização, clique em Configurações.

    Captura de tela da organização "octo-org" com o botão "Configurações" realçado com uma estrutura de tópicos laranja escuro. 1. Na seção "Código, planejamento e automação" da barra lateral, selecione Codespaces e clique em Políticas.

  2. Na página "Políticas de codespace", clique em Criar Política.

  3. Insira um nome para sua nova política.

  4. Clique em Adicionar restrição e escolha Período de retenção.

  5. Clique em para editar a restrição.

  6. Insira o número máximo de dias em que os codespaces podem ficar parados antes de serem excluídos automaticamente e clique em Salvar.

    Captura de tela de um menu suspenso com um campo rotulado "Valor máximo" definido como 8 dias. Abaixo estão os botões "Cancelar" e "Salvar".

    Observações

    • Um dia, nesse contexto, é um período de 24 horas, começando na hora do dia em que o codespace é parado.
    • O intervalo válido é de 0 a 30 dias.
    • A configuração do período como 0 resultará na exclusão imediata dos codespaces quando eles forem parados ou quando o tempo limite deles for atingido devido à inatividade.
  7. Clique fora da caixa de diálogo para fechá-la.

  8. Por padrão, a política é definida para ser aplicada a todos os repositórios. Se você quiser que ela se aplique somente a alguns dos repositórios na sua organização, clique em Todos os repositórios e em Repositórios selecionados no menu suspenso.

    Captura de tela do menu suspenso de seleção de repositório, mostrando as opções "Todos os repositórios" e "Repositórios selecionados".

    Com a opção Repositórios selecionados marcada:

    1. Clique em .

      Captura de tela do ícone de configurações (um símbolo de engrenagem) à esquerda de um botão denominado "Repositórios selecionados".

    2. Selecione os repositórios aos quais você quer que esta política seja aplicada.

    3. Na parte inferior da lista de repositórios, clique em Selecionar repositórios.

      Captura de tela de uma lista de repositórios, cada um com uma caixa de seleção. Três repositórios são selecionados.

  9. Para adicionar outra restrição à política, clique em Adicionar restrição e escolha outra restrição. Para obter informações sobre outras restrições, confira:

  10. Depois de concluir a adição de restrições à política, clique em Salvar.

A política será aplicada a todos os codespaces que podem ser cobrados da sua organização. A restrição de período de retenção só é aplicada na criação do codespace.

Editando uma política

Você pode excluir ou editar uma política existente. Por exemplo, você talvez queira adicionar restrições a ou removê-las de uma política.

A restrição de período de retenção só é aplicada aos codespaces quando eles são criados. A edição de uma política não tem efeito nos codespaces existentes.

  1. Exibir a página "Políticas de codespaces". Para obter mais informações, confira "Como adicionar uma política para definir um período máximo de retenção de codespace".
  2. Clique no nome da política que você deseja editar.
  3. Clique no ícone de lápis () ao lado da restrição "Período de retenção".
  4. Faça as alterações necessárias e 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 nos codespaces existentes.

  1. Exibir a página "Políticas de codespaces". Para obter mais informações, confira "Como adicionar uma política para definir um período máximo de retenção de codespace".

  2. Clique no botão excluir à direita da política que você deseja excluir.

  3. Clique no botão excluir à direita da política que você deseja excluir.

    Captura de tela de uma política com o botão Excluir (um ícone de lixeira) realçado com uma estrutura de tópicos laranja escura.