ci: simplify doc build using ansys/actions (#1262)

Co-authored-by: pyansys-ci-bot <pyansys.github.bot@ansys.com>

Author: RobPasMue

.github/workflows/ci_cd.yml

@@ -267,28 +267,9 @@ jobs:
       group: pyansys-self-hosted
       labels: [Windows, pygeometry]
     steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ env.MAIN_PYTHON_VERSION }}
-
       - name: Set up headless display
         uses: pyvista/setup-headless-display-action@v2
 
-      - name: Create Python venv
-        run: |
-          python -m venv .venv
-          .\.venv\Scripts\Activate.ps1
-
-      - name: Install packages for documentation build
-        run: |
-          .\.venv\Scripts\Activate.ps1
-          python -m pip install --upgrade pip
-          pip install --upgrade build wheel
-          pip install .[doc]
-
       - name: Login to GitHub Container Registry
         uses: docker/login-action@v3
         with:
@@ -304,43 +285,14 @@ jobs:
         run:
           echo "ANSRV_GEO_LICENSE_SERVER=${{ secrets.INTERNAL_LICENSE_SERVER }}" | Out-File -FilePath $env:GITHUB_ENV -Append
 
-      - name: Start Geometry service and verify start
-        run: |
-          .\.venv\Scripts\Activate.ps1
-          docker run --detach --name ${{ env.GEO_CONT_NAME }} -e LICENSE_SERVER=${{ env.ANSRV_GEO_LICENSE_SERVER }} -p ${{ env.ANSRV_GEO_PORT }}:50051 ${{ env.ANSRV_GEO_IMAGE_WINDOWS_TAG }}
-          python -c "from ansys.geometry.core.connection.validate import validate; validate()"
-
-      - name: Build the documentation (HTML)
-        run: |
-          .\.venv\Scripts\Activate.ps1
-          cd doc
-          .\make.bat html
-
-      - name: Build the documentation (PDF)
-        run: |
-          .\.venv\Scripts\Activate.ps1
-          cd doc
-          .\make.bat pdf
-
-      - name: Add assets to HTML docs
-        run: |
-          zip -r documentation-html.zip .\doc\_build\html
-          mv documentation-html.zip .\doc\_build\html\_static\assets\download\
-          cp doc/_build/latex/ansys-geometry-core.pdf .\doc\_build\html\_static\assets\download\
+      - name: Start Geometry service
+        run: docker run --detach --name ${{ env.GEO_CONT_NAME }} -e LICENSE_SERVER=${{ env.ANSRV_GEO_LICENSE_SERVER }} -p ${{ env.ANSRV_GEO_PORT }}:50051 ${{ env.ANSRV_GEO_IMAGE_WINDOWS_TAG }}
 
-      - name: Upload HTML documentation
-        uses: actions/upload-artifact@v4
+      - name: Run Ansys documentation building action
+        uses: ansys/actions/doc-build@v6
         with:
-          name: documentation-html
-          path: doc/_build/html
-          retention-days: 7
-
-      - name: Upload PDF documentation
-        uses: actions/upload-artifact@v4
-        with:
-          name: documentation-pdf
-          path: doc/_build/latex/ansys-geometry-core*.pdf
-          retention-days: 7
+          python-version: ${{ env.MAIN_PYTHON_VERSION }}
+          add-pdf-html-docs-as-assets: true
 
       - name: Stop the Geometry service
         if: always()

doc/changelog.d/1262.changed.md

@@ -0,0 +1 @@
+ci: simplify doc build using ansys/actions