docs: add workflow_dispatch for staged publishing

-Add manual trigger with publish to dev/prod inputs.
-Split Zoomin upload into separate dev and prod steps.

Signed-off-by: Konrad Grucel <konrad.grucel@nordicsemi.no>

Author: kg-nordicsemi

.github/workflows/doc_build.yml

@@ -17,6 +17,16 @@ on:
       - main
     tags:
       - v*
+  workflow_dispatch:
+    inputs:
+      publish_to_dev:
+        type: boolean
+        default: true
+        description: "Publish to dev (private) Zoomin"
+      publish_to_prod:
+        type: boolean
+        default: false
+        description: "Publish to prod (public) Zoomin"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -82,7 +92,7 @@ jobs:
           if [[ -f pr.txt ]]; then mv pr.txt "$PUBLISH"; fi
 
       - name: Prepare Zoomin upload
-        if: ${{ github.event_name == 'push' }}
+        if: ${{ github.event_name == 'push' || github.event_name == 'workflow_dispatch' }}
         run: |
           PUBLISH="$PWD/publish"
           mkdir -p "$PUBLISH"
@@ -101,6 +111,23 @@ jobs:
           mv "$ARCHIVE" "$PUBLISH"
           popd
 
+      - name: Save publish config
+        if: ${{ github.event_name == 'push' || github.event_name == 'workflow_dispatch' }}
+        run: |
+          PUBLISH="$PWD/publish"
+          mkdir -p "$PUBLISH"
+
+          if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
+            PUBLISH_TO_DEV="${{ inputs.publish_to_dev }}"
+            PUBLISH_TO_PROD="${{ inputs.publish_to_prod }}"
+          else
+            PUBLISH_TO_DEV="true"
+            PUBLISH_TO_PROD="true"
+          fi
+
+          echo "publish_to_dev=$PUBLISH_TO_DEV" > "$PUBLISH/publish_config.txt"
+          echo "publish_to_prod=$PUBLISH_TO_PROD" >> "$PUBLISH/publish_config.txt"
+
       - name: Store
         if: ${{ !contains(github.event.pull_request.labels.*.name, 'external') || contains(github.event.pull_request.labels.*.name, 'CI-trusted-author') }}
         uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0

.github/workflows/doc_publish.yml

@@ -52,28 +52,47 @@ jobs:
             azcopy cp $OUTDIR "${{ vars.NCS_DOC_STORAGE_URL }}addon-aliro?$NCS_DOC_SAS_MAIN" --recursive=true
           fi
 
-      - name: Upload Zoomin documentation
+      - name: Read publish config
+        id: config
+        run: |
+          if [ -f docs/publish_config.txt ]; then
+            cat docs/publish_config.txt >> "$GITHUB_OUTPUT"
+          else
+            echo "publish_to_dev=false" >> "$GITHUB_OUTPUT"
+            echo "publish_to_prod=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Prepare Zoomin key
         if: >
-          github.event.workflow_run.head_branch == 'main' &&
-          github.event.workflow_run.head_repository.full_name == github.repository
+          steps.config.outputs.publish_to_dev == 'true' ||
+          steps.config.outputs.publish_to_prod == 'true'
         env:
           NCS_ZOOMIN_KEY: ${{ secrets.NCS_ZOOMIN_KEY }}
         run: |
-          # trust server
           mkdir -p ~/.ssh
           ssh-keyscan ${{ vars.NCS_ZOOMIN_SERVER }} >> ~/.ssh/known_hosts
 
-          # prepare key
           touch zoomin_key
           chmod 600 zoomin_key
           echo "$NCS_ZOOMIN_KEY" | base64 -d > zoomin_key
 
-          # upload files
+      - name: Upload Zoomin documentation (dev)
+        if: ${{ steps.config.outputs.publish_to_dev == 'true' }}
+        run: |
           for file in docs/addon-aliro*.zip; do
             sftp -v -i zoomin_key ${{ vars.NCS_ZOOMIN_USER }}@${{ vars.NCS_ZOOMIN_SERVER }} <<EOF
-              cd docs-be.nordicsemi.com/sphinx-html/incoming
+              cd nordic-be-dev.zoominsoftware.io/sphinx-html/incoming
               put ${file}
-              cd ../../../nordic-be-dev.zoominsoftware.io/sphinx-html/incoming
+              quit
+          EOF
+          done
+
+      - name: Upload Zoomin documentation (prod)
+        if: ${{ steps.config.outputs.publish_to_prod == 'true' }}
+        run: |
+          for file in docs/addon-aliro*.zip; do
+            sftp -v -i zoomin_key ${{ vars.NCS_ZOOMIN_USER }}@${{ vars.NCS_ZOOMIN_SERVER }} <<EOF
+              cd docs-be.nordicsemi.com/sphinx-html/incoming
               put ${file}
               quit
           EOF