Skip to main content
SDD Classification: L4-Operational | Authority: Platform Engineering | Review Cycle: Quarterly

​
Overview

This runbook covers how CI/CD is expected to work across Materi services, and how to operate and troubleshoot the pipeline system.

​
Pipeline architecture

At a high level:
  • Per-service CI runs on PRs and main pushes
  • Integration tests run after service CI gates
  • Security scans and policy gates run before deploy
  • Deployment is triggered via approved workflows (manual or GitOps)

​
Workflow reference (baseline)

​
Triggering pipelines

​
Manual dispatch

​
Monitoring

Track pipeline health using:
  • GitHub Actions run history
  • Deployment health checks in the target environment
  • Observability dashboards (if configured)

​
Rollback procedures

Rollback guidance lives in: /developer/operations/deployment/rollback

​
Troubleshooting

Common classes:
  • Toolchain mismatch (Go/Python/Rust versions)
  • Secrets missing (registry, kubeconfig)
  • Security gate failures
  • Flaky integration tests
When debugging, capture:
  • Workflow name + run URL
  • failing job name
  • commit SHA