Skip to main content

Configurando a exclusão automática de seus codespaces

Os codespaces não utilizados são excluídos automaticamente. Você pode escolher por quanto tempo seus codespaces parados serão mantidos até, no máximo, 30 dias.

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

Por padrão, Codespaces são excluídos automaticamente depois que forem parados e permanecerem inativos por 30 dias.

No entanto, como Codespaces está sujeito a cobrança de armazenamento, você pode preferir reduzir o período de retenção alterando seu período padrão nas suas configurações pessoais para GitHub Codespaces. Para obter mais informações sobre as cobranças de armazenamento, consulte "Sobre a cobrança para o GitHub Codespaces."

Observação: Independentemente de você ter definido um período de retenção de código pessoal, é uma boa ideia adquirir o hábito de excluir codespaces dos quais você já não precisa. Para obter mais informações, consulte "Excluindo um codespace".

A eliminação automática acontece independentemente de um codespace conter alterações não forçadas. Para evitar a exclusão automática de um codespace, basta abri-lo novamente. O período de retenção é redefinido toda vez que você se conectar a um codespace, e a contagem regressiva de retenção é reiniciada quando o codespace é interrompido.

Se um repositório pertencer a uma organização, é possível que o administrador da organização tenha definido um período de retenção para toda a organização. Se este período for inferior ao período de retenção padrão em suas configurações pessoais, o período de retenção da organização será aplicado aos conjuntos de codespaces que você criar para este repositório. Para obter mais informações, consulte "Restringindo o período de retenção para codespaces".

Cada codespace tem o seu próprio período de retenção. Poderão, portanto, ter codespaces com diferentes períodos de retenção. Por exemplo, se:

  • Você criou um codespace, mudou seu período de retenção padrão e, posteriormente, criou outro codespace.
  • Você criou um codespace usando GitHub CLI e especificou um período de retenção diferente.
  • Você criou um código a partir de um repositório de propriedade de organização que tem um período de retenção configurado para a organização.

Observação: O período de retenção é especificado em dias. Um dia representa um período de 24 horas, começando na hora do dia quando você interrompe um codespace.

Definir um período de retenção padrão para os seus codespaces

  1. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em Configurações.

    Ícone Settings (Configurações) na barra de usuário

  2. In the "Code, planning, and automation" section of the sidebar, click Codespaces.

  3. Em "Período de retenção padrão", insira o número de dias em que você quer que seus codespaces sejam mantidos, por padrão, depois que forem interrompidos.

    Selecionando seu período de retenção

    Você pode definir seu período de retenção padrão entre 0 e 30 dias.

    Aviso: Configurar o período para 0 fará com que seus codespaces sejam imediatamente excluídos quando você pará-los ou quando o tempo se esgotar devido à inatividade. Para obter mais informações, consulte "Definir seu período de tempo limite para GitHub Codespaces".

  4. Clique em Salvar.

Ao criar um codespace usando GitHub CLI você pode substituir este padrão. Se você criar um codespace em uma organização que especifique um período de retenção mais curto, o valor do nível da organização irá substituir a sua configuração pessoal.

Se você definir um período de retenção maior que um dia, você receberá uma notificação por e-mail um dia antes da sua exclusão.

Verificando o tempo restante até a exclusão automática

Você pode verificar se um codespace deve ser excluído automaticamente em breve.

Quando um codespace inativo está se aproximando do final do seu período de retenção, isto é indicado na sua lista de codespaces em GitHub em https://github.com/codespaces.

A mensagem de pré-exclusão na lista de codespaces em GitHub

Configurando um período de retenção para um codespace

Para definir o período de retenção do codespace quando você criar um codespace, use o parâmetro --retention-period com o código codespace create. Especifique o período em dias. O período deve ser entre 0 e 30 dias.

gh codespace create --retention-period DAYS

Se você não especificar um período de retenção ao criar um codespace, seu período de retenção padrão ou um período de retenção da organização será usado, dependendo de qual for menor. Para informações sobre como configurar seu período de retenção padrão, clique na aba "Navegador Web" nesta página.

Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."

Definindo o período de retenção

Você pode definir seu período de retenção padrão no seu navegador web em GitHub.com. Como alternativa, se você usar o GitHub CLI para criar um codespace, você poderá definir um período de tempo limite para esse codespace específico. Para mais informações, clique na guia apropriada acima.

Verificando se os codespaces serão excluídos automaticamente em breve

Você pode verificar, no aplicativo Visual Studio Code do desktop, se um código deverá ser excluído automaticamente em breve.

  1. Em VS Code, na barra lateral esquerda, clique no ícone Remote Explorer. O ícone do Remote Explorer em Visual Studio Code

  2. Escolha GitHub Codespaces a no menu suspenso no canto superior direito do Explorador Remoto, se ainda não estiver selecionado.

  3. Em "CODESPACES DO GITHUB", posicione o ponteiro do mouse sobre o codespace no qual você está interessado. Uma caixa pop-up é exibida mostrando informações sobre o codespace.

    Se o codespace estiver perto do fim do seu período de retenção, uma linha será incluída informando quando o codespace será excluído.

    Informações do codespace mostrando o tempo até a exclusão