update-openapi-doc.yaml

name: Update OpenAPI doc
on:
  push:
    branches:
      - main
    tags:
      - 'v*'

env:
  GHPAGES_DIR: gh-pages
  GHPAGES_REF: refs/heads/gh-pages
jobs:
  update-version:
    name: Update API versions list and specs
    runs-on: ubuntu-latest
    steps:
      - name: Setup Go
        uses: actions/setup-go@v2
        with:
          go-version: 1.16.8

      - name: Checkout code
        uses: actions/checkout@v2

      - name: Checkout github pages
        uses: actions/checkout@v2
        with:
          ref: ${{ env.GHPAGES_REF }}
          path: ${{ env.GHPAGES_DIR }}

      - name: Generate specs
        run: |
          make install-swag
          export PATH=$(go env GOPATH)/bin:$PATH
          swag --version
          make gen-swagger

      - name: Install dependencies
        run: |
          cd ./.github/actions/update-api-doc
          npm ci

      - name: Update version list and copy spec files
        uses: ./.github/actions/update-api-doc
        with:
          specs-source: ./public/docs/swagger.json
          gh-pages-branch: ${{ env.GHPAGES_DIR }}

      - name: Log generated changes
        run: |
          echo "::group::gh-pages dist dir"
          ls -la ${{ env.GHPAGES_DIR }}
          echo "::endgroup::"
          echo "::group::versions.json"
          cat ${{ env.GHPAGES_DIR }}/versions.json
          echo "::endgroup::"
          echo "::group::yaml-spec"
          cat ${{ env.GHPAGES_DIR }}/key-manager-api.latest.json
          echo "::endgroup::"

      - name: Deploy changes to gh-pages
        uses: JamesIves/github-pages-deploy-action@3.7.1
        with:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          BRANCH: ${{ env.GHPAGES_DIR }} # The branch the action should deploy to.
          FOLDER: ${{ env.GHPAGES_DIR }} # The folder the action should deploy.
          CLEAN: false
          PRESERVE: true