gitea-pages/docs/guides/cicd.md

CI / CD

name: Build and Deploy Documentation

# ON ist ein trigger
# Kann auch ein Cronjob sein (man cron)

on:
  push:
    branches:
      - main
  workflow_dispatch:

# Job description - Was soll er tun?

jobs:
  build-and-deploy:
# Auf welchem Runner soll er laufen
# Werden angesteuert mit tags

    runs-on: ubuntu-latest-intranet
    container:
# Docker in Docker image welches für den job verwendet werden soll
      image: gitea.psi.ch/images/alpine-mkdocs
# Job Schritte
    steps:
      - name: Checkout repository
# Actions sind hier zu finden: https://github.com/actions
        uses: actions/checkout@v4

      - name: Install Zensical
        run: |
          /opt/python-env/bin/pip install zensical

      - name: Build Zensical docs
        run: |
          export TZ="Europe/Zurich"
          /opt/python-env/bin/zensical build --clean

      - name: Configure Git
        run: |
          git config --global user.name "Gitea Actions"
          git config --global user.email "actions@gitea.local"

      - name: Push to gitea-pages branch
        run: |
          git checkout --orphan gitea-pages
          git reset --hard
          cp -r ./site/* .
          git add .
          git commit -m "Deploy Zensical site"
          git push -f https://${{ secrets.GITHUB_TOKEN }}@gitea.psi.ch/${{ github.repository }}.git gitea-pages