Como aproveitar ao máximo o uso incluído

As contas pessoais do GitHub incluem uma cota mensal de uso gratuito de GitHub Codespaces.

Há dois tipos de uso de Codespaces: computação e armazenamento. Durante o período de cobrança mensal, conforme você usa Codespaces, o uso de computação e armazenamento é deduzido da cota de uso gratuito incluída na conta pessoal do GitHub, até que a computação ou o armazenamento sejam consumidos. Quando um desses limites for atingido, você não poderá criar codespaces nem abrir codespaces existentes até que a cota seja renovada, a menos que você tenha configurado um limite de gastos e uma forma de pagamento.

A quantidade de uso gratuito mensal fornecida na conta pessoal foi determinada para permitir que você faça contribuições de código aberto ou trabalhe em projetos paralelos, gratuitamente. Ela não é suficiente para você trabalhar gratuitamente no dia a dia.

Sobre a computação dos Codespaces

A computação dos Codespaces é contada em horas principais, que é a soma do tempo em que um codespace fica ativo, multiplicada pelo multiplicador do tipo de computador do codespace: por exemplo, o multiplicador 2 para um computador de 2 núcleos ou um multiplicador 8 para um computador de 8 núcleos. Um codespace fica ativo quando você o cria ou o inicia. Um codespace deixa de ficar ativo quando é interrompido ou excluído por você ou automaticamente.

O tempo limite ocioso padrão, que interrompe um codespace após um período de inatividade, é de 30 minutos. Você pode reduzir isso se necessário. Para obter mais informações, confira a seção "Cobrança por uso de computação" de "Sobre a cobrança do GitHub Codespaces".

Sobre o armazenamento do Codespaces

Você pode ver o uso de armazenamento de cada um dos codespaces na página "Seus codespaces" em github.com/codespaces.

Para fins de cobrança, o armazenamento de Codespaces é contado em GB/meses. Essa é uma medida cumulativa do armazenamento total que cada codespace consome, da criação à exclusão, além do armazenamento de predefinições. Para obter mais informações, confira a seção "Cobrança de uso de armazenamento" de "Sobre a cobrança de GitHub Codespaces.

Noções básicas sobre o uso de Codespaces

Você pode verificar o uso cumulativo de GitHub Codespaces no ciclo de cobrança mensal atual nas configurações do GitHub. Para obter mais informações, confira "Como exibir o uso do GitHub Codespaces".

Para obter informações mais específicas, por exemplo, saber quais repositórios têm predefinições consumindo armazenamento, você pode gerar um relatório de uso. O relatório de uso é um arquivo CSV enviado por email para você. Para obter mais informações de como gerar um relatório de uso, confira "Como exibir o uso de GitHub Codespaces".

Para ver o uso de Codespaces, filtre o relatório para mostrar apenas as linhas que mencionam "Codespaces" na coluna Product.

Uso de armazenamento do contêiner de desenvolvimento base

Se você não adicionar uma configuração de contêiner de desenvolvimento ao repositório ou se a configuração não especificar uma imagem a ser usada, o GitHub criará um contêiner com base em uma imagem padrão do Linux. O armazenamento de contêineres de desenvolvimento base criados por meio de uma imagem padrão do Linux é gratuito e não consome o armazenamento incluído. O uso do armazenamento será baseado apenas nos arquivos do repositório e nos arquivos que você adicionar depois ao codespace, incluindo extensões do VS Code. Se você usar uma imagem base alternativa, o contêiner resultante e todos os arquivos no codespace serão contados como armazenamento usado. Para obter informações sobre o que está incluído na imagem padrão do Linux, confira o repositório devcontainers/images.

Você pode verificar qual imagem foi usada para criar um contêiner de desenvolvimento de um codespace. No terminal do codespace, execute este comando.

devcontainer-info

Se o contêiner de desenvolvimento do codespace atual tiver sido criado com base na imagem padrão, a saída desse comando conterá as informações a seguir.

- Definition ID: universal
- Source code repository: https://github.com/devcontainers/images

Dicas para ampliar o uso permitido

• Seus codespaces consomem o uso de computação enquanto estão em execução. Se você não estiver usando um codespace, interrompa-o para impedir um uso de desnecessário de computação. Para obter mais informações, confira "Como parar e iniciar um codespace".

• Você pode reduzir o tempo limite ocioso de Codespaces nas configurações pessoais para menos do que os 30 minutos padrão. Isso reduzirá o período de inatividade até que os codespaces sejam interrompidos automaticamente. Assim, é possível economizar em uso de computação. Para obter mais informações, confira "Como configurar o período de tempo limite do GitHub Codespaces".

• Seus codespaces consomem armazenamento enquanto existem. Você deve excluir um codespace que terminou de usar, sabendo que ele não será mais usado. Para obter mais informações, confira "Como excluir um codespace".

• Configure o período de retenção para garantir que os codespaces que você esquecer de excluir sejam excluídos automaticamente. 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 codespaces".

• As extensões do Visual Studio Code consomem armazenamento. Verifique se você está instalando apenas as extensões necessárias. Você pode descobrir quanto espaço está sendo usado pelas extensões executando este comando no codespace.

  Shell

  du -h -s ~/.vscode-remote/extensions

• Monitore o uso de computação e armazenamento acessando a página de cobrança no GitHub.com, https://github.com/settings/billing, e examinando os números na seção "Codespaces".

  Observação: o armazenamento é calculado por hora e adicionado ao uso de armazenamento existente. Portanto, o armazenamento consumido é cumulativo durante o ciclo de cobrança de um mês. Isso significa que, durante o período de cobrança, o valor que você vê na página de cobrança só aumentará ou permanecerá o mesmo. O uso será redefinido como zero quando um novo ciclo de cobrança for iniciado. A exclusão de um codespace ou de uma predefinição não reduz o número de uso do mês atual, mas reduz a taxa na qual o uso de armazenamento se acumula.

• Verifique se você está usando predefinições apenas para o número necessário de versões e regiões. Para obter mais informações, confira "Sobre predefinições dos GitHub Codespaces" e "Sobre a cobrança dos GitHub Codespaces".

  Observação: se o uso de armazenamento incluído estiver esgotado, novas predefinições serão desabilitadas até que você configure um limite de gastos ou a cota de uso incluída seja renovada.

• Se você tiver configurado predefinições nas configurações de um repositório, mas não estiver usando os GitHub Codespaces nesse repositório, exclua a configuração de predefinição para evitar o consumo desnecessário da provisão de armazenamento desse repositório.

  Você pode verificar se há configurações de predefinição na página "Codespaces" das configurações de um repositório. Para obter mais informações, confira "Como configurar pré-compilações".

  Como alternativa, você pode verificar quais repositórios têm predefinições examinando um relatório de uso. Para obter mais informações, confira "Noções básicas sobre o uso de Codespaces" acima.

• O armazenamento de contêineres criados com base na imagem padrão do Linux para codespaces é gratuito e não reduz o armazenamento incluído. Portanto, você pode evitar que a provisão de armazenamento seja consumida pelo contêiner de desenvolvimento usando a imagem padrão na configuração do contêiner de desenvolvimento, em vez de especificar uma imagem mais especializada. Para obter mais informações, confira "Introdução aos contêineres de desenvolvimento" e "Uso de armazenamento do contêiner de desenvolvimento base" acima.