Skip to content
Latchkey

O Que É um Deployment no GitHub Actions?

Um deployment é um release rastreado de código para um environment, com status e histórico registrados pelo GitHub.

Enviar código é mais do que executar um script de deploy: você quer um registro do que foi para onde e se teve sucesso. Os deployments do GitHub vinculam uma execução de workflow a um environment e rastreiam seu resultado.

O que é

Um deployment é um objeto do GitHub que representa um release para um environment nomeado. Um job que direciona para um environment: cria um deployment cujo status reflete o resultado do job.

A deployment job
jobs:
  release:
    runs-on: ubuntu-latest
    environment:
      name: production
      url: https://app.example.com
    steps:
      - run: ./deploy.sh

Como funciona

Quando o job é executado, o GitHub registra um deployment para aquele environment, incluindo uma URL opcional. O deployment passa por estados (em andamento, sucesso, falha) e aparece no histórico do environment.

Por que importa

Os deployments proporcionam auditabilidade: quem fez deploy do quê e para onde, e se funcionou. Combinados com regras de proteção de environment, eles transformam releases em eventos revisáveis e rastreáveis.

Deployments e proteção

Como os deployments direcionam para environments, eles herdam regras de proteção, então um deployment de produção pode exigir aprovação antes do job, e o registro do deployment captura a aprovação.

Conceitos relacionados

Os deployments são criados por jobs que direcionam para environments e frequentemente são iniciados via workflow_dispatch.

Principais conclusões

  • Um deployment é um release rastreado para um environment.
  • Direcionar para environment: cria um registro de deployment.
  • Ele fornece status e histórico auditáveis.

Guias relacionados