🦙 Update rules to use gatsby-plugin-mdx

.github/workflows/pr-build-deploy-tina.yml

@@ -0,0 +1,30 @@
+name: PR - Build and Deploy Tina
+
+
+on: 
+    pull_request:
+        branches:
+            - tina/main
+    workflow_dispatch:
+
+jobs:
+  build:
+    name: Build
+    uses: ./.github/workflows/template-build-mdx.yml
+    with:
+      branch_name: tina/call-mdx
+      environment: staging
+      should_generate_commit_data: false 
+    secrets: inherit
+
+  deploy:
+    concurrency:
+      group: tina-deploy
+      cancel-in-progress: false
+    needs: build
+    name: Deploy
+    uses: ./.github/workflows/template-deploy-mdx.yml
+    with:
+      environment: staging
+      storageAccountName: tinamdx
+    secrets: inherit

.github/workflows/template-build-mdx.yml

@@ -0,0 +1,206 @@
+name: Template - Build site (MDX)
+
+on:
+  workflow_call:
+    inputs:
+      branch_name:
+        required: true
+        type: string
+      environment:
+        type: string
+        required: true
+        description: 'The environment to build for'
+      should_generate_commit_data:
+        type: boolean
+        description: 'Generate commit data for rules history. You might want to skip this on large rules changes.'
+        required: false
+        default: true
+
+jobs:
+  get-content-commit-data:
+    name: Generate commit data
+    runs-on: ubuntu-latest
+    environment: ${{ inputs.environment }}
+    steps:
+
+      - uses: actions/checkout@v4
+        name: Checkout SSW.Rules
+        with:
+          path: SSW.Rules
+          ref: ${{ inputs.branch_name }}
+          sparse-checkout: |
+            build-scripts
+          fetch-depth: 1
+
+      - uses: actions/checkout@v4
+        name: Checkout SSW.Rules.Content
+        with:
+          repository: SSWConsulting/SSW.Rules.Content
+          path: SSW.Rules.Content
+          ref: main
+          fetch-depth: 0
+
+      - name: Record the latest SHA for the content repo
+        working-directory: SSW.Rules.Content
+        run: |
+          echo '### Content repo info! 🚀' >> $GITHUB_STEP_SUMMARY
+          echo "Latest SHA: [$(git rev-parse HEAD)](https://github.com/SSWConsulting/SSW.Rules.Content/commit/$(git rev-parse HEAD))" >> $GITHUB_STEP_SUMMARY
+
+
+      - name: Get Rule History Commits
+        shell: pwsh
+        run: |
+          ./SSW.Rules/build-scripts/update-rule-history.ps1 `
+            -AzFunctionBaseUrl ${{ vars.AzFunctionBaseUrl }} `
+            -GetHistorySyncCommitHashKey ${{ secrets.GETHISTORYSYNCCOMMITHASHFUNCTIONKEY }} `
+            -UpdateRuleHistoryKey ${{ secrets.UPDATERULEHISTORYFUNCTIONKEY }} `
+            -UpdateHistorySyncCommitHashKey ${{ secrets.UPDATEHISTORYSYNCCOMMITHASHFUNCTIONKEY }} `
+            -ShouldGenerateHistory ${{ inputs.should_generate_commit_data }}
+
+      - name: Get Rule History JSON
+        shell: pwsh
+        run: |
+          mkdir static
+          ./SSW.Rules/build-scripts/get-rule-history.ps1 `
+            -AzFunctionBaseUrl ${{ vars.AzFunctionBaseUrl }} `
+            -GenerateHistoryFileFunctionKey ${{ secrets.GenerateHistoryFileFunctionKey }} `
+            -outputFileName ${{ github.workspace }}/static/history.json
+
+      - name: Get History Commits of Each Contributor
+        shell: pwsh
+        run: |
+          ./SSW.Rules/build-scripts/create-commits-history.ps1 `
+            -Token ${{ secrets.GITHUB_TOKEN }} `
+            -GithubOrg ${{ github.repository_owner }} `
+            -GithubRepo SSW.Rules.Content `
+            -outputFileName ${{ github.workspace }}/static/commits.json
+        env:
+          GH_TOKEN: ${{ github.token }}
+
+      - name: Archive artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: commit-data
+          path: static
+          retention-days: 1
+
+  build-code:
+    name: Gatsby
+    runs-on: ubuntu-latest
+    needs: get-content-commit-data
+    environment: ${{ inputs.environment }}
+    steps:
+
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.branch_name }}
+
+      - name: Download commit data artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: commit-data
+          path: commit-data
+
+      - name: Move commit data
+        run: mv commit-data/* static/
+
+      - uses: cschleiden/replace-tokens@v1
+        with:
+          tokenPrefix: '#{'
+          tokenSuffix: '}'
+          files: .env.template*
+        env:
+          GOOGLE_ANALYTICS: ${{ vars.GOOGLE_ANALYTICS }}
+          DEPLOYMENT_URL: https://github.com/SSWConsulting/SSW.Rules/actions/workflows/build-deploy-production.yml
+          VERSION_DEPLOYED: ${{ github.run_number }}
+          APPINSIGHTS_INSTRUMENTATIONKEY: ${{ secrets.APPINSIGHTS_INSTRUMENTATIONKEY }}
+          #TODO: https://github.com/SSWConsulting/SSW.Rules/issues/1528
+          CONTENT_BRANCH: main-with-tina-lock
+          TINA_CONTENT_BRANCH: main-with-tina-lock
+          API_BASE_URL: ${{ vars.AZFUNCTIONBASEURL }}
+          AUTH0_DOMAIN: ${{ vars.AUTH0_DOMAIN }}
+          AUTH0_CLIENT_ID: ${{ vars.AUTH0_CLIENT_ID }}
+          AUTH0_REDIRECT_URI: ${{ vars.AUTH0_REDIRECT_URI }}
+          AUTH0_SCOPE: ${{ vars.AUTH0_SCOPE }}
+          GITHUB_API_PAT: ${{ secrets.CONTENT_GITHUB_TOKEN }}
+          DISQUS_FORUM: ${{ vars.DISQUS_FORUM }}
+          DISQUS_API_KEY: ${{ secrets.DISQUS_API_KEY }}
+          GTM_CONTAINER_ID: ${{ vars.GTM_CONTAINER_ID }}
+          GITHUB_ORG: ${{ github.repository_owner }}
+          GITHUB_REPO: SSW.Rules.Content
+          GATSBY_ALGOLIA_APP_ID: ${{ vars.GATSBY_ALGOLIA_APP_ID }}
+          GATSBY_ALGOLIA_SEARCH_KEY: ${{ secrets.GATSBY_ALGOLIA_SEARCH_KEY }}
+          ALGOLIA_ADMIN_KEY: ${{ secrets.ALGOLIA_ADMIN_KEY }}
+          TINA_CLIENT_ID: ${{ secrets.TINA_CLIENT_ID }}
+          TINA_TOKEN: ${{ secrets.TINA_TOKEN }}
+          TINA_BASE_PATH: ${{ vars.TINA_BASE_PATH }}
+
+      - name: Rename env file
+        run: |
+          mv .env.template .env.production
+          cat .env.production
+
+      # TinaCMS requires the .env file to be named .env
+      - name: Rename env tina file
+        run: |
+          mv .env.template_tina .env
+          cat .env
+
+      # - name: Cache Gatsby .cache
+      #   uses: actions/cache@v4
+      #   with:
+      #     path: .cache
+      #     key: gatsby_cache | ${{ runner.os }}
+      #     restore-keys: |
+      #       gatsby_cache | ${{ runner.os }}
+
+      # - name: Cache Gatsby public
+      #   uses: actions/cache@v4
+      #   with:
+      #     path: public
+      #     key: gatsby_public | ${{ runner.os }}
+      #     restore-keys: |
+      #       gatsby_public | ${{ runner.os }}
+
+      - name: Use Node
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --immutable
+
+      - name: Build
+        run: yarn build
+        env:
+          GATSBY_EXPERIMENTAL_PAGE_BUILD_ON_DATA_CHANGES: true
+        timeout-minutes: 60
+
+      - name: Archive artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: build
+          path: public
+
+  build-infra:
+    name: Infra
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.branch_name }}
+          sparse-checkout: |
+            infra
+
+      - name: Check the result
+        shell: bash
+        run: |
+          mkdir arm
+          az bicep build --file infra/main.bicep --outdir arm
+
+      - name: Archive artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: infra
+          path: infra

.github/workflows/template-deploy-mdx.yml

@@ -0,0 +1,111 @@
+name: Template - deploy site (MDX)
+
+on:
+  workflow_call:
+    inputs:
+      environment:
+        type: string
+        required: true
+        description: 'The environment to deploy to'
+      storageAccountName:
+        type: string
+        required: false
+        description: 'A custom appendage for the storage account name'
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  deploy-infra:
+    name: Infra
+    runs-on: ubuntu-latest
+    environment: ${{ inputs.environment }}
+    env:
+      sha: ${{ github.sha }}
+    outputs:
+      storageAccountName: ${{ steps.deploy.outputs.storageAccountName }}
+      staticWebsiteUrl: ${{ steps.deploy.outputs.staticWebsiteUrl }}
+    steps:
+      - name: Download infra artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: infra
+          path: infra
+
+      - name: Azure Login
+        uses: azure/login@v2
+        with:
+          client-id: ${{ secrets.AZURE_CLIENT_ID }}
+          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
+          subscription-id: ${{ secrets.CALEB_MPN_SUBSCRIPTION_ID }}
+
+      - name: Generate SHA
+        run: echo "sha=${GITHUB_SHA:0:7}" >> $GITHUB_ENV
+        env:
+          GITHUB_SHA: ${{ github.sha }}
+
+      - name: Deploy infra
+        run: |
+          az deployment group create \
+            --name ${{ env.sha }} \
+            --resource-group ${{ secrets.AZURE_RESOURCE_GROUP }} \
+            --template-file infra/main.bicep \
+            --parameters \
+              customStorageAccountNames=${{ inputs.storageAccountName }}\
+              environmentName=${{ inputs.environment }} \
+            --mode Incremental
+
+      - name: Get deployment outputs
+        id: deploy
+        run: |
+          STORAGE_ACCOUNT_NAME=$(az deployment group show --name ${{ env.sha }} --resource-group ${{ secrets.AZURE_RESOURCE_GROUP }} --query properties.outputs.storageAccountName.value -o tsv)
+          echo "Storage Account Name: $STORAGE_ACCOUNT_NAME"
+
+          STATIC_WEBSITE_URL=$(az storage account show --name $STORAGE_ACCOUNT_NAME --query primaryEndpoints.web -o tsv)
+          echo "Static Website URL: $STATIC_WEBSITE_URL"
+
+          echo "storageAccountName=$STORAGE_ACCOUNT_NAME" >> $GITHUB_OUTPUT
+          echo "staticWebsiteUrl=$STATIC_WEBSITE_URL" >> $GITHUB_OUTPUT
+
+  deploy:
+    name: Site
+    needs: deploy-infra
+    runs-on: ubuntu-latest
+    environment: 
+      name: ${{ inputs.environment }}
+      url: ${{ needs.deploy-infra.outputs.staticWebsiteUrl }}/rules
+    steps:
+      - name: Download code artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: build
+          path: rules
+
+      - name: Azure Login
+        uses: azure/login@v2
+        with:
+          client-id: ${{ secrets.AZURE_CLIENT_ID }}
+          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
+          subscription-id: ${{ secrets.CALEB_MPN_SUBSCRIPTION_ID }}
+
+      - name: Upload files to Azure storage
+        run: |
+          sas=$(az storage account generate-sas \
+            --account-name ${{ needs.deploy-infra.outputs.storageAccountName }} \
+            --expiry $(date -d "tomorrow" +%Y-%m-%d) \
+            --permissions acdlrw \
+            --resource-types sco \
+            --services b \
+            --https-only \
+            --output tsv \
+          )
+          azcopy sync \
+            ${{ github.workspace }} \
+            "https://${{ needs.deploy-infra.outputs.storageAccountName }}.blob.core.windows.net/\$web/?$sas" \
+            --log-level="ERROR" \
+            --compare-hash=MD5 --put-md5 --delete-destination=true
+        env:
+          AZCOPY_CONCURRENCY_VALUE: 256
+          AZCOPY_PARALLEL_STAT_FILES: true
+          AZCOPY_CONCURRENT_SCAN: 256