feat(ci-cd): add sync-docs action (#180)

to automatically raise pull request on arc-docs for any documentation updates

GH-179

.github/workflows/sync-docs.yaml

@@ -0,0 +1,91 @@
+name: Sync Docs
+
+on:
+  workflow_dispatch:
+    inputs:
+      targetRepo:
+        type: string
+        description: Target Repository in `owner/repo-name` format
+        default: sourcefuse/arc-docs
+        required: true
+      branchPrefix:
+        type: string
+        description: Branch Prefix (repo name will be appended automatically)
+        default: automated-docs-sync/
+        required: true
+
+env:
+  GITHUB_TOKEN: ${{secrets.ARC_DOCS_API_TOKEN_GITHUB}}
+
+jobs:
+  sync-readme:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Extension Code
+        uses: actions/checkout@v3
+        with:
+          token: ${{env.GITHUB_TOKEN}}
+          path: './extension/'
+
+      - name: Checkout Docs Repository
+        uses: actions/checkout@v3
+        with:
+          token: ${{env.GITHUB_TOKEN}}
+          repository: ${{github.event.inputs.targetRepo}}
+          path: './arc-docs/'
+
+      - name: Configure GIT
+        id: configure_git
+        working-directory: arc-docs
+        run: |
+          git config --global user.email $CONFIG_EMAIL
+          git config --global user.name $CONFIG_USERNAME
+
+          extension_branch="${{github.event.inputs.branchPrefix}}$(basename $GITHUB_REPOSITORY)"
+          echo "extension_branch=$extension_branch" >> $GITHUB_OUTPUT
+        env:
+          CONFIG_USERNAME: ${{ vars.DOCS_PR_USERNAME }}
+          CONFIG_EMAIL: ${{ vars.DOCS_PR_EMAIL }}
+
+      - name: Sync Docs and Commit
+        id: sync_and_commit
+        working-directory: arc-docs
+        run: |
+          extension_branch="${{ steps.configure_git.outputs.extension_branch }}"
+
+          # Create a new branch if it doesn't exist, or switch to it if it does
+          git checkout -B $extension_branch || git checkout $extension_branch
+
+          # Copy README from the extension repo
+          cp ../extension/README.md docs/arc-api-docs/extensions/$(basename $GITHUB_REPOSITORY)/
+
+          # Commit
+          git add .
+          git commit -m "sync $(basename $GITHUB_REPOSITORY) docs"
+
+      - name: Push Changes
+        id: push_branch
+        working-directory: arc-docs
+        run: |
+          extension_branch="${{ steps.configure_git.outputs.extension_branch }}"
+          git push https://oauth2:${GITHUB_TOKEN}@github.com/${{github.event.inputs.targetRepo}}.git HEAD:$extension_branch --force
+
+      - name: Check PR Status
+        id: pr_status
+        working-directory: arc-docs
+        run: |
+          extension_branch="${{ steps.configure_git.outputs.extension_branch }}"
+          gh pr status --json headRefName >> "${{github.workspace}}/pr-status.json"
+          pr_exists="$(jq --arg extension_branch "$extension_branch" '.createdBy[].headRefName == $extension_branch' "${{github.workspace}}/pr-status.json")"
+          echo "PR Exists: $pr_exists"
+          echo "pr_exists=$pr_exists" >> $GITHUB_OUTPUT
+
+      - name: Create Pull Request
+        id: create_pull_request
+        if: steps.pr_status.outputs.pr_exists != 'true'
+        working-directory: arc-docs
+        run: |
+          extension_branch="${{ steps.configure_git.outputs.extension_branch }}"
+
+          gh pr create --head $(git branch --show-current) --title "Sync ${{ github.event.repository.name }} Docs" --body "This Pull Request has been created by the 'sync-docs' action within the '${{ github.event.repository.name }}' repository, with the purpose of updating markdown files."