Skip to content

ci: publish website to github pages - #2497

Merged
lidel merged 1 commit into
mainfrom
ci/github-pages
Jul 17, 2026
Merged

ci: publish website to github pages#2497
lidel merged 1 commit into
mainfrom
ci/github-pages

Conversation

@lidel

@lidel lidel commented Jul 17, 2026

Copy link
Copy Markdown
Member

Problem

webui.ipfs.io and dev.webui.ipfs.io are served over HTTP by the collab cluster gateways (collab-cluster.dwebops.net). When that infra has an outage, both sites go down with it, and nothing in this repo can bring them back.

Fix

  • every merge to main pushes build/ to the gh-pages branch of ipfs/dev.webui.ipfs.io, which GitHub Pages serves as dev.webui.ipfs.io
  • a release (workflow_dispatch) deploys this repo's own Pages behind webui.ipfs.io, unpacked from the CAR artifact so the served bytes always match the pinned CID
  • pinning and DNSLink updates are unchanged, so ipfs:// and gateway access keep working
  • forks skip all publishing and pinning steps, so their CI passes without secrets

Once DNS points both hostnames at GitHub Pages, release and dev HTTP hosting no longer depend on collab cluster availability; the cluster remains the IPFS pinning layer and the rollback target. The DNS flips happen separately.

HTTP hosting for webui.ipfs.io and dev.webui.ipfs.io moves to GitHub
Pages so the sites stay up independently of third-party gateway
servers; IPFS pinning and DNSLink publishing are unchanged.

- publishPreview: push build/ to ipfs/dev.webui.ipfs.io gh-pages on
  every main update (single orphan commit, ssh deploy key)
- new deployPages job: on release dispatch, unpack the CAR artifact
  and deploy it to this repo's Pages, so served bytes always match
  the pinned CID; gated like the production dnslink step
- gate pinning and publishing steps on github.repository so CI in
  forks skips them instead of failing on missing secrets
- refresh stale comments about the release flow
@lidel
lidel requested a review from a team as a code owner July 17, 2026 16:16
@lidel
lidel merged commit e168bad into main Jul 17, 2026
23 of 24 checks passed
@lidel
lidel deleted the ci/github-pages branch July 17, 2026 16:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant