Excluir um codespace

Neste artigo

Você pode excluir um codespace de que você não precisa mais.

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. Para obter mais informações, confira "Como configurar a exclusão automática de seus codespaces".

Um codespace pode ser excluído manualmente de várias maneiras:

  • No terminal, usando GitHub CLI
  • In Visual Studio Code
  • No navegador da Web

Use as guias na parte superior deste artigo para exibir instruções para cada uma dessas maneiras de excluir um codespace.

Observação: você não pode excluir um codespace de dentro do JetBrains Gateway ou do aplicativo cliente do JetBrains nem de dentro do JupyterLab.

Por que você deve excluir codespaces não utilizados

Há custos associados ao armazenamento de codespaces. Portanto, você deve excluir os codespaces de que não precisa mais. Para obter mais informações, confira "Sobre o faturamento do GitHub Codespaces".

Há limites para o número de codespaces que você pode criar e o que você pode executar ao mesmo tempo. Esses limites variam de acordo com uma série de fatores. Se você atingir o número máximo de codespaces e tentar criar outro, uma mensagem será exibida informando que você deverá remover um codespace antes de criar um novo.

Excluir um codespace

  1. Navegue até a página "Seus codespaces" em github.com/codespaces.

  2. À direita do codespace que deseja excluir, clique em e em Excluir.

    Captura de tela de uma lista de codespaces com o menu suspenso de um deles exibido, mostrando a opção "Excluir".

Observação: você pode ter codespaces de pré-compilação que estão consumindo armazenamento adicional que não são exibidos neste dashboard. Para excluí-los, siga as etapas para "Excluir uma configuração de pré-compilação".

Você pode excluir codespaces de dentro do VS Code quando você não estiver trabalhando no codespace.

  1. No VS Code, na barra de Atividades, clique no ícone do Gerenciador Remoto.

    Captura de tela da Barra de Atividades. O ícone da barra lateral do "Gerenciador Remoto" (um retângulo sobreposto por um círculo) está realçado com um contorno laranja.

    Observação: se o Gerenciador Remoto não for exibido na Barra de Atividades:

    1. Abra a paleta de comandos. Por exemplo, pressionando Shift+Command+P (no Mac) / Ctrl+Shift+P (no Windows/Linux).
    2. Digite: details.
    3. Clique em Codespaces: detalhes.

  2. Em "GitHub Codespaces", clique com o botão direito do mouse no codespace que você deseja excluir.

  3. Clique em Excluir Codespace.

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

Para excluir um codespace, use o subcomando gh codespace delete e escolha um codespace na lista exibida.

gh codespace delete

Se você tiver alterações não salvas, será solicitado que você confirme a exclusão. Use o sinalizador --force para forçar a exclusão, evitando esse prompt.

Para obter mais informações sobre esse comando, confira o manual da GitHub CLI.

Como excluir codespaces em massa

Você pode usar GitHub CLI para excluir vários dos seus codespaces, ou todos, usando um único comando. Para obter mais informações, clique na guia "GitHub CLI" próxima à parte superior desta página.

Você pode usar GitHub CLI para excluir vários dos seus codespaces, ou todos, usando um único comando. Para obter mais informações, clique na guia "GitHub CLI" próxima à parte superior desta página.

Você pode excluir vários ou todos os seus codespaces com um único comando, usando gh codespace delete seguido por um destes sinalizadores:

--all - exclua todos os seus codespaces.

--repo REPOSITORY - exclua todos os seus codespaces para este repositório. Ou use junto com o sinalizador --days para filtrar por idade do codespace.

--days NUMBER - exclua todos os seus codespaces mais antigos do que o número especificado de dias. Pode ser usado junto com o sinalizador --repo.

Por padrão, você será solicitado a confirmar a exclusão de todos os codespaces que contenham alterações não salvas. Você pode usar o sinalizador --force para ignorar essa confirmação.

Exemplo

Exclua todos os codespaces do repositório octo-org/octo-repo criados há mais de 7 dias.

gh codespace delete --repo octo-org/octo-repo --days 7

Como excluir codespaces em sua organização

Como proprietário de uma organização, você pode usar GitHub CLI para excluir qualquer codespace em sua organização.

Para obter mais informações, clique na guia "GitHub CLI" próxima à parte superior desta página.

Para obter mais informações, clique na guia "GitHub CLI" próxima à parte superior desta página.

  1. Insira um desses comandos para exibir uma lista de codespaces.

    • gh codespace delete --org ORGANIZATION – lista os codespaces atuais na organização especificada.
    • gh codespace delete --org ORGANIZATION --user USER – lista apenas os codespaces criados pelo usuário especificado. Você deve ser um proprietário da organização especificada.

  2. Na lista de codespaces, navegue até o codespace que você deseja excluir.

  3. Para excluir o codespace selecionado, pressione Enter.

    Se o codespace contiver alterações não salvas, será solicitado que você confirme a exclusão.

Você também pode usar a API REST para excluir codespaces de sua organização. Para obter mais informações, confira "Organizações de codespaces".

Leitura adicional