dc
982cf5b28e
The publish job installed cloudron-surfer 6.4.1 and uploaded with a token; the current major takes a Cloudron username plus an app password instead. Pin @cloudron/surfer 7.2.0, user allan, password from SURFER_PASSWORD. `deploy` rather than `put`: it swaps the site atomically, so a failed upload leaves the current site serving, and it records the ref and commit in the site's deploy history. The docs are a named site (`docs`) on its own alias domain, so both are passed. Also adds workflow_dispatch, so a deploy can be run by hand.
77 lines
2.8 KiB
YAML
77 lines
2.8 KiB
YAML
name: Publish to docs.datacontroller.io
|
|
on:
|
|
push:
|
|
branches:
|
|
- main
|
|
workflow_dispatch:
|
|
|
|
# One deploy at a time: `surfer deploy` swaps the site atomically, so two runs
|
|
# racing is not corruption, but it is a wasted build and the last swap wins.
|
|
concurrency:
|
|
group: surfer-docs
|
|
cancel-in-progress: false
|
|
|
|
jobs:
|
|
build:
|
|
name: Deploy docs
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- uses: actions/setup-node@v3
|
|
with:
|
|
node-version: 18
|
|
|
|
- name: Checkout master
|
|
uses: actions/checkout@v4 # Updated to latest version
|
|
|
|
- name: Setup Python
|
|
uses: actions/setup-python@v4
|
|
with:
|
|
python-version: '3.12' # Specify your desired version (e.g. 3.10 or 3.12)
|
|
env:
|
|
AGENT_TOOLSDIRECTORY: /opt/hostedtoolcache
|
|
RUNNER_TOOL_CACHE: /opt/hostedtoolcache
|
|
|
|
- name: Install Chrome
|
|
run: |
|
|
apt-get update
|
|
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
|
|
apt install -y ./google-chrome*.deb;
|
|
export CHROME_BIN=/usr/bin/google-chrome
|
|
|
|
- name: build site
|
|
run: |
|
|
pip install mkdocs==1.6.1
|
|
pip install mkdocs-material==9.7.7
|
|
pip install fontawesome_markdown==0.2.6
|
|
pip install mkdocs-redirects==1.2.3
|
|
mkdocs build --clean
|
|
mkdir site/slides
|
|
npx @marp-team/marp-cli@4.5.1 slides/innovation/innovation.md -o ./site/slides/innovation/index.html
|
|
npx @marp-team/marp-cli@4.5.1 slides/if/if.md -o site/if.pdf --allow-local-files --html=true
|
|
|
|
# Deploy tooling is pinned to exact versions: the workflow builds whatever
|
|
# is committed, and an unpinned `latest` would let a breaking or
|
|
# compromised upstream release ship straight to the live site.
|
|
#
|
|
# `deploy` (v7) replaces the site atomically - it extracts to a staging
|
|
# folder and swaps it in, so a failed upload leaves the current site
|
|
# serving. The v6 `put` this replaces was token authenticated, and v7
|
|
# takes the Cloudron username plus an app password instead.
|
|
#
|
|
# The docs live in a NAMED site, `docs`, served at its own alias domain -
|
|
# not the app's default site - so the name and the domain are both passed.
|
|
- name: Deploy docs
|
|
env:
|
|
SURFER_PASSWORD: ${{ secrets.SURFER_PASSWORD }}
|
|
REF_NAME: ${{ gitea.ref_name }}
|
|
COMMIT_SHA: ${{ gitea.sha }}
|
|
run: |
|
|
set -euo pipefail
|
|
npx --yes @cloudron/surfer@7.2.0 deploy site \
|
|
--server docs.datacontroller.io \
|
|
--username allan \
|
|
--password "$SURFER_PASSWORD" \
|
|
--site-name docs \
|
|
--domain docs.datacontroller.io \
|
|
--message "Build from ${REF_NAME} @ ${COMMIT_SHA:0:8}"
|