Sobre o faturamento do GitHub Codespaces

Sobre os preços do GitHub Codespaces

O GitHub poderá aplicar antecipadamente uma retenção temporária de autorização para o valor dos custos baseados no uso, que aparecerá como uma cobrança pendente na forma de pagamento da sua conta.

Os GitHub Codespaces são pagos por uma organização, uma empresa ou uma conta pessoal. Os planos Gratuito e Pro para contas pessoais incluem o uso gratuito dos GitHub Codespaces até uma quantidade fixa de uso mensal.

As organizações podem escolher se os codespaces criados dos seus repositórios serão de propriedade do usuário ou da organização. Confira "Como escolher quem tem a propriedade e paga pelos codespaces em sua organização". Uma organização pagará por um codespace se todas as afirmações a seguir forem verdadeiras.

• A organização optou por usar codespaces pertencentes a ela.
• A organização definiu um limite de gastos para GitHub Codespaces.
• O codespace é criado a partir de um dos repositórios da organização ou de um fork de um dos repositórios da organização. Isso inclui repositórios tanto públicos quanto privados.
• O usuário que cria o codespace é membro ou colaborador da organização, e a organização habilitou o GitHub Codespaces para ele. Isso poderá incluir todos os membros e colaboradores se a organização tiver optado por habilitar o Codespaces para todos os usuários. Se o Codespaces não estiver habilitado para um usuário, ele ainda poderá criar codespaces a partir de repositórios públicos na organização, mas o usuário pagará por esses codespaces.

Para obter mais informações sobre como habilitar GitHub Codespaces para os usuários, confira "Habilitar ou desabilitar o GitHub Codespaces em sua organização".

Caso contrário, o uso de GitHub Codespaces aplica-se à conta pessoal da pessoa que criou o codespace e consome parte do uso incluído mensalmente para essa conta pessoal, ou tal conta é cobrada de acordo com o uso da pessoa acima das cotas incluídas para ela.

Os planos Gratuito, Equipe e Enterprise para contas corporativas e organizacionais não incluem nenhum uso gratuito de GitHub Codespaces.

Armazenamento incluído mensalmente e horas de núcleo para contas pessoais

As seguintes horas de uso de núcleo e de armazenamento são incluídas, gratuitamente, para contas pessoais:

Plano de conta	Armazenamento por mês	Horas de núcleo por mês
GitHub Gratuito para contas pessoais	15 GB/mês	120
GitHub Pro	20 GB/mês	180

Noções básicas sobre GB/mês e horas de núcleo

O uso incluído para contas pessoais é medido em GB/mês e horas de núcleo.

GB/mês

A unidade de armazenamento de GB/mês é uma medida baseada em tempo, 1 GB/mês sendo 1 GB de uso de armazenamento por um mês inteiro. O espaço em disco usado por todos os seus codespaces e pré-compilações é avaliado uma vez por hora e o uso atual de GB/mês é recalculado. Portanto, embora você tenha codespaces e pré-compilações, seu uso de GB/mês aumentará ao longo do mês. Por exemplo, se o armazenamento totalizar 15 GB e permanecer inalterado durante todo o ciclo de cobrança mensal, você terá usado 7,5 GB na metade do mês e 15 GB no final do mês. Confira "Sobre a cobrança pelo uso do armazenamento", mais adiante neste artigo.

Hora de núcleo

Uma "hora de núcleo" é uma medida usada para uso de computação incluído. Para calcular as horas de núcleo, multiplique o número de horas durante as quais um codespace ficou ativo pelo multiplicador na tabela de preços mais adiante neste artigo. Para os tipos básicos de computador, o multiplicador é o número de núcleos de processador no computador que hospeda o codespace. Por exemplo:

• Um computador de 2 núcleos usado por 1 hora é igual a 2 horas de núcleo
• Um computador de 8 núcleos usado por 1 hora é igual a 8 horas de núcleo
• Um computador de 8 núcleos usado por 2 horas é igual a 16 horas de núcleo

Como usar seu uso incluído

Você será notificado por email quando tiver usado 75%, 90% e 100% de suas cotas incluídas. As notificações também são exibidas em uma mensagem "notificação" no VS Code e no cliente Web do VS Code. Você pode desativar as notificações por email, se necessário. Confira "Gerenciar o limite de gastos do GitHub Codespaces".

