You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
GitHub Action
structurizr-cli-action
v0.0.4
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)
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)
The Dockerfile and associated scripts and documentation in this project are released under the MIT.
The initial GitHub action has been created by Maksim Milykh.