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. Depois que um desses limites for atingido, o uso de GitHub Codespaces será restrito, a menos que você tenha configurado um limite de gastos e uma forma de pagamento. Você não poderá criar codespaces nem abrir existentes, pelos quais será cobrado, até que a cota seja renovada. Se você tiver acesso a repositórios pertencentes a uma organização que paga pelo uso de GitHub Codespaces, ainda poderá criar codespaces para esses repositórios.

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 saber mais, confira a seção "Sobre a cobrança para uso de computação" de "Sobre o faturamento 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 saber mais, confira a seção "Cobrança para uso de armazenamento" de "Sobre o faturamento do GitHub Codespaces".

Para onde foi meu armazenamento mensal?

Excluir espaços de código que você não está usando evitará o uso desnecessário de armazenamento gratuito incluído em sua conta pessoal. No entanto, se você tiver definido configurações de pré-compilação, o armazenamento incluído poderá continuar a diminuir durante o ciclo de cobrança mensal.

Embora as pré-compilações não estejam listadas na página "Seus codespaces", as pré-compilações criadas para um repositório consomem armazenamento mesmo que você não tenha nenhum espaço de código para esse repositório atualmente. Para evitar isso, você pode excluir as configurações de pré-compilações configuradas. Para obter mais informações, confira "Sobre as pré-compilações do GitHub Codespaces" e "Gerenciando pré-compilações."

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 visualizar o uso do GitHub Codespaces".

Você pode expandir a seção "Horas de uso" e "Armazenamento" para obter mais informações, por exemplo, para ver quanto do armazenamento consumido foi usado por pré-builds.

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 saber mais sobre como gerar um relatório de uso, confira "Como visualizar o uso do 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

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 "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 definir seu período de tempo limite para o 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 "Excluir um codespace".

  Nota: a exclusão de um codespace não reduzirá o valor de armazenamento usado para o mês atual de cobrança, pois esse é um valor cumulativo.

• 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 seus 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 as pré-compilações do GitHub Codespaces" e "Sobre o faturamento do 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. Quando você exclui uma configuração de pré-build, todos os pré-builds associados são excluídos, reduzindo o consumo de armazenamento desse ponto em diante. Para obter mais informações, confira "Gerenciando pré-compilações".

  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 "Configurando as pré-criaçõ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 saber mais, confira "Introdução aos contêineres de desenvolvimento" e "Uso de armazenamento para seu contêiner de desenvolvimento básico" abaixo.