feat: deploy to git-pages instead of SCP (with preview deploys) #17

Merged

radu merged 41 commits from feat/git-pages-deploy into main 2026-07-21 11:48:29 +00:00

Conversation 0 Commits 41 Files changed 1 +25 -11

radu commented 2026-07-20 11:11:12 +00:00

Owner

Copy link

Closes #3

What changes

• Workflow (build.yml): replaces SCP/SSH deploy with git-pages deployment

  • Builds Hugo, tars public/, PUTs to git-pages via Forge-Authorization
  • Production (push to main): deploys to radu.pages.martin.md/blog, served at blog.martin.md via custom domain
  • Preview (PR): deploys to radu.preview.pages.martin.md/blog@{N} with --baseURL set for correct asset paths
  • Authenticates via Forge-Authorization: Bearer — git-pages verifies the CI token against the Forgejo API
  • Checks out PR branch for preview builds (github.head_ref)
  • Removes all 4 SSH secrets

• Server config: lives in homelab/dc-git-pages

Preview deployments

PRs deploy to https://radu.preview.pages.martin.md/blog@{N}/ on every push.

Prerequisites

Merged and deployed on kronos:

• dc-git-pages#9 — separate preview router + wildcard cert
• dc-traefik#94 — DNS-01 Cloudflare challenge

Cleanup after migration

1. Remove SSH secrets from repo settings
2. Remove/repurpose the nginx blog container

Closes #3 ## What changes - **Workflow** (`build.yml`): replaces SCP/SSH deploy with git-pages deployment - Builds Hugo, tars `public/`, PUTs to git-pages via Forge-Authorization - Production (push to main): deploys to `radu.pages.martin.md/blog`, served at `blog.martin.md` via custom domain - Preview (PR): deploys to `radu.preview.pages.martin.md/blog@{N}` with `--baseURL` set for correct asset paths - Authenticates via `Forge-Authorization: Bearer` — git-pages verifies the CI token against the Forgejo API - Checks out PR branch for preview builds (`github.head_ref`) - Removes all 4 SSH secrets - **Server config**: lives in [homelab/dc-git-pages](https://git.martin.md/homelab/dc-git-pages) ## Preview deployments PRs deploy to `https://radu.preview.pages.martin.md/blog@{N}/` on every push. ## Prerequisites Merged and deployed on kronos: - [dc-git-pages#9](https://git.martin.md/homelab/dc-git-pages/pulls/9) — separate preview router + wildcard cert - [dc-traefik#94](https://git.martin.md/homelab/dc-traefik/pulls/94) — DNS-01 Cloudflare challenge ## Cleanup after migration 1. Remove SSH secrets from repo settings 2. Remove/repurpose the nginx blog container

radu added 3 commits 2026-07-20 11:11:12 +00:00

feat(ci): deploy to git-pages instead of SCP ... f5de854d63

Replace the SSH/SCP deployment with git-pages:
- Push built site to pages branch (production) or
  pages/preview/pr-{N} (preview)
- Notify git-pages via PUT request
- Supports pull_request preview deployments

Removes all SSH secrets and the nginx dependency.

feat: add git-pages docker-compose for server deployment 921b5ec85b

feat: add git-pages configuration ad846382f0

radu added 1 commit 2026-07-20 11:11:43 +00:00

fix(ci): use host IP for git-pages notification ... b0f43e955c

The runner creates ephemeral Docker networks so host.docker.internal
and the bridge gateway are not accessible. Use the host's actual IP
(10.0.50.110) where git-pages is exposed.

radu added 1 commit 2026-07-20 11:11:52 +00:00

fix: expose git-pages on all interfaces for runner access 15be75486b

radu added 1 commit 2026-07-20 11:18:56 +00:00

fix: use pages.martin.md as root, blog.martin.md as dedicated wildcard 16ef06d366

radu added 1 commit 2026-07-20 11:19:03 +00:00

fix: pin version, use absolute paths, localhost-only port for webhook dc3aa7851d

radu added 1 commit 2026-07-20 11:20:12 +00:00

fix(ci): final git-pages workflow - webhook-driven, no runner notification ... d0850922a0

Push to pages branch (production) or pages/preview/pr-{N} (preview).
A Forgejo webhook to http://127.0.0.1:3000/ triggers git-pages to clone
and serve the pages branch on every push.

No SSH secrets needed. No runner-to-git-pages notification needed.

radu added 1 commit 2026-07-20 11:27:27 +00:00

fix: remove blog.martin.md wildcard, use .domains file instead 16f7bd83d2

radu added 1 commit 2026-07-20 11:27:36 +00:00

feat: add .domains file for blog.martin.md custom domain ... 5c876133ea

git-pages resolves custom domains via a .domains file in the site
root. This eliminates the need for a dedicated [[wildcard]] entry
for blog.martin.md in the git-pages config.

radu added 1 commit 2026-07-20 11:38:10 +00:00

