Skip to main content

Restringir o período de retenção para codespaces

Você pode definir um período máximo de retenção para quaisquer codespaces pertencentes à sua organização.

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

GitHub Codespaces is available for organizations using GitHub Team or GitHub Enterprise Cloud. Para obter mais informações, consulte os "produtos do GitHub".

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

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Suas organizações no menu de perfil

  2. Ao lado da organização, clique em Configurações. Botão de configurações

  3. Na seção "Código, planejamento e automação" da barra lateral, selecione Codespaces e, em seguida, clique em Políticas.

  4. Na página "Políticas do codespace", clique em Criar política.

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

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

    Adicionar uma restrição por períodos de retenção

  7. Clique para editar a restrição.

    Editar a restrição de tempo limite

  8. 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.

    Defina o período de retenção em dias

    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.
  9. Na área "Alterar destino da política", clique no botão suspenso.

  10. Selecione Todos os repositórios ou Repositórios selecionados para determinar em quais repositórios esta política será aplicada.

  11. Se você escolheu repositórios selecionados:

    1. Clique em .

      Editar as configurações da política

    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.

      Selecionar repositórios para esta política

  12. 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".

  13. 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.

  1. 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".
  2. Clique no nome da política que você deseja editar.
  3. 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.

  1. 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".

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

    O botão de excluir uma política