Skip to content

all: rename ax-task-runner to ax-runner - #677

Merged
rakyll merged 1 commit into
mainfrom
rename-ax-runner
Nov 20, 2026
Merged

rakyll merged 1 commit into
mainfrom
rename-ax-runner

Conversation

@rakyll

@rakyll rakyll commented Nov 20, 2026 •

Copy link
Copy Markdown
Member

Rename the binary, cmd/ax-task-runner, Dockerfile.task-runner, the ghcr.io/google/ax/ax-task-runner image and AX_TASK_RUNNER_IMAGE to ax-runner. The default command is now /usr/local/bin/ax-runner, so images that only ship /usr/local/bin/ax-task-runner need the runner volume or a rebuild.

Upgrade note (for the next release notes): ax-server now starts tasks with /usr/local/bin/ax-runner, or /opt/ax/ax-runner when AX_RUNNER_VOLUME_IMAGE is set. An ax-server from this release cannot start tasks whose image only bakes in /usr/local/bin/ax-task-runner, or with an ax-runner-volume image from v0.4.0-rc.1 or earlier. Rebuild task images on ghcr.io/google/ax/ax-runner (or copy the ax-runner binary in), and upgrade AX_RUNNER_VOLUME_IMAGE along with ax-server. User-managed ate_templates must point their entrypoint at /usr/local/bin/ax-runner.

Fixes #676.

Rename the binary, cmd/ax-task-runner, Dockerfile.task-runner, the
ghcr.io/google/ax/ax-task-runner image and AX_TASK_RUNNER_IMAGE to
ax-runner. The default command is now /usr/local/bin/ax-runner, so
images that only ship /usr/local/bin/ax-task-runner need the runner
volume or a rebuild.

Fixes #676.
@rakyll
rakyll requested a review from mayawang November 20, 2026 23:41

@mayawang mayawang left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM, thanks Jaana, good to settle the name now. Non-blocking follow-ups:

  • the runner volume path moves too, so a new ax-server with an rc.1 runner volume or an image with the old binary baked in won't find the runner. Worth a line in the next release notes, or a fallback to the old path for one release
  • agentexecutor/images (verify_image.sh, antigravity README) and studio's DefaultTaskImage still say ax-task-runner, I'll pick those up after this lands

@rakyll

rakyll commented Nov 20, 2026

Copy link
Copy Markdown
Member Author

Thanks @mayawang! I went with the release-notes line and added an upgrade note to the PR description so it's ready for the next release. A fallback to the old path won't work: the container command is exec'd directly, with no shell to probe for it (ax-runner-volume is FROM scratch), and ax-server can't tell which binary an image ships. The ax-task-runner names left in this repo are the digest-pinned gcr.io/ax-substrate/ate-images/ax-task-runner base images, and those stay until they're republished. Sounds good on picking up agentexecutor/images and studio's DefaultTaskImage after this lands.

@rakyll
rakyll merged commit fb9b829 into main Nov 20, 2026
12 checks passed
@rakyll
rakyll deleted the rename-ax-runner branch November 20, 2026 23:50
aojea added a commit that referenced this pull request Nov 21, 2026
The local install job fails on main: hack/test-local-install.sh reads
bin/ax-task-runner.digest, and 'make images' writes bin/ax-runner.digest
since ax-task-runner was renamed to ax-runner (#677). #677 merged after
the last CI run of #666, which added the script, and before #666 merged,
so neither change saw the other.

The guide has the same command in "Using Locally Built Images", and a unit
test has the old name in two sample image references. Use the new name in
all three.

When the script fails before 'ax local start' creates a cluster, it no
longer prints the state of a cluster. There is none, and kubectl printed
only connection errors.
@rakyll rakyll mentioned this pull request Nov 21, 2026
4 of 6 tasks
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.

Rename ax-task-runner to ax-runner

2 participants