Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
copy

GitHub Action

structurizr-cli-action

v0.2.0

structurizr-cli-action

copy

structurizr-cli-action

Runs structurizr command line application

Installation

Copy and paste the following snippet into your .yml file.

              

- name: structurizr-cli-action

uses: aidmax/structurizr-cli-action@v0.2.0

Learn more about this action in aidmax/structurizr-cli-action

Choose a version

test

structurizr-cli GitHub Action

This GitHub action allows you to run structurizr-cli, a command line utility for Structurizr that lets you create software architecture models based upon the C4 model using a textual domain specific language (DSL).

Currently, the action supports the following functionality:

  • Push content to a Structurizr workspace (the cloud service or an on-premises installation)
    • A model and views defined using the Structurizr DSL
    • Markdown/AsciiDoc documentation
    • Architecture Decision Records (ADRs)

Usage

To use the action simply create an structurizr-cli.yml (or choose custom *.yml name) in the .github/workflows/ directory.

For example:

name: sctructurizr-cli  # feel free to pick your own name

on: [push, pull_request]

jobs:
  structurizr-cli:
    runs-on: ubuntu-latest
    name: Run structurizr-cli
    steps:

      - name: Checkout
        uses: actions/checkout@v2

      - name: Run structurizr-cli action
        uses: aidmax/structurizr-cli-action@v0.1.0
        id: test
        with:
          id: # The workspace ID (required)
          key: # The workspace API key (required)
          secret: # The workspace API secret (required)
          workspace: # The path to the workspace JSON file/DSL file(s) (required)

          # optional parameters
          docs: # The path to the directory containing Markdown/AsciiDoc files to be published (optional)
          adrs: # The path to the directory containing ADRs (optional)
          url: # The Structurizr API URL (optional; defaults to https://api.structurizr.com)
          passphrase: # The passphrase to use (optional; only required if client-side encryption enabled on the workspace)

Details

This action is based upon the Dockerfile created and maintained here https://github.com/aidmax/structurizr-cli-docker

License

The Dockerfile and associated scripts and documentation in this project are released under the MIT.

Credits

The initial GitHub action has been created by Maksim Milykh.