Sobre artefatos de fluxos de trabalho
Um artefato é um arquivo ou uma coleção de arquivos produzidos durante a execução de um fluxo de trabalho. Os artefatos permitem que você preserve os dados após a conclusão de um trabalho e compartilhe-os com outro trabalho no mesmo fluxo de trabalho. Por exemplo, você pode usar artefatos para salvar o build e os resultados dos testes após o término da execução do fluxo de trabalho.
O GitHub fornece duas ações que você pode usar para carregar e baixar artefatos de build, upload-artifact e download-artifact no GitHub Enterprise Server.
Os artefatos comuns incluem:
- Arquivos de log e arquivos de despejo de núcleo
- Resultados de testes, falhas e capturas de tela;
- Arquivos binários ou comprimidos
- Resultados de desempenho do teste de estresse e de cobertura do código.
Artefatos versus armazenamento em cache de dependência
Artefatos e caches são semelhantes porque permitem armazenar arquivos em GitHub, mas cada recurso oferece casos de uso distintos e eles não podem ser usados de maneira intercambiável.
- Use o cache quando quiser reutilizar arquivos que não são alterados com frequência entre execuções de fluxo de trabalho, como dependências baixadas por um sistema de gerenciamento de pacotes, saídas de build intermediárias ou outros arquivos que são caros para regenerar. Armazenar esses arquivos em cache pode acelerar suas execuções de fluxo de trabalho, embora um trabalho sempre seja capaz de baixar novamente ou regenerar esses arquivos se um cache não estiver disponível.
- Use artefatos quando quiser salvar arquivos produzidos por uma tarefa para usar ou visualizar após o término da execução de um fluxo de trabalho, como binários compilados ou logs de compilação, ou quando quiser transferir arquivos entre tarefas em um fluxo de trabalho.
Para obter mais informações sobre o cache de dependência, confira Referência do cache de dependência.
Artefatos de execuções de fluxo de trabalho excluídas
Quando uma execução de fluxo de trabalho é excluída, todos os artefatos associados a ela também são excluídos do armazenamento. Você pode excluir uma execução de fluxo de trabalho usando a interface do usuário do GitHub Actions, a API REST ou a CLI do GitHub, confira: Excluir a execução de um fluxo de trabalho, Excluir uma execução de fluxo de trabalho ou gh run delete.