Skip to main content

Como configurar a exclusão automática de seus codespaces

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

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

Mas como os GitHub Codespaces geram encargos de armazenamento, talvez você prefira reduzir o período de retenção alterando o período padrão nas suas configurações pessoais dos GitHub Codespaces. Para obter mais informações sobre cobranças de armazenamento, confira "Sobre a cobrança do GitHub Codespaces".

Observação: tendo definido ou não um período de retenção de codespace pessoal, é uma boa ideia se acostumar a excluir codespaces de que você não precisa mais. Para obter mais informações, confira "Como excluir um codespace".

A exclusão automática ocorre independentemente de um codespace conter alterações não enviadas por push. Para evitar a exclusão automática de um codespace, bastará abrir o codespace novamente. O período de retenção será redefinido sempre que você se conectar a um codespace, e a contagem regressiva de retenção será reiniciada quando o codespace for parado.

Se um repositório pertencer a uma organização, o administrador da organização poderá ter definido um período de retenção para toda a organização. Se esse período for menor do que o período de retenção padrão em suas configurações pessoais, o período de retenção da organização se aplicará aos codespaces criados para esse repositório. Para obter mais informações, confira "Como restringir o período de retenção para codespaces".

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

  • Você criou um codespace, alterou o período de retenção padrão e criou outro codespace.
  • Você criou um codespace usando a GitHub CLI e especificou um período de retenção diferente.
  • Você criou um codespace de um repositório de propriedade da organização com 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 em que você para um codespace.

Como definir um período de retenção padrão para seus codespaces

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

    Ícone Settings (Configurações) na barra de usuário 1. Na seção "Código, planejamento e automação" da barra lateral, clique em Codespaces.

  2. Em "Período de retenção padrão", insira o número de dias pelos quais você deseja que seus codespaces sejam retidos por padrão depois de terem sido parados.

    Como selecionar seu período de retenção

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

    Aviso: 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. Para obter mais informações, confira "Como configurar o período de tempo limite do GitHub Codespaces".

  3. Clique em Salvar.

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

Se você definir um período de retenção de mais de um dia, será enviada uma notificação por email um dia antes da exclusão.

Como verificar 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 estiver se aproximando do final de seu período de retenção, isso será indicado na sua lista de codespaces no GitHub em https://github.com/codespaces.

A mensagem anterior à exclusão na lista de codespaces no GitHub

Como definir um período de retenção para um codespace

Para definir o período de retenção do codespace ao criar um codespace, use o sinalizador --retention-period com o subcomando codespace create. Especifique o período em dias. O período deve ter 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, o período de retenção padrão ou um período de retenção da organização será usado, dependendo do que for menor. Para obter informações sobre como definir um período de retenção padrão, clique na aba "Navegador da Web" nesta página.

Para saber mais sobre a GitHub CLI, confira "Sobre a GitHub CLI".

Como definir o período de retenção

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

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

Você pode verificar, no aplicativo da área de trabalho do Visual Studio Code, se um codespace deve ser excluído automaticamente em breve.

  1. Em VS Code, na barra lateral esquerda, clique no ícone do Gerenciador Remoto.

    O ícone do Remote Explorer no Visual Studio Code

    Note: If the Remote Explorer is not displayed in the Activity Bar:

    1. Access the Command Palette. For example, by pressing Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux).
    2. Type: codespaces.
    3. Click Codespaces: Details.
  2. Escolha GitHub Codespaces no menu suspenso no canto superior direito do Gerenciador Remoto se ele ainda não estiver selecionado.

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

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

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