Getting started with Metanorma in CI/CD environments

Metanorma is often run on continuous integration (CI) and continuous deployment (CD) environments.

Running on CI/CD platforms

We currently support the following CI/CD platforms:

• GitHub Actions

• GitLab CI

Installation

Metanorma provides native packages installable on most major platforms and these packages can be installed through a non-interactive console/terminal. The full list is available here.

Metanorma also provides additional automated actions for the setup and running of Metanorma on CI/CD testers.

GitHub Actions

The following GitHub Actions can be used to simplify a Metanorma CI workflow:

• Metanorma setup: actions-mn/setup@v2

• Metanorma CLI actions: actions-mn/cli/site-gen@main and more

Please refer to our ISO samples repository for further reference.

GitLab CI

Metanorma provides a sample .gitlab-ci.yml workflow file that demonstrates how to use the Metanorma docker container in the environment.

• Sample .gitlab-ci.yml