Skip to content

Merge pull request #167 from keirthana/fix-typo #11

Merge pull request #167 from keirthana/fix-typo

Merge pull request #167 from keirthana/fix-typo #11

name: Automatically generate command reference topics
on:
push:
workflow_dispatch:
env:
AMC_COMMAND_REFERENCE_DIR: "./reference/cmd-ref/amc"
APPLIANCE_COMMAND_REFERENCE_DIR: "./reference/cmd-ref/appliance"
jobs:
run-tests:
runs-on: ubuntu-24.04
steps:
- name: Determine base version
id: base_version
run: |
echo "value=$(cat .base_version)" >> "$GITHUB_OUTPUT"
- name: Setup Anbox Cloud
uses: canonical/anbox-cloud-github-action@39490d442cc0921fe614f7044b9f3dc8bd89725c
with:
channel: ${{ steps.base_version.outputs.value }}/stable
- name: Checkout repo
uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871 # v4
# Remove existing files, generate AMC command reference
- name: Generate AMC command reference documentation
run: |
set -e
rm -rf $AMC_COMMAND_REFERENCE_DIR/*
amc generate documentation -f markdown -d $AMC_COMMAND_REFERENCE_DIR
- name: Commit changes
if: ${{ github.ref == 'refs/heads/main' }}
uses: EndBug/add-and-commit@a94899bca583c204427a224a7af87c02f9b325d5 # v9.1.4
with:
default_author: github_actions
message: 'Generate AMC command reference documentation'
add: ${{ env.AMC_COMMAND_REFERENCE_DIR }}
# Remove existing files, generate appliance command reference
- name: Generate appliance command reference documentation
env:
SNAP_DOCS_DIR: "/var/snap/anbox-cloud-appliance/common/docs"
# For the appliance command, the files have to be generated inside the Snap
# and then copied to the desired directory because of Snap confinement
run: |
set -e
rm -rf $APPLIANCE_COMMAND_REFERENCE_DIR/*
sudo mkdir -p $SNAP_DOCS_DIR
sudo anbox-cloud-appliance generate documentation -f markdown -d $SNAP_DOCS_DIR
cp -r $SNAP_DOCS_DIR/* $APPLIANCE_COMMAND_REFERENCE_DIR
- name: Commit changes
if: ${{ github.ref == 'refs/heads/main' }}
uses: EndBug/add-and-commit@a94899bca583c204427a224a7af87c02f9b325d5 # v9.1.4
with:
default_author: github_actions
message: 'Generate appliance command reference documentation'
add: ${{ env.APPLIANCE_COMMAND_REFERENCE_DIR }}