Skip to content

feat(ci): add aspect ci runner-metadata and aspect ci runner-health-check#1303

Open
gregmagolan wants to merge 1 commit into
mainfrom
feat/ci-runner-metadata-health-check
Open

feat(ci): add aspect ci runner-metadata and aspect ci runner-health-check#1303
gregmagolan wants to merge 1 commit into
mainfrom
feat/ci-runner-metadata-health-check

Conversation

@gregmagolan

Copy link
Copy Markdown
Member

Adds two standalone aspect ci commands that run, on demand, the two diagnostics that otherwise run only inside a Bazel task's Setup phase:

  • aspect ci runner-metadata — print the Aspect Workflows runner metadata table (cloud/region/instance, cache and storage paths, warming status, bootstrap-logs command).
  • aspect ci runner-health-check — wait for cache warming, print the last runner health check and warming status, probe the runner's Bazel server, and signal the runner unhealthy if it is wedged. Exits non-zero when the server is unhealthy.

Both are thin wrappers over the existing print_environment_info / agent_health_check library functions, in the same spirit as the standalone aspect ci warming and aspect ci bazelrc commands. Off a Workflows runner there is nothing to inspect, so each prints an informational line and exits 0.


Changes are visible to end-users: yes

  • Searched for relevant documentation and updated as needed: no

  • Breaking change (forces users to change their own code or config): no

  • Suggested release notes appear below: yes

  • Add aspect ci runner-metadata to print the Aspect Workflows runner metadata table on demand.

  • Add aspect ci runner-health-check to run the Aspect Workflows runner health check on demand.

Test plan

  • Manual testing; please provide instructions so we can reproduce:
    • Off a runner: aspect ci runner-metadata and aspect ci runner-health-check each print an info line and exit 0.
    • With ASPECT_WORKFLOWS_RUNNER (+ ASPECT_WORKFLOWS_RUNNER_*) set: aspect ci runner-metadata prints the metadata table.
    • On a Workflows runner: aspect ci runner-health-check runs the Bazel server probe and exits 0 (healthy) / non-zero (unhealthy).

@gregmagolan gregmagolan force-pushed the feat/ci-runner-metadata-health-check branch from 9868e31 to 2111be0 Compare June 30, 2026 07:11
@aspect-workflows

aspect-workflows Bot commented Jun 30, 2026

Copy link
Copy Markdown

✨ Aspect Workflows Tasks

📅 Tue Jul 7 13:07:58 UTC 2026

⚠️ 2 flagged tasks

  • ⚠️ delivery-gha-debug [delivery] · ⏱ 49.2s · 🐙 GitHub Actions · ☑️ Check
    💬 Delivery complete (1 delivered · 2 warn · 3 skipped)
  • ⚠️ delivery-gha [delivery] · ⏱ 1m 1s · 🐙 GitHub Actions · ☑️ Check
    💬 Delivery complete (1 delivered · 2 warn · 3 skipped)

