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.0.4

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/[email protected]

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
        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)

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.