Skip to content

Migrate to hamclock.com community backend#94

Merged
ChrisRomp merged 5 commits into
mainfrom
chrisromp/hamclock-backend-migration
May 18, 2026
Merged

Migrate to hamclock.com community backend#94
ChrisRomp merged 5 commits into
mainfrom
chrisromp/hamclock-backend-migration

Conversation

@ChrisRomp
Copy link
Copy Markdown
Owner

@ChrisRomp ChrisRomp commented May 18, 2026

The original HamClock backend at clearskyinstitute.com is scheduled for shutdown in June 2026. A community-operated replacement is live at hamclock.com. This PR migrates all backend references so the Docker images continue working after the original server goes offline.

Approach

  • Runtime backend override: Added -b hamclock.com:80 to the Docker CMD in both Dockerfiles so containers connect to the community backend at startup.
  • Source download migration: Switched all build-time download URLs (source zip, version check) from clearskyinstitute.com to hamclock.com, which now hosts the same artifacts over HTTPS.
  • GitHub Actions upgrades: Updated all workflow actions to current Node 24-compatible versions (actions/checkout v6, docker/setup-buildx v4, docker/login-action v4, docker/build-push-action v7, sigstore/cosign-installer v4, actions/upload-artifact v7, actions/download-artifact v8).
  • Script rename: Renamed retry_clearskyinstitute.sh to retry_download.sh since the script is URL-agnostic.
  • VERSION_CHECK_URL default: Added an inline fallback (https://hamclock.com/ham/HamClock/version.pl) in version-check.yml so the workflow functions without the repo variable being pre-configured.

Notes

  • The -b flag was introduced in HamClock v4.22 (the final release by the original author).
  • Users can override the backend via command: in docker-compose if needed.
  • The VERSION_CHECK_URL repository variable should be updated to https://hamclock.com/ham/HamClock/version.pl -- the inline default provides a safety net but the variable takes precedence when set.
  • Action version pinning uses major versions (e.g., v4, v7) for most actions, matching existing repo conventions. Third-party actions with less frequent releases use patch-level pins (e.g., cosign-installer v4.1.2).

ChrisRomp and others added 4 commits May 18, 2026 10:06
Point HamClock at the community-operated backend server at hamclock.com:80
using the -b flag introduced in v4.22. This ensures Docker-based HamClocks
continue working after the June 2026 shutdown of clearskyinstitute.com.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Migrate all functional references from clearskyinstitute.com to hamclock.com:
- Dockerfile source download
- CI workflow downloads (docker-publish, version-check, arch-specific builds)
- README links to project page and user guide
- Script comment header

Note: The VERSION_CHECK_URL repository variable must also be updated
to https://hamclock.com/ham/HamClock/version.pl in GitHub repo settings.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Resolves Node.js 20 deprecation warnings before the June 2026 deadline:
- actions/upload-artifact: v5 -> v7
- actions/download-artifact: v6 -> v8
- docker/build-push-action: v6 -> v7
- docker/login-action: v3 -> v4
- docker/metadata-action: v5 -> v6
- docker/setup-buildx-action: v3 -> v4
- docker/setup-qemu-action: v3 -> v4
- sigstore/cosign-installer: v4.0.0 -> v4.1.2

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

The original HamClock backend at clearskyinstitute.com is being shut down in June 2026, and its TLS cert has already expired. This PR points the Docker images at the community-operated replacement at hamclock.com so that builds and runtime continue to work after the shutdown, and rewrites README messaging accordingly. Alongside the URL/runtime-flag changes, several GitHub Actions are also bumped to new major versions.

Changes:

  • Add -b hamclock.com:80 to the CMD in both Dockerfile and Dockerfile-CI so containers default to the community backend.
  • Migrate all build/CI source-download URLs and README links from www.clearskyinstitute.com to hamclock.com, and rewrite the README from an "end of life" notice into a migration notice.
  • Bump several third-party action versions (docker/setup-qemu-action, setup-buildx-action, login-action, build-push-action, metadata-action, actions/upload-artifact, actions/download-artifact, sigstore/cosign-installer) — not mentioned in the PR description.
Show a summary per file
File Description
README.md Replaces EOL notice with a backend-migration explanation and updates HamClock links to hamclock.com.
Dockerfile Updates source download URL to hamclock.com and appends -b hamclock.com:80 to CMD.
Dockerfile-CI Updates source-comment URL and appends -b hamclock.com:80 to CMD (source itself is supplied as COPY).
scripts/retry_clearskyinstitute.sh Generalizes the header comment; script name and usage line still reference clearskyinstitute.
.github/workflows/version-check.yml Updates the fallback download URL to hamclock.com. Version-check still relies on the VERSION_CHECK_URL repo variable being updated manually.
.github/workflows/docker-publish.yml Updates download URL and bumps several action major versions (upload-artifact v7, download-artifact v8, cosign-installer v4.1.2, setup-buildx-action v4, login-action v4.1.0, metadata-action v6, build-push-action v7).
.github/workflows/docker-build-amd64.yaml Updates download URL and bumps setup-qemu-action, setup-buildx-action, login-action, build-push-action to new majors.
.github/workflows/docker-build-arm64.yaml Same URL change and major-version action bumps as amd64.
.github/workflows/docker-build-armv7.yaml Same URL change and major-version action bumps as amd64.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 9/9 changed files
  • Comments generated: 6

Comment thread .github/workflows/docker-build-armv7.yaml
Comment thread .github/workflows/docker-build-arm64.yaml
Comment thread .github/workflows/docker-build-amd64.yaml
Comment thread .github/workflows/docker-publish.yml
Comment thread scripts/retry_clearskyinstitute.sh Outdated
Comment thread .github/workflows/version-check.yml Outdated
- Rename retry_clearskyinstitute.sh to retry_download.sh (script is URL-agnostic)
- Add fallback default for VERSION_CHECK_URL in version-check.yml so the
  workflow works without the repo variable being configured

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@ChrisRomp ChrisRomp merged commit 78fbb49 into main May 18, 2026
4 checks passed
@ChrisRomp ChrisRomp deleted the chrisromp/hamclock-backend-migration branch May 18, 2026 18:10
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.

2 participants