Como o uso do GitHub Codespaces é medido
Uma instância do GitHub Codespaces (um "codespace") incorre em dois tipos de encargos.
- Tempo de computação: tempo de processamento e energia enquanto o codespace está ativo.
- Armazenamento: espaço em disco que o codespace ou o pré-compilado ocupa enquanto ele existe.
Além disso, todos os codespaces predefinidos são gerados usando minutos de ações, confira Sobre as pré-compilações do GitHub Codespaces.
Tempo de computação
O tempo de computação para um codespace é o período no qual esse codespace está ativo. O uso total do tempo de computação para cada tipo de processador é calculado somando o tempo usado por todos os codespaces faturáveis para uma conta específica. Esses totais são relatados ao serviço de cobrança a cada hora e são cobrados mensalmente.
Volume de armazenamento para codespaces
O armazenamento é uma medida baseada em tempo da quantidade de armazenamento usada em GB/horas. O armazenamento medido para codespaces inclui:
- Todos os arquivos que você usa em um codespace, como repositórios clonados e arquivos de configuração
- Todos os dados carregados no codespace (por exemplo, como entrada ou saída do software em execução no repositório)
- Todas as extensões
- Todos os codespaces predefinidos, confira Sobre as pré-compilações do GitHub Codespaces
- Todos os contêineres de desenvolvimento personalizados, confira Introdução aos contêineres de desenvolvimento
Volume de armazenamento para codespaces criados com base em configurações personalizadas
Por padrão, seu codespace é criado com base na imagem padrão do Linux, também conhecida como "configuração de contêiner de desenvolvimento padrão". Se você criar um codespace de uma configuração personalizada de contêiner de desenvolvimento, verá um volume de armazenamento maior. Confira Introdução aos contêineres de desenvolvimento.
- Imagem padrão do Linux: o volume de armazenamento para seu codespace é baseado apenas nos arquivos em seu repositório e em todos os arquivos que você adicionar ao codespace.
- Imagem base personalizada: o volume de armazenamento para seu codespace inclui o contêiner de desenvolvimento personalizado, além de todos os arquivos no repositório e no codespace.
Os contêineres baseados na imagem padrão não são incluídos no seu volume de armazenamento, mesmo que você adicionar recursos na configuração do contêiner de desenvolvimento. Confira Como adicionar recursos a um arquivo devcontainer.json.
Uso gratuito e cobrado por contas pessoais
Os planos do GitHub para organizações e empresas não incluem uma cota gratuita para GitHub Codespaces.
Cota gratuita
Todas as contas pessoais do GitHub incluem uma cota de tempo de computação gratuito e armazenamento para GitHub Codespaces. Qualquer uso além dos valores incluídos é cobrado em sua conta pessoal.
| Plano de conta | Armazenamento por mês | Tempo de computação por mês |
|---|---|---|
| GitHub Gratuito para contas pessoais | 15 GB/mês | 120 horas |
| GitHub Pro | 20 GB/mês | 180 horas |
Observação
O GitHub Codespaces não está disponível em repositórios pertencentes a contas de usuário gerenciadas. Para saber mais, confira Sobre os Enterprise Managed Users.
Para obter dicas sobre como fazer seu uso permitido ir além, confira Como aproveitar ao máximo o uso incluído.
Usar mais do que a cota incluída
Se sua conta não tiver uma forma de pagamento válida registrada, o uso será bloqueado quando você usar sua cota.
Se você estiver impedido de retomar um codespace e precisar continuar trabalhando nas alterações no codespace, poderá fazer qualquer um dos seguintes procedimentos:
- Adicione uma forma de pagamento e examine suas configurações de orçamento para garantir que elas atendam às suas necessidades de uso. Confira Definir orçamentos para controlar gastos com produtos limitados.
- Exportar as alterações do codespace para um branch. Confira Exportando alterações para um branch.
- Aguarde até que o uso incluído mensalmente seja redefinido no início do próximo ciclo de cobrança mensal.
Pagar pelo uso
Você paga por usar Codespaces usando a forma de pagamento configurada para sua conta GitHub. Confira Gerenciar suas informações de pagamento e cobrança.
- Para estimar os custos de uso pago do GitHub Codespaces, use a calculadora de preços do GitHub.
- Para exibir os minutos e o armazenamento atuais, confira Como exibir o uso de licenças e produtos mensuráveis.
- Para otimizar o uso de codespaces:
- Para contas pessoais, confira Como aproveitar ao máximo o uso incluído
- Para contas da organização, confira Como gerenciar o custo dos GitHub Codespaces na organização
Preços
O custo de computação é proporcional ao número de núcleos de processador no tipo de computador escolhido para o codespace, conforme mostrado na tabela a seguir. Por exemplo, o custo de computação de usar um codespace por uma hora em um computador de 16 núcleos é oito vezes maior que em um computador de dois núcleos.
| Componente | Tipo de computador | Unidade de medida | Multiplicador de uso incluído | Preço |
|---|---|---|---|---|
| Computação de codespaces | Dois núcleos | 1 hora | 2 | $ 0,18 |
| Computação de codespaces | Quatro núcleos | 1 hora | 4 | $ 0,36 |
| Computação de codespaces | Oito núcleos | 1 hora | 8 | $ 0,72 |
| Computação de codespaces | 16 núcleos | 1 hora | 16 | $ 1,44 |
| Computação de codespaces | 32 núcleos | 1 hora | 32 | $ 2,88 |
| Armazenamento de codespaces | Armazenamento | 1 GB por mês | Não aplicável | US$ 0,07 |
Como os custos são atribuídos a uma conta faturável
Todo o uso é cobrado na conta da pessoa que criou o codespace ou da organização proprietária. Confira Como escolher quem tem a propriedade e paga pelos codespaces em sua organização.
Quando um repositório é transferido para uma organização diferente, a propriedade e a responsabilidade de cobrança de todos os codespaces associados a esse repositório mudam conforme as configurações da nova organização.
Se um usuário for removido de uma organização ou repositório, seus codespaces serão automaticamente excluídos.
Repositórios com fork
Codespaces criados com base em um repositório bifurcado são cobrados em sua conta pessoal, a menos que o repositório upstream (ou pai) esteja em uma organização que permitiu que você, como membro ou colaborador externo da organização, usasse codespaces às custas da organização.
Por exemplo, considere que um membro ou colaborador externo de uma organização permitiu a cobrança de codespaces para esse usuário. Se o usuário tiver permissão para bifurcar um repositório privado de propriedade da organização, ele poderá criar e usar posteriormente um codespace para o novo repositório às custas da organização. Isso ocorre porque a organização é a proprietária do repositório pai. Observe que o proprietário da organização pode remover o acesso do usuário ao repositório privado, ao repositório bifurcado e, portanto, também ao codespace. O proprietário da organização também pode excluir o repositório pai, o que também excluirá o repositório bifurcado. Confira Gerenciando a política de bifurcação para seu repositório.
Se você criar pré-compilações para um repositório com fork, o custo de armazenamento dessas pré-compilações será subtraído do armazenamento mensal incluído, enquanto disponível. Se você tiver usado todo o armazenamento incluído e tiver configurado a cobrança, sua conta pessoal será cobrada. Isso é válido mesmo quando os codespaces criados para um fork são pagos pela organização proprietária do repositório pai.
Modelos do GitHub Codespaces
Qualquer organização pode manter um repositório de modelos para usá-las com GitHub Codespaces. Assim como acontece com qualquer outro repositório em uma organização, um codespace criado com base em um repositório de modelos será cobrado da organização se a organização permitir que o usuário que cria o codespace o faça às custas da organização. Caso contrário, o codespace será cobrado do usuário que criar o codespace.
Se um usuário publicar um codespace criado com base em um modelo, o codespace será publicado em um novo repositório pertencente a conta pessoal do usuário. Se o codespace estiver, no momento, sendo cobrado da organização, a propriedade e a cobrança do codespace serão transferidas para o usuário que criou o codespace.
Um conta de usuário gerenciada não pode ser o proprietário faturável de um codespace. Portanto:
- Um conta de usuário gerenciada só pode criar um codespace de um modelo se o codespace for cobrado de uma organização.
- Um conta de usuário gerenciada não pode publicar um codespace criado de um modelo em um novo repositório.
Gerenciar seu orçamento de GitHub Codespaces
Se sua conta não tiver uma forma de pagamento válida registrada, o uso será bloqueado quando você usar sua cota.
Por padrão, se você tiver uma forma de pagamento válida registrada, os gastos serão limitados a 0 USD até que você defina um orçamento. Você pode definir e gerenciar um orçamento para limitar os gastos de um produto ou SKU. Confira Definir orçamentos para controlar gastos com produtos limitados.
Accounts that have migrated from the old billing platform may contain automatically generated budgets that mirror their previous spending limits.
Se a conta pessoal, organizacional ou corporativa usar toda a cota ou o orçamento, você não poderá mais criar nem retomar codespaces que são cobrados nessa conta. Você ainda poderá exportar qualquer trabalho em andamento para um novo branch. Para saber mais, confira Exportando alterações para um branch.