Github Action for Backstage's techdocs plugin from Spotify.
jobs:
techdocs:
name: Check & Publish
runs-on: ubuntu-latest
steps:
- name: Checkout repo
uses: actions/checkout@v3
# Runs mkdocs check in all directories containing **/mkdocs.yaml file
- name: Run mkdocs check
uses: TwistoPayments/actions-techdocs@main
with:
command: check
# Runs techdocs generate and techdocs publish commands in all directories containgin
# **/mkdocs.yaml file. Currently only S3 publisher is supported.
- name: Run techdocs publish
uses: TwistoPayments/actions-techdocs@main
with:
command: publish
env:
TECHDOCS_PUBLISHER_TYPE: awsS3
TECHDOCS_S3_BUCKET_NAME: ${{ secrets.TECHDOCS_S3_BUCKET_NAME }}
AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
AWS_REGION: ${{ secrets.AWS_REGION }}Alternatively, you can pull image from Docker Hub which will be faster as you won't need to build the image each time, just replace
uses: TwistoPayments/actions-techdocs@main
with:
command: <check/publish>with
uses: docker://twistopayments/actions-techdocs:main
with:
args: <check/publish>