CI/CD Best Practices¶

Optimize your CI/CD pipelines with rninja.

Cache Strategy¶

Use Remote Cache¶

For maximum benefit across CI runs:

export RNINJA_CACHE_MODE=auto
export RNINJA_CACHE_REMOTE_SERVER=tcp://cache:9999

Push Policy by Branch¶

if [ "$BRANCH" = "main" ]; then
    export RNINJA_CACHE_PUSH_POLICY=always
else
    export RNINJA_CACHE_PUSH_POLICY=never
fi

Cache Key Design¶

Include relevant factors:

key: build-${{ hashFiles('**/CMakeLists.txt', '**/Cargo.lock') }}

Performance Tips¶

Maximize Parallelism¶

rninja -j0  # Use all cores

Keep Going on Errors¶

Find all errors in one run:

rninja -k0  # Don't stop on failures

Use Single-Shot in Ephemeral Runners¶

rninja --no-daemon  # No daemon overhead

Security¶

Protect Tokens¶

Use CI secret management:

env:
  RNINJA_CACHE_TOKEN: ${{ secrets.CACHE_TOKEN }}

Limit Push Access¶

Only main branch populates cache:

- if: github.ref == 'refs/heads/main'
  run: export RNINJA_CACHE_PUSH_POLICY=always

Monitoring¶

Log Cache Stats¶

- run: rninja
- run: rninja -t cache-stats

Generate Build Traces¶

- run: rninja --trace trace.json
- uses: actions/upload-artifact@v3
  with:
    path: trace.json

Common Patterns¶

Build Matrix¶

Test multiple configurations:

strategy:
  matrix:
    build_type: [Debug, Release]
    os: [ubuntu-latest, macos-latest]

Artifact Caching¶

Combine CI cache with rninja cache:

- uses: actions/cache@v3
  with:
    path: ~/.cache/rninja
    key: rninja-${{ runner.os }}

Conditional Builds¶

Skip builds when no source changes:

- uses: dorny/paths-filter@v2
  id: changes
  with:
    filters: |
      src:
        - 'src/**'
- if: steps.changes.outputs.src == 'true'
  run: rninja