fix: no published ports — webhook goes through Traefik at pages.martin.md 72f85e060a

radu added 1 commit 2026-07-20 11:42:51 +00:00

fix: align config path with /srv/docker/volumes/git-pages/config/ 4aa400aebf

radu added 1 commit 2026-07-20 11:46:13 +00:00

fix: correct git-pages tag (0.9.1, no v prefix) dd20962024

radu added 1 commit 2026-07-20 11:46:27 +00:00

fix: correct git-pages tag (0.9.1, no v prefix) d22938c1c4

radu added 1 commit 2026-07-20 11:57:43 +00:00

fix: mount config directory instead of single file ... 653797e9c6

Single-file bind mounts fail on this filesystem (possibly zfs/nfs).
Mount the entire config directory and pass -config flag to git-pages.

radu added 1 commit 2026-07-20 12:02:09 +00:00

fix: include binary path in command override b05e9d866d

radu added 1 commit 2026-07-20 12:02:20 +00:00

fix: full file rewrite with correct command cfaea0bb7d

radu added 1 commit 2026-07-20 12:04:31 +00:00

fix: mount config to /etc/git-pages to avoid container path conflicts 10df015c0d

radu added 1 commit 2026-07-20 12:22:42 +00:00

fix: remove preview-domain (not supported in git-pages 0.9.1) 0524848df8

radu added 1 commit 2026-07-20 12:28:13 +00:00

fix: back to single-file mount, no -config flag needed eb6d31a733

radu added 1 commit 2026-07-20 12:29:43 +00:00

fix: directory mount + -config flag (works with Portainer) 264f9bfbcc

radu added 1 commit 2026-07-21 07:43:30 +00:00

Remove deploy files (moved to homelab/dc-git-pages) 0e49091d4b

radu added 1 commit 2026-07-21 07:43:32 +00:00

Remove deploy files (moved to homelab/dc-git-pages) 042fa5c79e

radu added 1 commit 2026-07-21 07:44:19 +00:00

Add git-pages notification step and remove deploy files c5c18402d9

radu added 1 commit 2026-07-21 07:56:30 +00:00

Fix notification URLs to use wildcard subdomain format 6e8bbd29c6

radu added 1 commit 2026-07-21 08:04:30 +00:00

Use tar-based PUT with Forge-Authorization (no PAGES_INSECURE needed) 1a5e77b5e7

radu added 1 commit 2026-07-21 08:16:19 +00:00

fix: simplify deploy step, add verbose curl debugging f990039cf9

radu added 1 commit 2026-07-21 08:32:36 +00:00

fix: add -k to curl to accept self-signed cert until LE issues one 3826fdfd9f

radu added 1 commit 2026-07-21 08:45:28 +00:00

remove -k from curl now that DNS-01 will issue valid certs 95a60e8610

radu added 1 commit 2026-07-21 10:39:00 +00:00

fix: remove env block, inline token (v12.7.0 compatibility) 22e2d615b5

radu added 1 commit 2026-07-21 11:11:11 +00:00

fix: rename deploy step (no hyphen), add debug echos 43d92df3a6

radu added 1 commit 2026-07-21 11:16:20 +00:00

fix: split into Set deploy URL + Deploy steps, avoid bash vars in deploy step e2cd7a790d

radu added 1 commit 2026-07-21 11:30:47 +00:00

fix: remove setup-go to test if it blocks subsequent steps 1b5a232f01

radu added 1 commit 2026-07-21 11:37:08 +00:00

fix: install Go manually instead of uses: to avoid runner exit-code-60 bug 03f2143bd4

radu added 1 commit 2026-07-21 11:38:39 +00:00

fix: restore setup-go, use single-line deploy to avoid backslash continuation issue 07711e3a6c

radu added 1 commit 2026-07-21 11:39:42 +00:00

fix: multiline deploy step, no backslash continuations 76f37917c0

radu added 1 commit 2026-07-21 11:41:35 +00:00

fix: set --baseURL for preview deploys so assets resolve correctly e5b10cf298

radu added 1 commit 2026-07-21 11:42:55 +00:00

add temporary preview test post e5e371a7a5

radu added 1 commit 2026-07-21 11:44:06 +00:00

fix: checkout PR branch, not main, for preview builds 3760b8fae6

radu added 1 commit 2026-07-21 11:45:41 +00:00

update preview test post to verify redeploy on push f780e9a99e

radu added 1 commit 2026-07-21 11:46:26 +00:00

remove temporary preview test post b8418c9d05

radu merged commit 092363b412 into main 2026-07-21 11:48:29 +00:00

radu deleted branch feat/git-pages-deploy 2026-07-21 11:48:29 +00:00

radu referenced this pull request from a commit 2026-07-21 11:48:29 +00:00

feat: deploy to git-pages instead of SCP (with preview deploys) (#17)

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

radu/blog!17

No description provided.