Quando uma conta pessoal tiver usado todo o armazenamento incluído ou o uso de computação (o que for atingido primeiro) e não tiver nenhum limite de gastos configurado, o uso de GitHub Codespaces será bloqueado. Você precisa configurar uma forma de pagamento e um limite de gastos para continuar usando GitHub Codespaces durante o mês de cobrança atual. No início do próximo ciclo de cobrança mensal, o uso incluído é redefinido. O armazenamento não será cobrado enquanto o uso de GitHub Codespaces estiver bloqueado.

Você pode exibir detalhes de seu uso para o mês atual a qualquer momento. Confira "Como visualizar o uso do GitHub Codespaces".

Se você estiver impedido de retomar um codespace e quiser continuar trabalhando nas alterações feitas no seu codespace, poderá fazer qualquer um dos seguintes procedimentos:

• Adicionar uma forma de pagamento e um limite de gastos maior que US$ 0.
• 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.

Se você tiver usado todo o uso de armazenamento incluído ou o uso de computação incluído e tiver configurado uma forma de pagamento e um limite de gastos, qualquer uso adicional de codespaces pertencentes à sua conta pessoal incorrerá em encargos para qualquer tipo de uso que não tenha cota incluída restante. Você não será cobrado pelo outro tipo de uso até que também tenha usado toda a cota incluída.

Para saber dicas sobre como fazer seu uso permitido ir além, confira "Como aproveitar ao máximo o uso incluído."

Preços para uso pago

Uma instância do GitHub Codespaces (um "codespace") incorre em encargos por tempo de computação, enquanto está ativa e pela quantidade de espaço em disco que o codespace ocupa, enquanto ela existe. 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

Para obter mais informações sobre a unidade de medida de GB por mês, confira "Sobre a cobrança para uso de armazenamento".

Se você habilitar a pré-criação de códigos, isso acarretará custos adicionais. Consulte “Sobre a cobrança para pré-criações de Codespaces”.

Sobre a cobrança do GitHub Codespaces

O GitHub Codespaces é cobrado em dólares americanos (USD) de acordo com a quantidade de tempo de computação e espaço de armazenamento que seus codespaces usam. Os custos de GitHub Codespaces são sempre cobrados mensalmente, mesmo que os outros itens de sua conta sejam cobrados anualmente.

A cobrança de GitHub Codespaces compartilha a data de cobrança, forma de pagamento e o recibo existentes em sua conta. Confira "Exibir suas assinaturas e a data de cobrança".

Se você é proprietário da organização, conecte uma ID da assinatura do Azure à conta da organização para habilitar o GitHub Codespaces e pagar pelo uso dele. Confira "Conectar uma assinatura do Azure".

Sobre a cobrança pelo uso de computação

O uso de computação de um codespace é o período de tempo para o qual esse codespace está ativo multiplicado pelo multiplicador na tabela de preços para o tipo de computador do codespace. O uso total de computação é calculado somando o tempo usado por todos os codespaces que podem ser cobrados de uma conta específica. Esses totais são relatados ao serviço de cobrança a cada hora e são cobrados mensalmente.

Por exemplo, se um codespace estiver ativo por uma hora e 15 minutos, o custo de computação será o custo por hora do codespace, conforme determinado por seu tipo de computador, multiplicado por 1,25.

Você pode controlar o uso de computação interrompendo seus codespaces. Para obter mais informações, confira "Parar e iniciar um codespace". Os codespaces são interrompidos automaticamente após um período configurável de inatividade. O período de tempo limite pode ser configurado pelo usuário ou no nível da organização. Consulte "Como definir seu período de tempo limite para o GitHub Codespaces" e "Restringir o período de tempo limite ocioso".

Sobre a cobrança pelo uso de armazenamento

