Skip to content

docs,ci: make dl.agora.io the canonical install URL#46

Merged
plutoless merged 1 commit into
mainfrom
docs/canonical-dl-agora
Jun 29, 2026
Merged

docs,ci: make dl.agora.io the canonical install URL#46
plutoless merged 1 commit into
mainfrom
docs/canonical-dl-agora

Conversation

@plutoless

Copy link
Copy Markdown
Collaborator

Summary

The dl.agora.io mirror is now live and proven (it served v0.2.7 end-to-end). This promotes it from a restricted-network fallback to the default install URL.

  • Canonical URL flip — README, install.sh / install.ps1 headers, the INSTALLER_BASE_URL default, and the Pages install tokens (prepare-pages-site.py) now point at https://dl.agora.io/cli/install.{sh,ps1}. GitHub Pages (agoraio.github.io) and raw.githubusercontent remain documented alternatives.
  • Binary behavior unchanged — the script still downloads binaries GitHub-first with automatic fallback to the mirror, SHA-256 verified either way. AGORA_INSTALL_SOURCE=s3 still skips GitHub entirely for fully-blocked regions.
  • New sync-installers.yml — on pushes to main that touch install.sh/install.ps1, upload them to S3 + invalidate CloudFront, so the canonical script stays fresh between tag releases (mirror-to-s3 only refreshes it on tags).
  • Unchanged: docs-site URLs (agoraio.github.io/cli, /md) and DOCS_URL.

Test Plan

  • sh -n install.sh, test-installer-messages.sh (13), test-installer-fallback.sh (10) pass; canonical-URL assertion now expects dl.agora.io.
  • sync-installers.yml valid YAML; prepare-pages-site.py parses.
  • After merge: a main push touching the installers runs sync-installers and refreshes https://dl.agora.io/cli/install.sh.

🤖 Generated with Claude Code

Now that the dl.agora.io mirror is live and proven (v0.2.7), promote it from a
restricted-network fallback to the default install URL:

- README, install.sh / install.ps1 headers, INSTALLER_BASE_URL default, and the
  Pages install tokens (prepare-pages-site.py) now point at
  https://dl.agora.io/cli/install.{sh,ps1}. GitHub Pages and raw.githubusercontent
  are kept as documented alternatives; binary auto-fallback is unchanged.
- Add sync-installers.yml: on push to main touching install.sh/install.ps1,
  upload them to S3 and invalidate CloudFront, so the canonical script stays
  fresh between tag releases (mirror-to-s3 only updates it on tags).
- Update the canonical-URL assertion in test-installer-messages.sh.

Docs-site URLs (agoraio.github.io/cli, /md) are unchanged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@plutoless plutoless merged commit fe621d1 into main Jun 29, 2026
7 checks passed
@plutoless plutoless deleted the docs/canonical-dl-agora branch June 29, 2026 14:48
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