Fix release workflow (#228)

- remove docs updates and release step from cpack.yml workflow
- create docs.yml workflow
- create release.yml workflow
- update source/docs/environment.yml
- add status badge for documentation

[ROCm/rocprofiler-systems commit: 12001d9633]

projects/rocprofiler-systems/.github/workflows/cpack.yml

@@ -19,64 +19,6 @@ env:
   GIT_DISCOVERY_ACROSS_FILESYSTEM: 1
 
 jobs:
-  release:
-    if: github.repository == 'AMDResearch/omnitrace' && startsWith(github.ref, 'refs/tags/')
-    runs-on: ubuntu-20.04
-    permissions:
-      contents: write
-      packages: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: Generate generic installer script
-        shell: bash
-        run: |
-          apt-get update
-          apt-get install -y cmake
-          cmake -D OUTPUT_DIR=${PWD} -P scripts/write-omnitrace-install.cmake
-      - name: Generate Release
-        uses: softprops/action-gh-release@v1
-        with:
-          draft: False
-          generate_release_notes: True
-          fail_on_unmatched_files: True
-          files: |
-            omnitrace-install.py
-
-  release-docs:
-    if: github.repository == 'AMDResearch/omnitrace' && (startsWith(github.ref, 'refs/tags/') || contains(github.ref, 'releases/'))
-    runs-on: ubuntu-20.04
-    permissions:
-      contents: write
-      packages: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: Update Source
-        run: |
-          git config --global user.name 'Jonathan R. Madsen'
-          git config --global user.email 'jrmadsen@users.noreply.github.com'
-          git config --global pull.rebase true
-          git remote set-url origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}
-          git fetch origin
-          git checkout gh-pages
-          git pull origin main
-      - name: Install Conda
-        uses: s-weigand/setup-conda@v1
-      - name: Update Docs
-        working-directory: source/docs
-        run: |
-          conda env create -n omnitrace-docs -f environment.yml
-          source activate
-          conda activate omnitrace-docs
-          ./update-docs.sh
-      - name: Push changes
-        if: github.repository == 'AMDResearch/omnitrace' && startsWith(github.ref, 'refs/tags/')
-        run: |
-          git add docs
-          git commit -m "Update HTML (automated)"
-          git push -f
-
   installers:
     if: github.repository == 'AMDResearch/omnitrace'
     runs-on: ubuntu-20.04

projects/rocprofiler-systems/.github/workflows/docs.yml

@@ -0,0 +1,70 @@
+name: Documentation
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main, gh-pages]
+    paths:
+      - '*.md'
+      - 'source/docs/**'
+      - '.github/workflows/docs.yml'
+      - 'VERSION'
+  pull_request:
+    branches: [main]
+    paths:
+      - '*.md'
+      - 'source/docs/**'
+      - '.github/workflows/docs.yml'
+      - 'VERSION'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  GIT_DISCOVERY_ACROSS_FILESYSTEM: 1
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-20.04
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: Install Conda
+        uses: s-weigand/setup-conda@v1
+      - name: Setup Pages
+        uses: actions/configure-pages@v2
+      - name: Create Docs Directory
+        run:
+          mkdir -p docs
+      - name: Update Docs
+        working-directory: source/docs
+        run: |
+          conda env create -n omnitrace-docs -f environment.yml
+          source activate
+          conda activate omnitrace-docs
+          ./update-docs.sh
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          path: ./docs
+
+  deploy-docs:
+    if: github.repository == 'AMDResearch/omnitrace' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/gh-pages')
+    runs-on: ubuntu-20.04
+    needs: build-docs
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1

projects/rocprofiler-systems/.github/workflows/release.yml

@@ -0,0 +1,39 @@
+name: Release
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - v*
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  GIT_DISCOVERY_ACROSS_FILESYSTEM: 1
+
+jobs:
+  release:
+    if: github.repository == 'AMDResearch/omnitrace'
+    runs-on: ubuntu-20.04
+    permissions:
+      contents: write
+      packages: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: Generate generic installer script
+        shell: bash
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake
+          cmake -D OUTPUT_DIR=${PWD} -P scripts/write-omnitrace-install.cmake
+      - name: Generate Release
+        uses: softprops/action-gh-release@v1
+        with:
+          draft: False
+          generate_release_notes: True
+          fail_on_unmatched_files: True
+          files: |
+            omnitrace-install.py