CI/CD Integration
Why CI/CD
Continuous Integration (CI) and Continuous Deployment (CD) automate the process of building, testing, and deploying documents. By integrating Metanorma into CI/CD pipelines, documents are always up-to-date and consistent, release cycles are faster, and manual errors are reduced.
Supported platforms
| Platform | Compilation | Site deployment | Organization-scale publishing |
|---|---|---|---|
Yes (native actions) |
Yes (GitHub Pages) |
Yes (per-document releases, channels, aggregation) |
|
Yes (Docker) |
Yes (GitLab Pages) |
No |
|
Yes (Docker) |
Manual |
No |
GitHub provides the most complete support through the
actions-mn ecosystem of GitHub Actions.
Organization-scale publishing
For organizations that publish many documents across many repositories, Metanorma provides per-document releases with channel-based routing and multi-repo aggregation into a unified portal. This feature is GitHub-only.
For the full setup guide with config schemas and checklists, see Organization-Scale Publishing Setup. For a step-by-step tutorial, see the blog post.