Como é medido o uso de GitHub Packages
GitHub Packages O uso é gratuito para pacotes públicos. Além disso, os dados transferidos de qualquer fonte são gratuitos.
Para repositórios privados, cada conta GitHub recebe uma cota de armazenamento e de transferência de dados para uso com GitHub Packages, dependendo do plano da conta. Qualquer uso além dos valores incluídos é cobrado em sua conta.
- Transferência de dados Sua cota gratuita é redefinida no início de cada ciclo de cobrança.
- Armazenamento: As cobranças são acumuladas continuamente ao longo do mês com base no seu consumo por hora. No início de cada ciclo de cobrança, o total de armazenamento acumulado é redefinido para zero e começa a se acumular novamente.
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 GitHub Actions baixar um pacote de 500 MB de um repositório privado usando um
GITHUB_TOKEN, isso não é contabilizado na cota de transferência de dados do proprietário do repositório; veja Downloads de pacotes por GitHub Actions.
Uso gratuito de GitHub Packages
As seguintes quantidades de armazenamento e transferência de dados estão incluídas em seu GitHub plano. No início de cada mês, a transferência de dados para a conta é redefinida como zero.
| Plano | Armazenamento | Transferência de dados (por mês) |
|---|---|---|
| GitHub Free | 500MB | 1 GB |
| GitHub Pro | 2 GB | 10GB |
GitHub Free para organizações | 500MB | 1 GB | GitHub Team | 2 GB | 10GB GitHub Enterprise Cloud | 50GB | 100GB
Os valores de armazenamento mostrados são compartilhados com GitHub Actions artefatos. Isso significa que o armazenamento total entre o Packages e os artefatos do Actions não pode exceder a quantidade incluída no seu plano.
Observação
* Cobrança pelo armazenamento de imagens de contêiner: O armazenamento de imagens de contêiner e a largura de banda do Container registry são atualmente gratuitos. Se você usar Container registry, será informado pelo menos um mês antes de qualquer alteração nessa política. Para obter mais informações sobre Container registry, confira Trabalhando com o registro de contêiner.
Downloads do pacote por GitHub Actions
Quando um fluxo de trabalho usa GitHub Actions para baixar um pacote, a transferência de dados não conta com o uso do repositório de hospedagem. Determinamos que você está baixando pacotes usando GitHub Actions quando faz login em GitHub Packages usando um GITHUB_TOKEN.
| Hospedado | Auto-hospedado | |
|---|---|---|
Acesso por meio de um GITHUB_TOKEN | Gratuito | Gratuito |
| Acesso por meio de um personal access token | Gratuito | Paga |
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.
Pagando pelo uso adicional GitHub Packages
Você paga por qualquer uso adicional acima da cota usando a forma de pagamento configurada para sua GitHub conta. 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 mensurados, 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.
GitHub calcula o uso de armazenamento para cada mês com base no uso por hora por GB durante esse 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, GitHub arredonda o 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 GitHub Team, que fornece 2 GB de armazenamento gratuito e usa 0 GB nos primeiros 5 dias de abril, 1,5 GB para os 10 dias seguintes e planeja usar 3 GB nos últimos 15 dias do ciclo de cobrança, seu uso de armazenamento projetado para o 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.
Gerenciando seu orçamento para GitHub Packages
Se sua conta não tiver uma forma de pagamento válida registrada, o uso será bloqueado quando você usar sua cota.
Se você tiver uma forma de pagamento válida arquivada, os gastos poderão ser limitados por um ou mais orçamentos. Verifique os orçamentos definidos para sua conta para garantir que sejam apropriados para suas necessidades de uso. Confira Definir orçamentos para controlar gastos com produtos limitados.
Você também pode receber notificações por email quando o uso incluído GitHub Packages atingir 90% e 100% durante um período de cobrança. Para saber mais, confira Orçamentos e alertas.