Como é medido o uso de GitHub Actions
O uso do GitHub Actions é **grátis** para **executores auto-hospedados** e para **repositórios públicos** que utilizam executores padrão hospedados pelo GitHub. Confira [AUTOTITLE](/actions/writing-workflows/choosing-where-your-workflow-runs/choosing-the-runner-for-a-job#standard-github-hosted-runners-for-public-repositories).
Para repositórios privados, cada conta GitHub recebe uma cota de minutos gratuitos, armazenamento de artefatos e armazenamento em cache para uso com executores hospedados pelo GitHub, dependendo do plano da conta. Qualquer uso além dos valores incluídos é cobrado em sua conta.
-
**Minutos:** Seus minutos gratuitos são redefinidos para o valor total no início de cada ciclo de cobrança. O uso de minutos é cobrado do proprietário do repositório, não da pessoa que disparou a execução do workflow. -
**Armazenamento:** Os encargos de armazenamento se acumulam ao longo do mês com base no uso por hora. Os encargos de armazenamento acumulados são redefinidos para zero no início de cada ciclo de cobrança.
Dica
Qualquer pessoa com acesso de gravação a um repositório pode executar ações. Todos os custos de execução das ações são cobrados para o proprietário do repositório.
Como funciona a cobrança de armazenamento
GitHub Actions A cobrança de armazenamento opera em um **modelo de acréscimo por hora**:
* Cobrança contínua: Os encargos de armazenamento são acumulados a cada hora com base no uso real ao longo do mês * Total mensal: Sua fatura reflete o armazenamento total usado ao longo do mês, medido em GB-Hours * Valor incluído: O subsídio de armazenamento gratuito para seu plano (por exemplo, 50 GB no plano Enterprise) é convertido em uma taxa por hora para cálculos de cobrança
-
**Armazenamento compartilhado:** artefatos do Actions, caches do Actions e o armazenamento do GitHub Packages compartilham a mesma cota agrupada. Para saber mais, confira [AUTOTITLE](/billing/concepts/product-billing/github-packages).
Noções básicas sobre o armazenamento atual versus acumulado
É importante entender a diferença entre o que você vê em GitHub e o que aparece na sua fatura:
-
**Armazenamento atual:** A quantidade de armazenamento que você tem agora -
**Armazenamento acumulado:** O total cumulativo de armazenamento usado durante todo o ciclo de cobrança (determina sua fatura) **Quando você exclui artefatos:** -
O armazenamento atual diminui imediatamente
-
Futuras cobranças por hora param de se acumular
-
O armazenamento já acumulado durante o ciclo de cobrança atual permanece no total e aparecerá em sua fatura
**Exemplo (ciclo de cobrança de 30 dias):** Se você armazenar 10 GB de artefatos por 10 dias, exclua tudo no dia 11: -
Dias 1 a 10: Acumulando 240 GB-Hours por dia (10 GB × 24 horas)
-
Dia 11: Excluir artefatos → armazenamento atual cai para 0 GB
-
Dias 11-30: Acumulando 0 GB-horas (sem armazenamento)
-
Sua fatura: Mostra um total de 2.400 GB-horas (10 dias × 240 GB-horas/dia)
A exclusão de artefatos reduz o armazenamento atual e impede encargos futuros, mas não remove os encargos já registrados pelo tempo em que o armazenamento existia.
Unidades de medição de armazenamento
GitHub Actions mede o armazenamento em **GB (gigabytes binários),** em que:
-
1 GB = 2^30 bytes = 1.073.741.824 bytes
-
Isso também é conhecido como um gibibyte (GiB)
-
1 GB = 1.024 megabytes (MB)
**Os cálculos de cobrança usam GB-Hours:** -
1 GB-Hour = 1 GB de armazenamento por 1 hora
-
Exemplo: Armazenar 3 GB por 10 dias = 720 GB-Hours (3 GB × 10 dias × 24 horas)
Sua fatura mensal converte GB-Hours em GB-Months dividindo por horas no mês (geralmente 720 horas por um mês de 30 dias).
Armazenamento de imagens personalizadas
Para Executores maiores hospedados no GitHub, o armazenamento de imagens personalizadas é cobrado por meio do armazenamento do GitHub Actions.
O armazenamento de imagens personalizado usa o mesmo modelo de cobrança horária que outros GitHub Actions armazenamentos. Sua fatura é baseada na quantidade de dados de imagem armazenados ao longo do tempo, medidos em GB-Hours.
O uso de armazenamento para imagens personalizadas depende de:
- O tamanho de cada versão da imagem
- O número de versões de imagem que você retém
- Quanto tempo cada versão é armazenada
Cada tarefa do fluxo de trabalho bem-sucedida que inclui a palavra-chave snapshot cria uma nova versão de imagem personalizada. Cada versão retida contribui para o uso do armazenamento até que a versão seja excluída ou removida por uma política de retenção. Para obter mais informações, consulte Usando imagens personalizadas e Impor políticas para GitHub Actions em sua empresa.
O armazenamento personalizado de imagens baseia-se nos dados de imagens mantidos ao longo do tempo, e não no número de vezes que um executante utiliza ou baixa uma imagem existente.
Por exemplo:
- Armazenar uma versão de imagem personalizada de 150 GB por 24 horas usa 3.600 GB-horas.
- Armazenar quatro versões de 150 GB da mesma imagem por 24 horas usa 14.400 GB-Hours.
Exemplos de como o uso é medido
- Se você executar um fluxo de trabalho em um executor do Linux e levar 10 minutos para ser concluído, você usará 10 minutos do subsídio do proprietário do repositório. Se o fluxo de trabalho gerar um artefato de 10 MB, você também usará 10 MB do subsídio de armazenamento de artefatos do proprietário do repositório.
- Se você executar um fluxo de trabalho que normalmente leva 10 minutos e ele falhar após 5 minutos porque uma dependência não está disponível, você usará 5 minutos da franquia do proprietário do repositório. Se você corrigir o problema e executar novamente o fluxo de trabalho com êxito, no total, você usará 15 minutos da franquia do proprietário do repositório.
- Se você executar um fluxo de trabalho que gera muitos arquivos de log e um longo resumo de trabalho, esses arquivos não contam para a concessão de armazenamento de artefatos do proprietário do repositório.
- O uso do armazenamento em cache é medido pelo uso de pico para cada hora. O uso incluído é de 10 GB por repositório. Por uma determinada hora, se um repositório tiver um uso de cache de pico de 15 GB, o proprietário do repositório será cobrado pelos 5 GB de uso acima dos 10 GB incluídos para essa hora. O proprietário do repositório será cobrado somente se o limite de armazenamento em cache do repositório tiver sido configurado acima do uso incluído.
- O armazenamento em cache adicional é de US$ 0,07 por GiB, por mês.
Uso gratuito de GitHub Actions
Os seguintes tempos para executores padrão, armazenamento de artefatos e armazenamento de cache estão incluídos no seu plano GitHub. No início de cada mês, os minutos usados pela conta são zerados.
| Plano | Armazenamento de artefatos | Minutos (por mês) | Armazenamento em cache |
|---|---|---|---|
| GitHub Free | 500 MB | 2.000 | 10 GB |
| 1 GB | 3.000 | 10 GB | |
| GitHub Free para organizações | 500 MB | 2.000 | 10 GB |
| GitHub Team de dados | 2 GB | 3.000 | 10 GB |
| GitHub Enterprise Cloud | 50 GB | 50,000 | 10 GB |
O uso de executores padrão hospedados pelo GitHub é gratuito:
- Em repositórios públicos
- Para GitHub Pages
- Para Dependabot
- Para os recursos de agente (versão prévia pública) no GitHub Copilot revisão de código
Observação
- Executores maiores são sempre cobrados, mesmo quando usados por repositórios públicos ou quando você tem cota disponível no seu plano.
- Os valores de armazenamento mostrados são compartilhados com GitHub Packages. Isso significa que seu armazenamento total em artefatos do Actions, caches do Actions e pacotes não pode exceder a quantidade incluída no seu plano.
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. O uso de executores maiores fica sempre bloqueado até que você configure um método de pagamento.
Pagamento pelo uso adicional do GitHub Actions
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.
Para executores hospedados pelo GitHub, o armazenamento é cobrado com base no uso por hora de artefatos e caches ao longo do mês. Os minutos são calculados com base no tempo total de processamento usado por cada tipo de executor durante o mês.
- Para estimar os custos de uso pago, use a GitHubcalculadora de preços.
- Para exibir seus custos atuais, consulte Como exibir o uso de licenças e produtos mensuráveis.
Observação
O painel de cobrança pode mostrar o uso do Actions como um valor em dólar ("gastos") em vez de minutos brutos. Esse valor já reflete os custos de minuto aplicáveis.
Custos por minuto padrão
Cada tipo de executor hospedado por GitHub tem um custo por minuto que é determinado pelo sistema operacional e pelo poder de processamento.
Por exemplo, trabalhos executados em executores do Windows e macOS hospedados GitHub custam mais para executar do que trabalhos em executores do Linux.
| Sistema Operacional | SKU de Cobrança | Taxa por minuto (USD) |
|---|---|---|
| Linux 1 núcleo (x64) | actions_linux_slim | $0,002 |
| Linux 2 núcleos (x64) | actions_linux | US$ 0,006 |
| Linux 2 núcleos (arm64) | actions_linux_arm | US$ 0,005 |
| Windows 2-core (x64) | actions_windows | $0,010 |
| Windows 2 core (arm64) | actions_windows_arm | $0,010 |
| macOS com 3 ou 4 núcleos (M1 ou Intel) | actions_macos | US$ 0,062 |
Para obter detalhes completos sobre os custos por minuto de diferentes tipos de corredores, consulte Precificação do executor de ações.
Exemplo de cálculo do custo em minutos para executores hospedados pelo GitHub
Por exemplo, se sua organização usar GitHub Team, utilizar 5.000 minutos além da cota incluída em executores hospedados pelo GitHub teria um custo total atual de USD 38 em minutos do Actions, se você utilizou executores Linux e Windows padrão.
- 5.000 (3.000 Linux e 2.000 Windows) minutos = US$ 38 USD (US$ 18 + US$ 20 USD).
- 3.000 minutos do Linux a US$ 0,006 por minuto = US$ 18 USD.
- 2.000 minutos do Windows com USD 0,010 por minuto = USD 20.
Cálculo de custo de armazenamento de artefatos de exemplo
Se você usar 3 GB de armazenamento de artefatos por 10 dias de março e 12 GB por 21 dias de março, o uso do armazenamento de artefatos será:
- 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
- 6.768 GB-Horas / (744 horas por mês) = 9,0967 GB-Meses
No final do mês, o GitHub arredonda o armazenamento de artefatos para o MB mais próximo. Portanto, o uso do armazenamento de artefatos para março seria de 9,097 GB.
Observação
O GitHub atualiza o uso do armazenamento de artefatos dentro de 6 a 12 horas. A exclusão de artefatos libera espaço para o armazenamento atual, mas não reduz o uso de armazenamento acumulado, que é usado para calcular a cobrança de armazenamento para o ciclo de cobrança atual.
Exemplo de cálculo de custo de armazenamento em cache
Se você usar 3 GB de armazenamento em cache por 10 dias de março e 12 GB durante 21 dias de março, o uso do armazenamento em cache será:
| Uso (GBs) | Faturável (GB-Horas) | Não faturável (GB-Horas) |
|---|---|---|
| 3 GB para os primeiros 10 dias | 0 GB-Horas | 720 GB-Horas |
| 12 GB para os próximos 21 dias |
**2\*21 dias\*24 horas = 1008 GB-Horas** | 10\*21 dias\*24 horas=5040 GB-Horas |
Para armazenamento armazenado em cache, gráficos de cobrança e relatórios mostram apenas o custo de uso além dos 10 GB incluídos. Ao final do mês, a SKU de armazenamento em cache do Actions apresentaria um uso de 1008 GB-horas.
Gerenciando seu orçamento para GitHub Actions
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 de GitHub Actions atingir 90% e 100% durante um período de faturamento. Para saber mais, confira Orçamentos e alertas.
Leitura adicional
-
[AUTOTITLE](/actions/get-started/understand-github-actions) -
[AUTOTITLE](/actions/get-started/quickstart)