docs-build-push.yml

name: Build and deploy documentation
on:
  workflow_dispatch:
    inputs:
      environment:
        description: 'Environment to deploy to'
        required: true
        default: 'preview'
        type: choice
        options:
        - preview
        - dev
        - staging
        - prod
      hugo_theme_override:
        description: "Hugo theme version (Leave blank for latest)"
        required: false
        default: ""
        type: string
  pull_request:
    branches:
    - "*"
    paths:
    - "site/**"

  push:
    branches:
    - release-1.5
    paths:
    - "site/**"

concurrency:
  group: ${{ github.ref_name }}-docs-push
  cancel-in-progress: true

permissions:
  contents: read

jobs:
  vars:
    runs-on: ubuntu-24.04
    outputs:
      azure_creds: ${{ steps.vars.outputs.defined }}
    steps:
    - name: Check if variable is set
      id: vars
      env:
        AZURE_CREDENTIALS: ${{ secrets.AZURE_CREDENTIALS_DOCS }}
      if: "${{ env.AZURE_CREDENTIALS != '' }}"
      run: echo "defined=true" >> $GITHUB_OUTPUT

  call-docs-build-push:
    needs: [vars]
    if: ${{ github.event.repository.fork == false && needs.vars.outputs.azure_creds == 'true' }}
    uses: nginxinc/docs-actions/.github/workflows/docs-build-push.yml@9c59fab05a8131f4d691ba6ea2b6a119f3ef832a # v1.0.7
    permissions:
      pull-requests: write # Required to add the preview URL comment
      contents: read
    with:
      production_url_path: "/nginx-gateway-fabric"
      preview_url_path: "/previews/nginx-gateway-fabric"
      docs_source_path: "public/nginx-gateway-fabric"
      docs_build_path: "./site"
      doc_type: "hugo"
      environment: ${{ inputs.environment }}
      force_hugo_theme_version: ${{ inputs.hugo_theme_override }}
      auto_deploy_branch: "release-1.5"
      auto_deploy_env: "prod"
    secrets:
      AZURE_CREDENTIALS: ${{ secrets.AZURE_CREDENTIALS_DOCS }}
      AZURE_KEY_VAULT: ${{ secrets.AZURE_KEY_VAULT_DOCS }}