Archi container image for use in continuous integration pipelines. With this container, you can implement automatic report generation and model export in your pipeline.

The Archi modelling toolkit is targeted toward all levels of Enterprise Architects and Modellers.

For collaboration with models in the git repository, the coArchi plugin is installed in the container.

For ease of use, the entrypoint.sh script is run in the container, which processes the environment variables, and the native git client is used for cloning.

You can check the operation of the container using the example

• Container image
• Run Container
• Configuration
  • GitHub Actions Configuration
    • Variables
    • Inputs
• GitHub Actions Example
• GitLab CI Example
• Build Container
• Solving Potential Problems

You can pull image from registries:

• ghcr.io/woozymasta/archimate-ci:4.9.1-0.8
• quay.io/woozymasta/archimate-ci:4.9.1-0.8
• docker.io/woozymasta/archimate-ci:4.9.1-0.8

Example with cloning a remote repository and render HTML report:

mkdir -p ./report
chmod o+rw ./report

docker run --rm -ti \
  -v $(pwd)/report:/archi/report \
  -e GIT_REPOSITORY=https://github.com/WoozyMasta/archimate-ci-image-example.git \
  -e ARCHI_HTML_REPORT_ENABLED=true \
  -e ARCHI_JASPER_REPORT_ENABLED=false \
  -e ARCHI_CSV_REPORT_ENABLED=true \
  -e ARCHI_EXPORT_MODEL_ENABLED=true \
  ghcr.io/woozymasta/archimate-ci:4.9.1-0.8

An example with handling a local repository:

cd /path/to/exist/repository
mkdir -p ./report
chmod o+rw ./report

docker run --rm -ti \
  -v $(pwd):/archi/project \
  -v $(pwd)/report:/archi/report \
  ghcr.io/woozymasta/archimate-ci:4.9.1-0.8

Working with the CLI directly:

docker run --rm -ti ghcr.io/woozymasta/archimate-ci:4.9.1-0.8 --help

Configuration for connecting to the git repository:

• GIT_REPOSITORY - Git repository address;
• GIT_TOKEN - Token for accessing the git repository. Preferred for private repositories, or use a key mounted in an ssh container;
• GIT_USERNAME - Username (it is better to use token or ssh key);
• GIT_PASSWORD - Password (it is better to use token or ssh key).

Options for managing model export:

• ARCHI_PROJECT_PATH=/archi/project - The path where the git repository with the architectural model will be cloned or connected;
• ARCHI_REPORT_PATH=/archi/report - Path where reports will be saved;
• ARCHI_HTML_REPORT_ENABLED=true - Generate HTML report;
• ARCHI_HTML_REPORT_PATH=$ARCHI_REPORT_PATH/html - Path for save HTML report;
• ARCHI_JASPER_REPORT_ENABLED=false - Generate Jasper reports;
• ARCHI_JASPER_REPORT_PATH=$ARCHI_REPORT_PATH/jasper - Path for save Jasper report;
• ARCHI_JASPER_REPORT_FORMATS=PDF,DOCX - Formats for Jasper reports should be separated by commas. Valid values: PDF, HTML, RTF, PPT, ODT, DOCX;
• ARCHI_JASPER_REPORT_TITLE - The title for the Jasper report, the default is the model/project name;
• ARCHI_CSV_REPORT_ENABLED=false - Generate CSV report;
• ARCHI_CSV_REPORT_PATH=$ARCHI_REPORT_PATH/csv - Path for save CSV report;
• ARCHI_EXPORT_MODEL_ENABLED=true - Export model in *.archimate format.
• ARCHI_EXPORT_MODEL_PATH=$ARCHI_REPORT_PATH - Path for save model;
• ARCHI_APP=com.archimatetool.commandline.app application name.

• GITHUB_TOKEN - Use default token, or you can set some token from secrret ${{ secrets.ACCESS_TOKEN }}
• GITHUB_SERVER_URL=https://github.com - GitHub server URL;
• GITHUB_PAGES_DOMAIN - Custom domain CNAME for pages;
• GITHUB_PAGES_BRANCH=gh-pages - Branch for store reports used in pages;
• GIT_SUBTREE_PREFIX=.archi_report - Directory for store reports in model branch.

All inputs equivalent to environment variables:

• githubToken required
• archiHtmlReportEnabled
• archiJasperReportEnabled
• archiJasperReportFormats
• archiJasperReportTitle
• archiCsvReportEnabled
• archiExportModelEnabled
• githubServerURL
• githubPagesDomain
• githubPagesBranch
• gitSubtreePrefix

jobs:
  archi_report:
    permissions:
      contents: write
      pages: write
    runs-on: ubuntu-latest
    name: Deploy Archi report HTML to GitHub Pages
    steps:
      - name: Check out the repo
        uses: actions/checkout@v2

      - name: Deploy Archi report
        id: archi
        uses: WoozyMasta/[email protected]
        with:
          archiHtmlReportEnabled: true
          archiJasperReportEnabled: true
          archiJasperReportFormats: PDF,DOCX
          archiCsvReportEnabled: false
          archiExportModelEnabled: true
          githubToken: ${{ secrets.GITHUB_TOKEN }}

pages:
  stage: build
  image:
    name: woozymasta/archimate-ci-image:4.9.1-0.8

  script:
    - /opt/Archi/docker-entrypoint.sh
    
  variables:
    MODEL_PATH: "$CI_PROJECT_DIR"
    REPORT_PATH: "$CI_PROJECT_DIR/report"
    HTML_REPORT_ENABLED: "true"
    JASPER_REPORT_ENABLED: "true"
    JASPER_REPORT_FORMATS: "PDF,DOCX"
    JASPER_REPORT_TITLE: "true"
    CSV_REPORT_ENABLED: "true"
    EXPORT_MODEL_ENABLED: "true"

  rules:
    - if: $CI_COMMIT_BRANCH != null || $CI_PIPELINE_SOURCE == "merge_request_event"
      exists:
        - model/folder.xml

  artifacts:
    name: "$CI_JOB_NAME from $CI_PROJECT_NAME on $CI_COMMIT_REF_SLUG"
    expire_in: 1 week
    paths:
      - report/html

docker build \
  --tag archimate-ci:4.9.1-0.8 \
  --build-arg="ARCHI_VERSION=4.9.1-0.8" \
  --build-arg="COARCHI_VERSION=0.8.1.202112061132" \
  ./

If you are trying to build an image using podman or buildah and get a warning "SHELL is not supported for OCI image format", use the --format docker flag

If you use podman, unshare mounted volumes to user with id 1000.

mkdir -p ./report

podman unshare chown 1000 -R $(pwd)/model
podman run --rm -ti \
  -v $(pwd)/report:/archi/report \
  -e GIT_REPOSITORY=https://github.com/WoozyMasta/archimate-ci-image-example.git \
  -e ARCHI_JASPER_REPORT_ENABLED=false \
  ghcr.io/woozymasta/archimate-ci:4.9.1-0.8

If you are using a private git repository hosted behind a VPN, the tunnel interface or name resolution might not be available in the container, use the host network in the container and force the DNS record forward.

docker run --rm -ti \
  -v $(pwd)/archi:/archi \
  -e GIT_REPOSITORY=https://github.com/WoozyMasta/archimate-ci-image-example.git
  --network=host
  --add-host="$(getent hosts gitlab.internal.tld | awk '{print $2 ":" $1}')"
  ghcr.io/woozymasta/archimate-ci:4.9.1-0.8