CI/CD para Rust

Um pipeline robusto de Rust executa fmt, clippy, test e build --release em cada PR, armazena em cache target/ e o índice do registro, e publica binários ou contêineres em tags.

Receita

# .github/workflows/ci.yml
name: ci
on: [push, pull_request]
 
jobs:
  rust:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
        with:
          toolchain: 1.97.0
          components: rustfmt, clippy
      - uses: Swatinem/rust-cache@v2
      - run: cargo fmt --all -- --check
      - run: cargo clippy --all-targets --all-features -- -D warnings
      - run: cargo test --all-features
      - run: cargo build --release --locked

Quando usar isso:

• Todo repositório de equipe com mais de um contribuidor
• Antes de habilitar o deploy automático para staging
• Quando o tempo de CI exceder 10 minutos sem cache

Exemplo de Trabalho

strategy:
  matrix:
    target:
      - x86_64-unknown-linux-gnu
      - aarch64-unknown-linux-gnu
steps:
  - run: rustup target add ${{ matrix.target }}
  - run: cross build --release --target ${{ matrix.target }}

# Paridade local
cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings
cargo test

O que isso demonstra:

• O pin da toolchain corresponde ao MSRV de produção
• rust-cache restaura dependências entre execuções
• A matriz valida artefatos compilados cruzados

Análise Profunda

Camadas de Cache

Automação de Release

A tag v1.2.3 aciona:

1. cargo build --release
2. SBOM / cargo auditable (opcional)
3. Envio de contêiner ou anexo de assets de GitHub Release

Use cargo-release ou release-plz para versionamento de crates em bibliotecas.

Armadilhas

• Sem --locked no CI - o desvio do lockfile envia dependências quebradas. Correção: falhar o CI se o lock estiver desatualizado.
• Avisos do Clippy ignorados - a dívida técnica se acumula. Correção: -D warnings no branch principal.
• Testes que exigem banco de dados Docker - instáveis sem um contêiner de serviço. Correção: services: postgres no Actions ou modo offline do sqlx.
• Explosão da matriz de features - 2^n combinações. Correção: testar default mais all-features em um agendamento noturno.
• Grandes testes de integração em cada PR - feedback lento. Correção: dividir o job rápido cargo test --lib.

Alternativas

FAQs

Relacionados

• Configuração de CI para Rust
• Compilação cruzada
• Release e versionamento
• Linting em CI

Versões da Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, e Polars 0.46+.