Para fins de cobrança do GitHub Codespaces, o armazenamento inclui o espaço em disco usado por todos os codespaces e as pré-compilações na conta. Isso inclui todos os arquivos que você usa em um codespace, como repositórios clonados, arquivos de configuração, dados carregados no codespace (por exemplo, como entrada ou saída do software em execução no repositório) e extensões, entre outros. O armazenamento é cobrado por todos os seus codespaces existentes, independentemente de estarem ativos ou inativos, com exceção do uso bloqueado devido ao esgotamento da cota de uso incluída ou ao atingimento do limite de gastos. A cobrança de armazenamento de um codespace termina quando ele é excluído. No entanto, excluir um codespace não reduz o valor de armazenamento usado para o mês de cobrança atual, pois esse é um valor cumulativo.

Cobrança de armazenamento para contêineres com base na imagem padrão

Quando você usa a configuração de contêiner de desenvolvimento padrão, seu contêiner é criado com base na imagem padrão do Linux para codespaces. Confira "Introdução aos contêineres de desenvolvimento".

Os contêineres baseados na imagem padrão não são contados como armazenamento usado, mesmo que você adicionar recursos na configuração do contêiner de desenvolvimento. Confira "Como adicionar recursos a um arquivo devcontainer.json".

Se você usar a imagem padrão, o uso de armazenamento do codespace será baseado nos arquivos no repositório e nos novos arquivos que forem adicionados ao codespace. 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 de como verificar se um codespace foi criado com base na imagem de contêiner de desenvolvimento padrão, consulte "Como aproveitar ao máximo o uso incluído".

Como relatar o uso do armazenamento

O armazenamento de codespace é relatado em GB/mês. Seu mês de cobrança é executado de um dia fixo em um mês até o mesmo dia no mês seguinte. Na maioria dos casos, o dia do mês é determinado pelo dia em que você iniciou seu plano atual de GitHub. O armazenamento de GB/mês é calculado conforme mostrado a seguir. Uma vez a cada hora, o armazenamento usado por todos os codespaces atualmente ativos e interrompidos é avaliado. Esse número é dividido pelo número de horas no mês de cobrança atual: total storage size / hours this month. O resultado é adicionado ao total em execução para o armazenamento de codespace do mês.

Por exemplo, se você tiver um codespace que usa 100 GB de armazenamento e existiu por uma hora, você terá usado 100 / (24 * 30) = 0.1388 GB/mês de armazenamento em um mês de 30 dias. Se o uso de GitHub Codespaces durante um mês de 30 dias consistir em dois codespaces de 100 GB que existiram por três dias completos, haverá 24 * 3 relatórios por hora para o armazenamento desses codespaces, dando um total de (24 * 3) * 200 / (24 * 30) = 20 GB/mês.

Para relatórios realizados a cada hora, o uso de armazenamento da hora anterior é calculado em segundos. Como resultado, você não será cobrado por uma hora inteira de armazenamento se um codespace não existir durante os 60 minutos completos. No final do mês, GitHub arredonda seu armazenamento para o MB mais próximo.

Os proprietários da organização podem:

• Listar os codespaces atualmente ativos ou interrompidos para sua organização. Confira "Listar os codespaces na sua organização". Além do custo desses codespaces, o custo de GitHub Codespaces para o mês atual pode incluir custos de codespaces anteriores ao mês atual, mas que já foram excluídos.
• Confira o uso total de computação e armazenamento de GitHub Codespaces para sua organização para o mês atual até a data de hoje. Confira "Como visualizar o uso do GitHub Codespaces".
• Defina as configurações da sua organização para gerenciar o custo de GitHub Codespaces. Confira "Como gerenciar o custo dos GitHub Codespaces na organização".

Para estimar os custos do cobrança baseada no uso, você pode usar a calculadora de preços do GitHub

Sobre a cobrança para pré-criações de Codespaces

Uma pré-compilação monta os componentes principais de um codespace para uma combinação específica de repositório, branch e arquivo de configuração devcontainer.json. Ela fornece uma maneira rápida de criar um codespace. Para repositórios complexos e/ou grandes, em particular, é possível criar um codespace mais rapidamente usando uma pré-compilação. Confira "Sobre as pré-compilações do GitHub Codespaces".

Custos de GitHub Actions para pré-compilações

As pré-compilações são criadas e atualizadas executando um fluxo de trabalho de GitHub Actions em um executor hospedado em GitHub. Você pode configurar como deseja que as atualizações de pré-compilação sejam disparadas automaticamente. Para obter mais informações, confira "Configurando as pré-criações".

