Skip to content

respec

respec #305

Workflow file for this run

name: respec
# author: @MikeRalphson
# issue: https://github.com/OAI/OpenAPI-Specification/issues/1564
#
# This workflow updates the respec 'pretty' rendered versions of the spec
# on the gh-pages branch when the corresponding markdown files change.
#
# run this manually from main
on:
workflow_dispatch: {}
jobs:
respec:
# if: github.ref == 'refs/heads/main'
runs-on: ubuntu-latest
steps:
- name: Generate access token
id: generate-token
uses: actions/create-github-app-token@v1
with:
app-id: ${{ secrets.OAI_SPEC_PUBLISHER_APPID }}
private-key: ${{ secrets.OAI_SPEC_PUBLISHER_PRIVATE_KEY }}
owner: OAI
repositories: spec.openapis.org
- uses: actions/checkout@v4 # checkout main branch
with:
fetch-depth: 0
- uses: actions/setup-node@v5 # setup Node.js
with:
node-version: "20.x"
- name: Install dependencies
run: npm ci
- uses: actions/checkout@v5 # checkout gh-pages branch
with:
token: ${{ steps.generate-token.outputs.token }}
repository: OAI/spec.openapis.org
ref: main
path: deploy
- name: run main script
run: scripts/md2html/build.sh
- name: Create Pull Request
uses: peter-evans/create-pull-request@v6
with:
token: ${{ steps.generate-token.outputs.token }}
branch: update-openapi-spec-versions
base: main
delete-branch: true
path: deploy
labels: Housekeeping
reviewers: ralfhandl
title: OpenAPI - Update ReSpec-rendered specification versions
commit-message: Update ReSpec-rendered specification versions
signoff: true
body: |
This pull request is automatically triggered by GitHub action `respec`.
The `versions/*.md` files of the OpenAPI Specification have changed and the correspondingHTML files are regenerated.