update-docs.yaml

name: "Update docs"
on:
  push:
    paths:
      - CHANGELOG.md
      - versions.yml
      - UPGRADE.md
      - docs/generated/raw/**
    branches: ["master"]
    tags: ["*"]
  workflow_dispatch: {}
  schedule:
    - cron: 0 8 * * *
env:
  DOCS_REPO: kuma-website
  OUTPUT_PATH: app/assets
  VERSION_FILE: app/_data/versions.yml
  EDITION: kuma
permissions:
  contents: read
jobs:
  generate-docs:
    timeout-minutes: 10
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@a5ac7e51b41094c92402da3b24376905380afc29 # v4.1.6
        with:
          fetch-depth: 0
          ref: master
          path: repo
      - uses: actions/setup-go@cdcb36043654635271a94b9a6d1392de5bb323a7 # v5.0.1
        with:
          go-version-file: repo/go.mod
      - name: "sync docs" # loop over all the branches and generate the docs
        run: |
          cd repo
          for b in $(jq -r '.[]' active-branches.json); do
            name=$(echo "${b}" | sed 's/release-\(.*\)/\1.x/g' | sed 's/master/dev/g')
            echo "${b} ${name}"
            git checkout --force "${b}"
            mkdir -p ../docs-build/${name}/raw
            cp -R docs/generated/raw ../docs-build/${name}/
            mkdir -p ../docs-build/raw
            if [[ "${b}" == "master" ]]; then
              if [[ -f UPGRADE.md ]]; then
                cp UPGRADE.md ../docs-build/raw/
              fi
              cp CHANGELOG.md ../docs-build/raw/
              cp versions.yml ../docs-build/raw/
            fi
          done
      - uses: actions/checkout@a5ac7e51b41094c92402da3b24376905380afc29 # v4.1.6
        with:
          repository: ${{ github.repository_owner }}/${{ env.DOCS_REPO }}
          path: docs
      - name: "update versions"
        run: |
          cd docs
          cp -R ../docs-build/* ${{ env.OUTPUT_PATH }}/
          yq -i 'del(.[] | select(.edition == "${{ env.EDITION }}")) | . += load("${{ env.OUTPUT_PATH}}/raw/versions.yml")' ${{ env.VERSION_FILE }}
          rm ${{ env.OUTPUT_PATH }}/raw/versions.yml
      - name: Generate GitHub app token
        id: github-app-token
        uses: actions/create-github-app-token@a0de6af83968303c8c955486bf9739a57d23c7f1 # v1.10.0
        with:
          app-id: ${{ secrets.APP_ID }}
          private-key: ${{ secrets.APP_PRIVATE_KEY }}
          owner: ${{ github.repository_owner }}
          repositories: ${{ env.DOCS_REPO }}
      - name: "Create Pull Request"
        uses: peter-evans/create-pull-request@6d6857d36972b65feb161a90e484f2984215f83e # v6.0.5
        with:
          path: docs
          commit-message: "chore(deps): update docs from repo source"
          signoff: true
          branch: chore/docs-sync-${{github.repository}}
          body: |
            Syncing docs from source code.

            Generated by [action](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }})
          delete-branch: true
          title: "chore(deps): update docs from repo source"
          draft: false
          token: ${{ steps.github-app-token.outputs.token }}
          committer: kumahq[bot] <110050114+kumahq[bot]@users.noreply.github.com>
          author: kumahq[bot] <110050114+kumahq[bot]@users.noreply.github.com>