Como você configura pipelines de CI/CD como código?

Question

Accepted Answer

Os pipelines de CI/CD modernos são definidos como **código** — arquivos de configuração (geralmente YAML) armazenados no repositório que descrevem os gatilhos, jobs e etapas do pipeline. **Pipeline-as-code** torna os pipelines versionados, revisáveis e reproduzíveis.

## Estrutura de pipeline-as-code

```yaml
# example: GitHub Actions (.github/workflows/ci-cd.yml)
name: CI/CD
on:                              # TRIGGERS — when to run
  push:
    branches: [main]
  pull_request:
jobs:                            # JOBS — units of work (can run in parallel)
  test:
    runs-on: ubuntu-latest        # the environment/runner
    steps:                        # STEPS — sequential commands/actions
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm test
  deploy:
    needs: test                   # run only AFTER test succeeds (dependency)
    if: github.ref == 'refs/heads/main'   # condition: only on main
    runs-on: ubuntu-latest
    steps:
      - run: ./deploy.sh
```

## Conceitos-chave de configuração

```text
TRIGGERS → what events run the pipeline (push, PR, tag, schedule, manual)
JOBS → units of work (each runs in its own environment; can run in PARALLEL)
STEPS → the sequential commands/actions within a job
DEPENDENCIES → "needs" (job ordering: deploy after test passes)
CONDITIONS → run steps/jobs only when criteria match (e.g. only on main)
SECRETS / ENV → inject credentials and config securely (NOT hardcoded)
CACHING → cache dependencies between runs (faster builds)
MATRIX → run across multiple versions/OSes (e.g. test on Node 18, 20, 22)
```

## Benefícios do pipeline-as-code

```text
✓ VERSION CONTROLLED — pipeline changes tracked in Git (history, who/why)
✓ REVIEWED — pipeline changes go through PR review (like code)
✓ REPRODUCIBLE — the pipeline definition lives with the code, consistent
✓ Easy to share, replicate, and roll back
```

## Por que isso importa

Entender como configurar pipelines de CI/CD como código é conhecimento prático valioso porque pipeline-as-code é a abordagem moderna padrão, e configurar pipelines é uma habilidade central de CI/CD. **Pipeline-as-code** — definir o pipeline em arquivos de configuração (geralmente YAML) armazenados no repositório — é como o CI/CD moderno é configurado, e entender a **estrutura** (gatilhos definindo quando o pipeline é executado, jobs como unidades de trabalho, etapas como os comandos sequenciais, dependências para ordenação e condições para execução seletiva) é necessário para realmente criar e modificar pipelines.

Entender os **conceitos-chave de configuração** — gatilhos (push, PR, tag, agendamento, manual), jobs (unidades paralelas em seus próprios ambientes), etapas, dependências (`needs` para ordenação como deploy-after-test), condições (executando apenas em certos branches), **secrets/env** (injetando credenciais com segurança em vez de codificar — importante para segurança), caching (builds mais rápidos) e matrix builds (testando em versões/SOs diferentes) — abrange o toolkit prático para construir pipelines reais.

Entender os **benefícios do pipeline-as-code** é importante: porque o pipeline é definido em código no repositório, é **versionado** (alterações rastreadas com histórico), **revisado** (alterações de pipeline passam por revisão de PR como código de aplicação) e **reproduzível** (a definição fica com o código) — trazendo o mesmo rigor de engenharia para pipelines que para código de aplicação, o que é muito melhor do que pipelines configurados por meio de uma UI (não rastreados, não revisáveis, difíceis de reproduzir).

Como configurar pipelines é uma habilidade central de CI/CD e pipeline-as-code é a abordagem moderna padrão (com seus benefícios de controle de versão, revisão e reprodutibilidade), e uma vez que entender a estrutura, conceitos de configuração e benefícios permite construir e manter pipelines reais, entender como configurar pipelines de CI/CD como código é conhecimento valioso e praticamente relevante — uma habilidade fundamental para implementar CI/CD e uma prática recomendada que trata definições de pipeline com o mesmo rigor que código, importante para quem está configurando entrega automatizada.