Assim como acontece com outros fluxos de trabalho, enquanto os fluxos de trabalho de pré-compilação estiverem em execução, eles consumirão alguns dos minutos do GitHub Actions incluídos na sua conta, se houver, ou vão gerar custos de minutos no GitHub Actions. Para obter mais informações sobre o preço de minutos do GitHub Actions, confira "Sobre a cobrança das GitHub Actions". Não há nenhum custo de computação de Codespaces associado para criar ou atualizar pré-compilações.

Você pode acompanhar o uso de armazenamento e fluxos de trabalho de pré-compilação baixando um relatório de uso da sua conta. Confira "Como visualizar o uso do GitHub Codespaces".

Custos de armazenamento para pré-compilações

Juntamente com os minutos do GitHub Actions, também serão incorridas cobranças pelo armazenamento de pré-compilações associadas a cada configuração de pré-compilação para um determinado repositório e região. O armazenamento de pré-compilações é cobrado na mesma taxa que o armazenamento de codespaces.

O custo de armazenamento de uma pré-compilação em apenas uma região será semelhante ao custo de armazenamento que será incorrido para armazenar apenas um codespace criado a partir dessa pré-compilação. O custo de armazenamento para o codespace gerado poderá ser maior do que o custo da pré-compilação se, por exemplo, os comandos updateContentCommand e postCreateCommand forem usados durante a criação do codespace para baixar mais arquivos no contêiner de desenvolvimento.

Os custos totais de armazenamento associados a uma configuração de pré-compilação dependerão dos fatores a seguir.

• O preço do armazenamento por GB (consulte a tabela anterior neste artigo)
• O tamanho da pré-compilação gerada em GB.
• O número de regiões em que a pré-compilação está disponível (porque uma cópia da pré-compilação é armazenada em cada região)
• O número de versões mais antigas da pré-compilação que são mantidas

O custo de armazenamento para as pré-compilações geradas por uma configuração de pré-compilação é, portanto, calculado como: price per GB * size (GB) * regions * versions.

Você pode marcar quantos GB por mês de armazenamento foram usados por pré-compilações examinando os dados de cobrança atuais para sua conta pessoal ou da organização. Confira "Como visualizar o uso do GitHub Codespaces".

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. Confira "Como a cobrança é administrada para repositórios bifurcados".

Como controlar o custo das pré-compilações

Para reduzir o consumo de minutos do Actions, você pode definir que uma pré-compilação seja atualizada somente quando fizer uma alteração nos arquivos de configuração do contêiner de desenvolvimento ou apenas com um agendamento personalizado. Você também pode gerenciar seu uso de armazenamento ajustando o número de versões anteriores de cada pré-compilação que são retidas. Confira "Configurando as pré-criações".

Para limitar os custos de armazenamento associados a pré-compilações, você pode optar por criar pré-compilações somente em regiões selecionadas e especificar o número de versões mais antigas de pré-compilações que serão mantidas. Confira "Configurando as pré-criações".

Se 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. Confira "Gerenciando pré-compilações".

Os pré-builds podem ser atualizados várias vezes durante um mês de cobrança. Cada atualização poderá alterar o tamanho do pré-build, o que afeta seus custos de armazenamento. Para obter detalhes de como o armazenamento é calculado durante um mês de cobrança, confira "Sobre a cobrança pelo uso do armazenamento" anteriormente neste artigo.

Custo de codespaces criados com base em pré-compilações

O uso de codespaces criados usando pré-criações é cobrado na mesma frequência que os codespaces regulares.

Definindo um limite de gastos

Por padrão, todas as contas têm um limite de gastos de US$ 0 para GitHub Codespaces. Isso impede que novos codespaces sejam criados ou que os codespaces existentes sejam abertos, se isso incorrer em um custo faturável para sua conta pessoal, corporativa ou da organização. Para contas pessoais, se você tiver acesso para criar um codespace, poderá fazê-lo desde que a conta não tenha atingido o limite de seu uso mensal incluído. Para organizações e empresas, o limite de gastos padrão significa que, para permitir que as pessoas criem codespaces que são cobrados para a organização ou sua empresa-mãe, o limite precisa ser alterado para um valor acima de US$ 0.

