Como o uso do GitHub Packages é medido
O uso do GitHub Packages é gratuito para pacotes públicos. Além disso, os dados transferidos de qualquer fonte são gratuitos.
Para repositórios privados, cada conta do GitHub recebe uma cota de armazenamento e transferência de dados para uso com o GitHub Packages, dependendo do plano da conta. Qualquer uso além dos valores incluídos é cobrado em sua conta. A transferência de dados é reiniciada todos os meses, mas o uso do armazenamento não.
Como trabalhar em um repositório privado com pacotes:
- Quando você publica um pacote privado, o tamanho total do arquivo é incluído no uso de armazenamento do proprietário do repositório.
- Quando você baixa um pacote privado, a transferência de dados é incluída no uso de transferência de dados do proprietário do repositório.
Dica
Qualquer pessoa com acesso de gravação a um repositório pode publicar pacotes sem aumentar o uso de sua conta pessoal.
Exemplos de como o uso é medido
- Se você publicar um pacote de 500 MB em um repositório privado, usará 500 MB do armazenamento do proprietário do repositório e nenhuma de suas concessões de transferência de dados. Se você encontrar um bug e publicar um pacote atualizado de 500 MB sem excluir o pacote original, agora estará usando 1 GB do armazenamento do proprietário.
- Se você baixar um pacote de 500 MB de um repositório privado, usará 500 MB da transferência de dados do proprietário do repositório. Se uma correção de segurança for lançada e você baixar o novo pacote, adicionará outros 500 MB de transferência de dados, elevando a transferência total desses dois downloads para 1 GB de dados.
- Se o GitHub Actions baixar um pacote de 500 MB de um repositório privado usando um
GITHUB_TOKEN, isso não contará para a concessão de transferência de dados do proprietário do repositório. Confira Downloads de pacote pelo GitHub Actions.
Uso gratuito do GitHub Packages
As seguintes quantidades de armazenamento e transferência de dados estão incluídas em seu plano do GitHub. No início de cada mês, a transferência de dados para a conta é redefinida como zero.
| Planejar | Armazenamento | Transferência de dados (por mês) |
|---|---|---|
| GitHub Free | 500MB | 1 GB |
| GitHub Pro | 2GB | 10GB |
| GitHub Free para organizações | 500MB | 1 GB |
| GitHub Team | 2GB | 10GB |
| GitHub Enterprise Cloud | 50GB | 100GB |
Downloads de pacote por GitHub Actions
Quando um fluxo de trabalho usa GitHub Actions para baixar um pacote, a transferência de dados não conta para o uso do repositório de hospedagem. Determinamos que você está baixando pacotes usando o GitHub Actions ao fazer logon no GitHub Packages usando um GITHUB_TOKEN.
| Hospedado | Auto-hospedado | |
|---|---|---|
Acesso por meio de um GITHUB_TOKEN | Gratuita | Gratuita |
| Acessar usando um personal access token | Grátis | Pago |
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.
Pagar por uso adicional do GitHub Packages
Você paga por qualquer uso adicional acima da cota usando a forma de pagamento configurada para sua conta do GitHub. Confira Gerenciar suas informações de pagamento e cobrança.
A transferência de dados é cobrada para cada GB de dados transferidos. O armazenamento é cobrado calculando uma taxa de uso por hora.
- Para estimar os custos dos serviços de consumo, use a calculadora de preços do GitHub.
- Para exibir o armazenamento e a largura de banda atuais, consulte Como exibir o uso de licenças e produtos mensuráveis.
Exemplo de como o uso é calculado em um mês
No final do mês, GitHub arredonda sua transferência de dados para o GB mais próximo.
O GitHub calcula seu uso de armazenamento a cada mês com base no uso por hora por GB durante cada mês. Por exemplo, se durante o mês de março você utilizar 3 GB em 10 dias e 12 GB nos 21 dias subsequentes, o uso do armazenamento será de:
- 3 GB x 10 dias x (24 horas por dia) = 720 GB-Horas
- 12 GB x 21 dias x (24 horas por dia) = 6,048 GB-Horas
- 720 GB-Horas + 6.048 GB-Horas = 6.768 GB-Horas no total
- 6.768 GB-Horas / (744 horas por mês) = 9,0967 GB-Meses
No final do mês, o GitHub arredonda seu armazenamento para o MB mais próximo. Portanto, seu uso de armazenamento em março seria de 9,097 GB.
Exemplo de estimativa de uso
Você também pode usar esse cálculo no meio de um ciclo de cobrança para estimar qual seria seu uso total no mês. Por exemplo, se você tiver uma organização que usa o GitHub Team e fornece 2 GB de armazenamento gratuito, e você usar 0 GB nos primeiros 5 dias de abril, 1,5 GB nos 10 dias posteriores e planejar usar 3 GB nos últimos 15 dias do ciclo de cobrança, seu uso de armazenamento projetado no mês seria:
- 0 GB x 5 dias x (24 horas por dia) = 0 GB-Horas
- 0,5 GB x 10 dias x (24 horas por dia) = 120 GB-Horas
- 3 GB x 15 dias x (24 horas por dia) = 1.080 GB-Horas
- 0 GB-Horas + 120 GB-Horas + 1.080 GB-Horas = 1.200 GB-Horas no total
- 1.200 GB-Horas / (744 horas por mês) = 1,6 GB-Meses
O uso projetado de 1,6 GB de armazenamento no mês não excederia seu limite de 2 GB, embora o valor real do armazenamento tenha excedido 2 GB por metade do mês.
Como gerenciar o orçamento para o GitHub Packages
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.