chore(ci): attempt gh-pages deployment via beta route

Author: heitorlessa

.github/workflows/reusable_publish_docs.yml

@@ -24,6 +24,7 @@ on:
 permissions:
   contents: write
   pages: write
+  id-token: write
 
 jobs:
   publish_docs:
@@ -63,21 +64,48 @@ jobs:
         run: |
           make release-docs VERSION="$VERSION" ALIAS="$ALIAS"
           poetry run mike set-default --push latest
-      # Maintenance: Migrate to new gh-pages action
-      - name: Release API docs
-        uses: peaceiris/actions-gh-pages@de7ea6f8efb354206b205ef54722213d99067935 # v3.9.0
-        env:
-          VERSION: ${{ inputs.version }}
+
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v2
+      - name: Upload latest API docs
+        uses: actions/upload-pages-artifact@v1
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./api
-          keep_files: true
-          destination_dir: ${{ env.VERSION }}/api
-      - name: Release API docs to latest
-        if: ${{ inputs.alias == 'latest' }}
-        uses: peaceiris/actions-gh-pages@de7ea6f8efb354206b205ef54722213d99067935 # v3.9.0
+          path: ./api
+      - name: Upload versioned API docs
+        uses: actions/upload-pages-artifact@v1
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./api
-          keep_files: true
-          destination_dir: latest/api
+          path: ${{ env.VERSION }}/api
+
+  # Deployment job
+  deploy:
+    concurrency:
+      group: on-docs-deploy
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: publish_docs
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1
+
+      # Maintenance: Migrate to new gh-pages action
+      # - name: Release API docs
+      #   uses: peaceiris/actions-gh-pages@de7ea6f8efb354206b205ef54722213d99067935 # v3.9.0
+      #   env:
+      #     VERSION: ${{ inputs.version }}
+      #   with:
+      #     github_token: ${{ secrets.GITHUB_TOKEN }}
+      #     publish_dir: ./api
+      #     keep_files: true
+      #     destination_dir: ${{ env.VERSION }}/api
+      # - name: Release API docs to latest
+      #   if: ${{ inputs.alias == 'latest' }}
+      #   uses: peaceiris/actions-gh-pages@de7ea6f8efb354206b205ef54722213d99067935 # v3.9.0
+      #   with:
+      #     github_token: ${{ secrets.GITHUB_TOKEN }}
+      #     publish_dir: ./api
+      #     keep_files: true
+      #     destination_dir: latest/api