PI-2374: Add deployment stage to publishing workflow

Author: mxco86

.github/workflows/publish-docs.yml

@@ -22,20 +22,43 @@ jobs:
           timeout 300 sh -c 'until curl -s localhost:8080/v3/api-docs; do sleep 5; done'
         env:
           SPRING_PROFILES_ACTIVE: local
+      - name: Bundle OpenAPI specs
+        run: |
+          mkdir openapi
+          curl -sf localhost:8080/v3/api-docs -o openapi/api-docs.json
+        working-directory: .
+      - name: Deploy OpenAPI
+        uses: JamesIves/github-pages-deploy-action@920cbb300dcd3f0568dbc42700c61e2fd9e6139c # v4.6.4
+        with:
+          folder: openapi
+          target-folder: openapi
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: 3.1
           bundler-cache: true
           working-directory: tech-docs
-      - name: Build
+      - name: Build Docs
         run: |
           gem install middleman
           bundle exec middleman build --verbose
         working-directory: tech-docs
-      - name: Bundle OpenAPI specs
-        run: |
-          curl -sf localhost:8080/v3/api-docs -o api-docs.json
-        working-directory: tech-docs/build
       - uses: actions/upload-artifact@v4
         with:
-          path: tech-docs/build
+          name: documentation
+          path: tech-docs/build/
+
+  deploy:
+    runs-on: ubuntu-latest
+    if: github.ref_name == 'main' || (github.event_name == 'workflow_dispatch')
+    needs:
+      - build
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: documentation
+          path: tech-docs-build
+      - name: Deploy
+        uses: JamesIves/github-pages-deploy-action@920cbb300dcd3f0568dbc42700c61e2fd9e6139c # v4.6.4
+        with:
+          folder: tech-docs-build