✅ 27 successful tasks

  • ✅ axl-smoke-gha-bootstrap [build] · ⏱ 50s · 🐙 GitHub Actions · ☑️ Check
    💬 Bazel build complete (1 built)
  • ✅ run-axl-smoke [run] · ⏱ 23.9s · 🐙 GitHub Actions · ☑️ Check
    💬 Ran //examples/deliverable:py_deliverable
  • ✅ run-axl-smoke-2 [run] · ⏱ 14.6s · 🐙 GitHub Actions · ☑️ Check
    💬 Ran //examples/deliverable:sh_deliverable
  • ✅ axl-tests-gha-bootstrap [build] · ⏱ 1m 14s · 🐙 GitHub Actions · ☑️ Check
    💬 Bazel build complete (1 built)
  • ✅ build-gha-debug [build] · ⏱ 4m 37s · 🐙 GitHub Actions · ☑️ Check
    💬 Bazel build complete (166 built)
  • ✅ build-gha [build] · ⏱ 4m 39s · 🐙 GitHub Actions · ☑️ Check
    💬 Bazel build complete (166 built)
  • ✅ build-gha-ephemeral [build] · ⏱ 45.8s · 🐙 GitHub Actions · ☑️ Check
    💬 Bazel build complete (9 built)
  • ✅ buildifier-gha-debug [buildifier] · ⏱ 42.9s · 🐙 GitHub Actions · ☑️ Check
    💬 Format complete (clean)
  • ✅ buildifier-gha [buildifier] · ⏱ 51.4s · 🐙 GitHub Actions · ☑️ Check
    💬 Format complete (clean)
  • ✅ format-gha-debug [format] · ⏱ 1m 44s · 🐙 GitHub Actions · ☑️ Check
    💬 Format complete (clean)
  • ✅ format-format-repeat-task [format] · ⏱ 1m 55s · 🐙 GitHub Actions · ☑️ Check
    💬 Format complete (clean)
  • ✅ format-format-repeat-task-2 [format] · ⏱ 18.2s · 🐙 GitHub Actions · ☑️ Check
    💬 Format complete (clean)
  • ✅ format-format-repeat-task-3 [format] · ⏱ 15.2s · 🐙 GitHub Actions · ☑️ Check
    💬 Format complete (clean)
  • ✅ format-format-repeat-task-4 [format] · ⏱ 15.3s · 🐙 GitHub Actions · ☑️ Check
    💬 Format complete (clean)
  • ✅ format-gha [format] · ⏱ 1m 26s · 🐙 GitHub Actions · ☑️ Check
    💬 Format complete (clean)
  • ✅ gazelle-gha-debug [gazelle] · ⏱ 1m 21s · 🐙 GitHub Actions · ☑️ Check
    💬 Gazelle complete (clean)
  • ✅ gazelle-from-source-gha-debug [gazelle] · ⏱ 2m 31s · 🐙 GitHub Actions · ☑️ Check
    💬 Gazelle complete (clean)
  • ✅ gazelle-from-source-gha [gazelle] · ⏱ 2m 6s · 🐙 GitHub Actions · ☑️ Check
    💬 Gazelle complete (clean)
  • ✅ gazelle-gha [gazelle] · ⏱ 55.9s · 🐙 GitHub Actions · ☑️ Check
    💬 Gazelle complete (clean)
  • ✅ init-shell [build] · ⏱ 43s · 🐙 GitHub Actions · ☑️ Check
    💬 Bazel build complete (10 built)
  • ✅ lint-gha-debug [lint] · ⏱ 56.4s · 🐙 GitHub Actions · ☑️ Check
    💬 Lint complete (clean)
  • ✅ lint-gha [lint] · ⏱ 52.1s · 🐙 GitHub Actions · ☑️ Check
    💬 Lint complete (clean)
  • ✅ test-gha-debug [test] · ⏱ 3m 40s · 🐙 GitHub Actions · ☑️ Check
    💬 Bazel test complete (26/26 passed · 26 cached)
  • ✅ test-gha-coverage [test] · ⏱ 27.3s · 🐙 GitHub Actions · ☑️ Check
    💬 Bazel test complete (1/1 passed · 1 cached)
  • ✅ test-gha-target-pattern-file [test] · ⏱ 26.2s · 🐙 GitHub Actions · ☑️ Check
    💬 Bazel test complete (1/1 passed · 1 cached)
  • ✅ test-gha [test] · ⏱ 3m 36s · 🐙 GitHub Actions · ☑️ Check
    💬 Bazel test complete (26/26 passed · 25 cached)
  • ✅ test-gha-ephemeral [test] · ⏱ 38.6s · 🐙 GitHub Actions · ☑️ Check
    💬 Bazel test complete (1/1 passed)

🔁 Reproduce

⚠️ delivery (delivery-gha-debug · delivery-gha)

# --mode=always --track-state=false for off-runner with no state backend.
aspect delivery \
  --commit-sha=ea3ab00a03860e4db850cb8075ffd5cf6759e009 \
  --mode=always \
  --track-state=false \
  --dry-run=true

Install aspect: aspect.build/docs/cli/install


⏱ Last updated Tue Jul 7 13:16:28 UTC 2026 · 📊 GitHub API quota 2,436/15,000 (16% used, resets in 1m)
🚀 Powered by Aspect CLI (v0.0.0-dev)  |  Aspect Build · X · LinkedIn · YouTube

@thesayyn

thesayyn commented Jun 30, 2026

Copy link
Copy Markdown
Member

should the namespace be aspect runner? none of these actually about CI, its more about runners.

aspect runner metadata
aspect runner health

reads better imo

@gregmagolan gregmagolan force-pushed the feat/ci-runner-metadata-health-check branch 2 times, most recently from 80b0fa7 to e2cca33 Compare July 1, 2026 19:53
…h-check`

Expose the runner-metadata table and the runner health check — both
normally run only inside a task's Setup phase — as standalone `ci`
commands. Each is a thin wrapper over the existing functions
(`print_environment_info`, `agent_health_check`); off a Workflows runner
both print an info line and exit 0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@gregmagolan gregmagolan force-pushed the feat/ci-runner-metadata-health-check branch from e2cca33 to ea3ab00 Compare July 7, 2026 13:03
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