From e315a3b5d8d7063028a5ce5fc16c23b7c2a8514f Mon Sep 17 00:00:00 2001
From: Fabian Kammel <fabian@kammel.dev>
Date: Fri, 15 Jul 2022 10:23:52 +0200
Subject: [PATCH] AB#2070 automatic cli ref update (#272)

* automatically update cli reference branch in docs repository
Signed-off-by: Fabian Kammel <fk@edgeless.systems>
---
 .github/workflows/update-cli-reference.yml | 71 ++++++++++++++++++++++
 hack/clidocgen/header.md                   | 11 ++++
 2 files changed, 82 insertions(+)
 create mode 100644 .github/workflows/update-cli-reference.yml
 create mode 100644 hack/clidocgen/header.md

diff --git a/.github/workflows/update-cli-reference.yml b/.github/workflows/update-cli-reference.yml
new file mode 100644
index 000000000..9036937e7
--- /dev/null
+++ b/.github/workflows/update-cli-reference.yml
@@ -0,0 +1,71 @@
+name: Publish CLI reference to documentation
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish-to-docs:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Constellation
+        uses: actions/checkout@v3
+        with:
+          path: constellation
+
+      - name: Checkout docs
+        uses: actions/checkout@v3
+        with:
+          repository: edgelesssys/constellation-docs
+          token: ${{ secrets.CI_GITHUB_REPOSITORY }}
+          path: docs
+
+      - name: Set up Go
+        uses: actions/setup-go@v2
+        with:
+          go-version: 1.18
+
+      - name: Generate reference docs
+        run: |
+          cd constellation/hack/clidocgen
+          go build .
+          ./clidocgen > content.md
+          cat header.md content.md > ../../../cli.md
+
+      - 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 --git-dir=./docs/.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@v1.1.1
+        env:
+          API_TOKEN_GITHUB: ${{ secrets.CI_GITHUB_REPOSITORY }}
+        with:
+          source_file: 'cli.md'
+          destination_repo: 'edgelesssys/constellation-docs'
+          destination_branch_create: 'action/constellation/update-cli-reference'
+          destination_folder: '6c320851-bdd2-41d5-bf10-e27427398692/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@v1.1.1
+        env:
+          API_TOKEN_GITHUB: ${{ secrets.CI_GITHUB_REPOSITORY }}
+        with:
+          source_file: 'cli.md'
+          destination_repo: 'edgelesssys/constellation-docs'
+          destination_branch: 'action/constellation/update-cli-reference'
+          destination_folder: '6c320851-bdd2-41d5-bf10-e27427398692/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}}'
diff --git a/hack/clidocgen/header.md b/hack/clidocgen/header.md
new file mode 100644
index 000000000..0773dd0f4
--- /dev/null
+++ b/hack/clidocgen/header.md
@@ -0,0 +1,11 @@
+<!-- This file is generated by constellation/hack/clidocgen via update-cli-reference.yml workflow. Don't edit manually. -->
+
+# CLI reference
+
+Use the Constellation CLI to create and manage your clusters.
+
+Usage:
+
+```
+constellation [command]
+```