Merge branch 'main' into main

Author: cjain-f5

.github/workflows/coveo.yml

@@ -8,6 +8,9 @@ jobs:
   generate-coveo-search-token:
     name: Generate Coveo Search Tokens
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      actions: read # for 8398a7/action-slack
     strategy:
       matrix:
         include:
@@ -25,6 +28,8 @@ jobs:
         run: sudo apt-get install jq
 
       - name: Generating token for ${{matrix.env_name}} ...
+        id: generate-token
+        continue-on-error: true
         env:
           COVEO_API_KEY: ${{secrets[matrix.env_api_key]}}
           COVEO_SEARCH_HUB: "HUB_ES_Nginx_Docs_And_Org"
@@ -61,13 +66,37 @@ jobs:
           echo "{\"token\": \"$SEARCH_TOKEN\", \"org_id\": \"${{matrix.env_coveo_org_id}}\"}" > coveo/search_token.json
 
       - name: Upload token for ${{matrix.env_name}}
+        if: ${{ steps.generate-token.outcome == 'success' }}
         uses: actions/upload-artifact@v4
         with:
           name: ${{matrix.env_name}}
           path: "./"
 
+      - name: Send a notification if token generation step failed
+        if: ${{ steps.generate-token.outcome == 'failure' }}
+        uses: 8398a7/action-slack@77eaa4f1c608a7d68b38af4e3f739dcd8cba273e # v3.19.0
+        with: 
+          status: custom
+          custom_payload: |
+            {
+                username: 'Github',
+                mention: 'channel',
+                attachments: [{
+                  title: '[${{ github.event.repository.full_name }}] Coveo Token Generation Failed (${{matrix.env_name}} environment)',
+                  color: 'danger',
+                  fields: [{
+                    title: 'Pipeline URL',
+                    value: '<https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}|${{ github.run_id }}>',
+                    short: false
+                  }]
+                }]
+            }
+        env:
+          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL_DOCS_INCIDENT }}
+          
+
   push-tokens-to-azure:
-    name: Push coveo search tokens to Azure
+    name: Batch push coveo search tokens to Azure
     runs-on: ubuntu-latest
     needs: generate-coveo-search-token
     steps:

.github/workflows/stale-branches.yml

@@ -0,0 +1,41 @@
+name: Prune stale branches
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '30 1 * * *' # run every day at 01:30 UTC
+
+jobs:
+  stale-branches:
+    runs-on: ubuntu-latest
+    env:
+      ORG: nginx
+      REPO: documentation
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    permissions:
+      contents: write
+    steps:
+      - name: Prune all stale branches
+        run: |
+            HAS_MORE="true"
+
+            while [ "$HAS_MORE" == "true" ]; do
+              RESPONSE=$(curl -L -s \
+              -X GET \
+              -H "Accept: application/json" \
+              -s "https://github.com/${{env.ORG}}/${{env.REPO}}/branches/stale")
+
+              HAS_MORE=$(echo "$RESPONSE" | jq -r '.payload.has_more')
+              BRANCHES=$(echo "$RESPONSE" | jq -r '.payload.branches[].name')
+
+              for BRANCH in $BRANCHES; do
+                echo "Deleting branch $BRANCH..."
+                DELETE_RESPONSE=$(curl -L -s \
+                  -X DELETE \
+                  -H "Accept: application/vnd.github+json" \
+                  -H "Authorization: Bearer ${{env.GITHUB_TOKEN}}" \
+                  -H "X-GitHub-Api-Version: 2022-11-28" \
+                  https://api.github.com/repos/${{env.ORG}}/${{env.REPO}}/git/refs/heads/$BRANCH)
+                echo "Delete response for branch $BRANCH: $DELETE_RESPONSE"
+              done
+            done
+

_banners/waf-parameter-reference.md

@@ -0,0 +1,7 @@
+{{< banner "note" "Policy parameter reference" >}}
+
+You can explore the parameters for each F5 WAF for NGINX feature on the [Policy parameter reference]({{< ref "/waf/policies/parameter-reference.md" >}}) page.
+
+This page was previously referred to as the "Declarative Policy".
+
+{{< /banner >}}

content/_index.md

@@ -43,7 +43,7 @@ Learn how to deliver, manage, and protect your applications using F5 NGINX produ
 {{</card-section>}}
 
 {{<card-section showAsCards="true" title="F5 NGINX as a Service">}}
-  {{<card title="F5 NGINXaaS for Azure" titleUrl="/nginxaas/azure/" brandIcon="NGINX-for-Azure-product-icon.svg" isLanding="true">}}
+  {{<card title="F5 NGINXaaS for Azure" titleUrl="/nginxaas/azure/" brandIcon="F5-NGINXaaS-icon.svg" isLanding="true">}}
     Infrastructure-as-a-Service (IaaS) version of NGINX Plus for your Microsoft Azure application stack.
   {{</card >}}
 {{</card-section>}}