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.2.0
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@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)
This action is based upon the Dockerfile created and maintained here https://github.com/aidmax/structurizr-cli-docker
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.