O Que É um Artifact no GitHub Actions?

Um artifact é um arquivo ou pasta que um job faz upload de uma execução, disponível para download ou para uso por outros jobs.

Runners são efêmeros, então qualquer coisa que um job produz, um build, um relatório de testes, um binário, desaparece a menos que você salve. Artifacts permitem persistir essas saídas e passá-las entre jobs.

O que é

Um artifact é um pacote nomeado de arquivos enviado durante uma execução com actions/upload-artifact e recuperado com actions/download-artifact.

steps:
  - uses: actions/upload-artifact@v4
    with:
      name: build-output
      path: dist/

Como funciona

A action de upload compacta e armazena o path sob um nome. Mais tarde na mesma execução, outro job pode baixá-lo; após a execução, ele permanece disponível por um período de retenção que você pode configurar.

Artifacts vs caches

Artifacts capturam as saídas de uma execução para download ou jobs downstream. Caches existem puramente para acelerar execuções futuras. Eles parecem similares, mas servem propósitos diferentes.

Por que importa

Artifacts movem saídas de build entre jobs (build e depois deploy) e preservam evidências como logs e relatórios. Retenção e tamanho afetam o uso de armazenamento e o custo.

Conceitos relacionados

Artifacts são produzidos via actions de upload/download e contrastam com actions/cache; eles frequentemente carregam dados entre jobs ligados por needs.

Principais conclusões

• Um artifact persiste arquivos de uma execução.
• Faça upload com upload-artifact, busque com download-artifact.
• Artifacts compartilham saídas; caches aceleram execuções futuras.

Guias relacionados