constellation/.github/workflows/update-cli-reference.yml

name: Publish CLI reference to documentation
on:
  workflow_dispatch:
  push:
    branches:
      - main
      - "release/**"
    paths:
      - "cli/cmd/**"
      - "cli/internal/cmd/**"
      - "hack/clidocgen/**"

jobs:
  publish-to-docs:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout Constellation
        uses: actions/checkout@93ea575cb5d8a053eaa0ac8fa3b40d7e05a33cc8 # tag=v3.1.0

      - name: Setup Go environment
        uses: actions/setup-go@c4a742cab115ed795e34d4513e2cf7d472deb55f # tag=v3.3.1
        with:
          go-version: "1.19.2"
          cache: true

      - name: Generate reference docs
        run: go run . | cat header.md - > ../../cli.md
        working-directory: hack/clidocgen

      - name: Get commit sha
        run: |
          echo "COMMIT_END=$(echo ${{ github.sha }} | cut -c1-8)" >> $GITHUB_ENV

      - name: Check if action branch exists
        run: |
          ex=$(git ls-remote --heads origin action/constellation/update-cli-reference)
          echo "EXISTS=$(if [ -z "$ex" ]; then echo 0; else echo 1; fi)" >> $GITHUB_ENV

      - name: Publish new reference (create new branch)
        if: ${{ env.EXISTS == 0 }}
        uses: dmnemec/copy_file_to_another_repo_action@c93037aa10fa8893de271f19978c980d0c1a9b37 # tag=v1.1.1
        env:
          API_TOKEN_GITHUB: ${{ secrets.CI_GITHUB_REPOSITORY }}
        with:
          source_file: "cli.md"
          destination_repo: "edgelesssys/constellation"
          destination_branch_create: "action/constellation/update-cli-reference"
          destination_folder: "docs/docs/reference"
          user_name: "${{ github.actor }}"
          user_email: "${{ github.actor }}@users.noreply.github.com"
          commit_message: "CLI reference was updated by edgelesssys/constellation@${{ env.COMMIT_END}}"

      - name: Publish new reference (update branch)
        if: ${{ env.EXISTS == 1 }}
        uses: dmnemec/copy_file_to_another_repo_action@c93037aa10fa8893de271f19978c980d0c1a9b37 # tag=v1.1.1
        env:
          API_TOKEN_GITHUB: ${{ secrets.CI_GITHUB_REPOSITORY }}
        with:
          source_file: "cli.md"
          destination_repo: "edgelesssys/constellation"
          destination_branch: "action/constellation/update-cli-reference"
          destination_folder: "docs/docs/reference"
          user_name: "${{ github.actor }}"
          user_email: "${{ github.actor }}@users.noreply.github.com"
          commit_message: "CLI reference was updated by edgelesssys/constellation@${{ env.COMMIT_END}}"