CI/CD for Rust

A solid Rust pipeline runs fmt, clippy, test, and build --release on every PR, caches target/ and registry index, and publishes binaries or containers on tags.

Recipe

# .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

When to reach for this:

• Every team repo with more than one contributor
• Before enabling auto-deploy to staging
• When CI time exceeds 10 minutes without cache

Working Example

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 }}

# Local parity
cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings
cargo test

What this demonstrates:

• Toolchain pin matches production MSRV
• rust-cache restores dependencies between runs
• Matrix validates cross-compiled artifacts

Deep Dive

Cache Layers

Release Automation

Tag v1.2.3 triggers:

1. cargo build --release
2. SBOM / cargo auditable (optional)
3. Push container or attach GitHub Release assets

Use cargo-release or release-plz for crate versioning in libraries.

Gotchas

• No --locked in CI - lockfile drift ships broken deps. Fix: fail CI if lock outdated.
• Clippy warnings ignored - debt accumulates. Fix: -D warnings on main branch.
• Tests requiring Docker DB - flaky without service container. Fix: services: postgres in Actions or sqlx offline mode.
• Feature matrix explosion - 2^n combinations. Fix: test default plus all-features on nightly schedule.
• Huge integration tests on every PR - slow feedback. Fix: split cargo test --lib fast job.

Alternatives

FAQs

Related

• CI config for Rust
• Cross-compilation
• Release & versioning
• Linting in CI

External Related Links

• The Cargo Book - Official guide and reference for Cargo.
• Clippy Book / Lints - Official linter documentation.
• rustc Book - Compiler flags, internals overview, and usage.
• Rust in Action (Manning) - Tim McNamara.
• Rust for Rustaceans (Amazon) - Jon Gjengset.

Stack versions: This page was written for Rust 1.97.0 (edition 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, and Polars 0.46+.