chore(ci): split latest docs workflow

Author: heitorlessa

.github/workflows/publish.yml

@@ -33,23 +33,12 @@ name: Publish to PyPi
 #
 # === Documentation hotfix ===
 #
-# 1. Trigger "Publish to PyPi" workflow manually: https://docs.github.com/en/actions/managing-workflow-runs/manually-running-a-workflow
-# 2. Use the latest version released under Releases e.g. v1.21.1
-# 3. Set `Build and publish docs only` field to `true`
+# Look for rebuild latest docs workflow
 
 
 on:
   release:
     types: [published]
-  workflow_dispatch:
-    inputs:
-      publish_version:
-        description: 'Version to publish, e.g. v1.13.0'
-        required: true
-      publish_docs_only:
-        description: 'Build and publish docs only'
-        required: false
-        default: 'false'
 
 jobs:
   release:
@@ -65,40 +54,33 @@ jobs:
     - name: Set release notes tag
       run: |
         RELEASE_TAG_VERSION=${{ github.event.release.tag_name }}
-        # Replace publishing version if the workflow was triggered manually
-        # test -n ${RELEASE_TAG_VERSION} && RELEASE_TAG_VERSION=${{ github.event.inputs.publish_version }}
         echo "RELEASE_TAG_VERSION=${RELEASE_TAG_VERSION:1}" >> $GITHUB_ENV
     - name: Ensure new version is also set in pyproject and CHANGELOG
-      if: ${{ github.event.inputs.publish_docs_only == false }}
       run: |
         grep --regexp "${RELEASE_TAG_VERSION}" CHANGELOG.md
         grep --regexp "version \= \"${RELEASE_TAG_VERSION}\"" pyproject.toml
     - name: Install dependencies
       run: make dev
     - name: Run all tests, linting and baselines
-      if: ${{ github.event.inputs.publish_docs_only == false }}
       run: make pr
     - name: Build python package and wheel
-      if: ${{ github.event.inputs.publish_docs_only == false }}
       run: poetry build
     - name: Upload to PyPi test
-      if: ${{ github.event.inputs.publish_docs_only == false }}
       run: make release-test
       env:
         PYPI_USERNAME: __token__
         PYPI_TEST_TOKEN: ${{ secrets.PYPI_TEST_TOKEN }}
     - name: Upload to PyPi prod
-      if: ${{ github.event.inputs.publish_docs_only == false }}
       run: make release-prod
       env:
         PYPI_USERNAME: __token__
         PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
     - name: publish lambda layer in SAR by triggering the internal codepipeline
-      if: ${{ github.event.inputs.publish_docs_only == false }}
       run: |
         aws ssm put-parameter --name "powertools-python-release-version" --value $RELEASE_TAG_VERSION --overwrite
         aws codepipeline start-pipeline-execution --name ${{ secrets.CODEPIPELINE_NAME }}
       env:
+        # Maintenance: Migrate to new OAuth mechanism
         AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
         AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
         AWS_DEFAULT_REGION: eu-west-1
@@ -129,7 +111,6 @@ jobs:
   sync_master:
     needs: release
     runs-on: ubuntu-latest
-    if: ${{ github.event.inputs.publish_docs_only == false }}
     steps:
     - uses: actions/checkout@v2
     - name: Sync master from detached head

.github/workflows/rebuild_latest_docs.yml

@@ -0,0 +1,62 @@
+name: Rebuild latest docs
+
+#
+# === Documentation hotfix ===
+#
+# 1. Trigger "Rebuild latest docs" workflow manually: https://docs.github.com/en/actions/managing-workflow-runs/manually-running-a-workflow
+# 2. Use the latest version released under Releases e.g. v1.22.0
+# 3. Set `Build and publish docs only` field to `true`
+
+
+on:
+  workflow_dispatch:
+    inputs:
+      latest_published_version:
+        description: 'Latest PyPi published version to rebuild latest docs for, e.g. v1.22.0'
+        default: 'v1.22.0'
+        required: true
+
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        fetch-depth: 0
+    - name: Set up Python
+      uses: actions/setup-python@v2.2.2
+      with:
+        python-version: "3.8"
+    - name: Set release notes tag
+      run: |
+        RELEASE_TAG_VERSION=${{ github.event.inputs.latest_published_version }}
+        echo "RELEASE_TAG_VERSION=${RELEASE_TAG_VERSION:1}" >> $GITHUB_ENV
+    - name: Ensure new version is also set in pyproject and CHANGELOG
+      run: |
+        grep --regexp "${RELEASE_TAG_VERSION}" CHANGELOG.md
+        grep --regexp "version \= \"${RELEASE_TAG_VERSION}\"" pyproject.toml
+    - name: Install dependencies
+      run: make dev
+    - name: Setup doc deploy
+      run: |
+        git config --global user.name Docs deploy
+        git config --global user.email aws-devax-open-source@amazon.com
+    - name: Build docs website and API reference
+      run: |
+        make release-docs VERSION=${RELEASE_TAG_VERSION} ALIAS="latest"
+        poetry run mike set-default --push latest
+    - name: Release API docs to release version
+      uses: peaceiris/actions-gh-pages@v3
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: ./api
+        keep_files: true
+        destination_dir: ${{ env.RELEASE_TAG_VERSION }}/api
+    - name: Release API docs to latest
+      uses: peaceiris/actions-gh-pages@v3
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: ./api
+        keep_files: true
+        destination_dir: latest/api