Para obter informações sobre como gerenciar e alterar o limite de gastos da sua conta, confira "Gerenciar o limite de gastos do GitHub Codespaces".

Se a conta pessoal, organizacional ou corporativa atingir o limite de gastos, você não poderá mais criar nem retomar codespaces faturáveis para essa conta. Você ainda poderá exportar qualquer trabalho em andamento para um novo branch. Para obter mais informações, confira "Exportando alterações para um branch".

Exibindo o uso projetado para uma organização

Os proprietários da organização e os gerentes de cobrança podem ver o custo de uso total estimado do GitHub Codespaces para a organização, para o ciclo de cobrança mensal atual. Confira "Como visualizar o uso do GitHub Codespaces".

O uso projetado mostrado na página de cobrança de uma organização é calculado com base no custo total do uso de computação e armazenamento de Codespaces incorridos durante os sete dias anteriores, antes do dia atual. Isso é projetado para o restante do mês de faturamento para dar uma ideia de quanto o custo total pode ser para o ciclo de faturamento atual.

O cálculo utilizado para esta estimativa é:

<cost for the previous 7 full days>/7 * <days remaining in the billing month, including the current day> + <cost already accrued in this billing month>

O uso projetado não leva em conta informações como se GitHub Codespaces ainda está habilitado, o número ou o tamanho dos codespaces existentes no momento ou suas configurações pré-compilação. Por esse motivo, se todos os espaços de codespaces e pré-compilações da organização fossem excluídos hoje, o uso projetado para o mês de faturamento ainda mostraria um valor maior do que o uso acumulado. No entanto, após sete dias, sem mais uso de Codespaces, o uso projetado será o mesmo que o uso acumulado atualmente.

Limitando os tipos de computador para codespaces de propriedade da organização

Por padrão, o tipo de computador com os recursos válidos mais baixos é usado quando um codespace é criado. No entanto, os usuários podem escolher um tipo de computador com mais recursos. Eles podem fazer isso ao criar um codespace ou podem alterar o tipo de computador de um codespace existente. Consulte "Como criar um codespace para um repositório" e "Alterando o tipo de máquina para seu codespace".

Se um tipo de computador com mais recursos for escolhido, isso afetará a cobrança por hora desse codespace, conforme mostrado na tabela anteriormente neste artigo.

Os proprietários da organização podem criar uma política para limitar a escolha de tipos de computador disponíveis aos usuários para codespaces que são cobrados para uma organização ou conta corporativa. Confira "Restringindo o acesso aos tipos de máquina".

Limitar o número de codespaces de propriedade da organização

Os proprietários da organização podem limitar o número de codespaces que as pessoas podem criar, em que a organização será cobrada pelo codespace. Isso pode ajudar a reduzir os encargos de armazenamento para a organização. Confira "Restringir o número de codespaces cobrados pela organização que um usuário pode criar".

Como a cobrança é administrada para repositórios bifurcados

O uso de codespaces criados a partir de um repositório bifurcado será cobrado 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.

Como o faturamento é administrado quando um repositório é transferido para outra organização

O uso é calculado a cada hora. Uma organização paga pelo uso de codespaces criados de qualquer repositório pertencente à organização, em que as configurações da organização permitem que a organização seja cobrada. Confira "Como escolher quem tem a propriedade e paga pelos codespaces em sua organização". Quando um repositório é transferido para fora da sua organização, a propriedade e a responsabilidade de cobrança por codespaces associados a esse repositório são alterados adequadamente.

Como a cobrança de modelos de GitHub Codespaces é tratada

Você pode começar a usar um novo projeto criando um codespace com base em um modelo. Os codespaces criados com base em modelos não são inicialmente associados a um repositório, mas você pode publicar o codespace em um repositório pertencente a sua conta pessoal. Confira "Como criar um codespace com base em um modelo".

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 modelo será cobrado da organização se a organização tiver definido um limite de gastos para GitHub Codespaces e permitido que o usuário crie o codespace tendo seu custo pago pela 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.

O que acontece quando os usuários são removidos

Se um usuário for removido de uma organização ou repositório, seus codespaces serão automaticamente excluídos.