Other CI/CD Platforms

Overview

Metanorma can be used on any CI/CD platform that supports Docker. The metanorma/metanorma Docker image is available on Docker Hub.

These platforms support compilation and artifact generation. Site deployment must be configured manually. Organization-scale publishing (per-document releases, channels, aggregation) is GitHub-only.

For site generation options, see Site generation. For GitHub Actions (which support the full feature set), see GitHub Actions integration.

Travis CI

Example 1. .travis.yml

language: minimal

services:
  - docker

before_install:
  - docker pull metanorma/metanorma

script:
  - docker run --rm -v $(pwd):/metanorma metanorma/metanorma metanorma site generate --agree-to-terms

CircleCI

Example 2. .circleci/config.yml

version: 2.1

jobs:
  build:
    docker:
      - image: metanorma/metanorma
    steps:
      - checkout
      - run:
          name: Generate Metanorma site
          command: metanorma site generate --agree-to-terms

workflows:
  version: 2
  build:
    jobs:
      - build

Jenkins

Example 3. Jenkinsfile

pipeline {
    agent {
        docker {
            image 'metanorma/metanorma'
        }
    }
    stages {
        stage('Build') {
            steps {
                sh 'metanorma site generate --agree-to-terms'
            }
        }
    }
}

Bitrise

Example 4. bitrise.yml

format_version: '8'
default_step_lib_source: https://github.com/bitrise-io/bitrise-steplib.git

workflows:
  primary:
    steps:
      - git-clone: {}
      - docker-compose:
          inputs:
            - content: |
                version: '3'
                services:
                  metanorma:
                    image: metanorma/metanorma
                    volumes:
                      - .:/metanorma
                    command: metanorma site generate --agree-to-terms