Repository navigation
all: rename ax-task-runner to ax-runner - #677
Merged
Merged
Conversation
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.
mayawang
approved these changes
Nov 20, 2026
mayawang
left a comment
Collaborator
There was a problem hiding this comment.
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
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. |
3 tasks
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.
4 of 6 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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-runnerwhenAX_RUNNER_VOLUME_IMAGEis set. An ax-server from this release cannot start tasks whose image only bakes in/usr/local/bin/ax-task-runner, or with anax-runner-volumeimage from v0.4.0-rc.1 or earlier. Rebuild task images onghcr.io/google/ax/ax-runner(or copy theax-runnerbinary in), and upgradeAX_RUNNER_VOLUME_IMAGEalong with ax-server. User-managedate_templates must point their entrypoint at/usr/local/bin/ax-runner.Fixes #676.