Agent Executor (AX) is Google's open agentic orchestration runtime
Go
Update the deployment script with ateom image and wait step. (#121)
Junjie Wangc9d7691a630f
diff --git a/go.mod b/go.modindex 960ea24..97c64ea 100644--- a/go.mod+++ b/go.mod@@ -6,7 +6,7 @@ require (charm.land/huh/v2 v2.0.3charm.land/lipgloss/v2 v2.0.3github.com/a2aproject/a2a-go/v2 v2.2.0- github.com/agent-substrate/substrate v0.0.0-20260612160914-27aa4eec85f2+ github.com/agent-substrate/substrate v0.0.0-20260616211440-0ec9b650a0abgithub.com/envoyproxy/go-control-plane/envoy v1.37.0github.com/google/uuid v1.6.0github.com/spf13/cobra v1.10.2diff --git a/go.sum b/go.sumindex 071664b..dc3da9e 100644--- a/go.sum+++ b/go.sum@@ -16,8 +16,8 @@ github.com/MakeNowJust/heredoc v1.0.0 h1:cXCdzVdstXyiTqTvfqk9SDHpKNjxuom+DOlyEeQgithub.com/MakeNowJust/heredoc v1.0.0/go.mod h1:mG5amYoWBHf8vpLOuehzbGGw0EHxpZZ6lCpQ4fNJ8LE=github.com/a2aproject/a2a-go/v2 v2.2.0 h1:eayiNXYpyTOLVhhQrGmIHlcy8GnOdnwaNdYQPvS84Ik=github.com/a2aproject/a2a-go/v2 v2.2.0/go.mod h1:htTxMwicNXXXEwwfjuB/Pd1g7UHDrswhSievncmTVcE=-github.com/agent-substrate/substrate v0.0.0-20260612160914-27aa4eec85f2 h1:SlFLoJ3EPWrgR3bBlwCUmpJY6rqrAmvkwb1a9++WOBw=-github.com/agent-substrate/substrate v0.0.0-20260612160914-27aa4eec85f2/go.mod h1:TgdtEUV6iaflJTwmS8ONiGsyyJD+5okPZj2H6mM8WlA=+github.com/agent-substrate/substrate v0.0.0-20260616211440-0ec9b650a0ab h1:ESQ0AWzhw3GROJ5ZIT6tzqHg92mIEqdp/esSmK3s6zQ=+github.com/agent-substrate/substrate v0.0.0-20260616211440-0ec9b650a0ab/go.mod h1:TgdtEUV6iaflJTwmS8ONiGsyyJD+5okPZj2H6mM8WlA=github.com/atotto/clipboard v0.1.4 h1:EH0zSVneZPSuFR11BlR9YppQTVDbh5+16AmcJi4g1z4=github.com/atotto/clipboard v0.1.4/go.mod h1:ZY9tmq7sm5xIbd9bOK4onWV4S6X0u6GY7Vn0Yu86PYI=github.com/aymanbagabas/go-udiff v0.4.1 h1:OEIrQ8maEeDBXQDoGCbbTTXYJMYRCRO1fnodZ12Gv5o=diff --git a/internal/hack/install-ax.sh b/internal/hack/install-ax.shindex d0a54a7..2ee316e 100755--- a/internal/hack/install-ax.sh+++ b/internal/hack/install-ax.sh@@ -41,6 +41,37 @@ function log_step() {echo -e "${COLOR_CYAN}[step]: ${step_name}${COLOR_RESET}"}+# wait_with_spinner runs a blocking command while showing a simple spinner on an+# interactive terminal, then reports "done"/"failed" and returns the command's+# exit status.+wait_with_spinner() {+ local msg="$1"; shift+ if [[ ! -t 2 ]]; then+ "$@"+ return $?+ fi++ local out; out="$(mktemp)"+ "$@" >"${out}" 2>&1 &+ local pid=$! frames='|/-\' i=0+ while kill -0 "${pid}" 2>/dev/null; do+ i=$(( (i + 1) % ${#frames} ))+ printf '\r%s %s' "${frames:${i}:1}" "${msg}" >&2+ sleep 0.1+ done++ local status=0+ wait "${pid}" || status=$?+ if [[ "${status}" -eq 0 ]]; then+ printf '\r\033[K%s... done\n' "${msg}" >&2+ else+ printf '\r\033[K%s... failed\n' "${msg}" >&2+ cat "${out}" >&2+ fi+ rm -f "${out}"+ return "${status}"+}+function usage() {echo "Usage: $0 [options]"echo ""@@ -171,6 +202,35 @@ build_antigravity_image() {echo "${repo}@${digest}"}+build_ateom_image() {+ if [[ -n "${ATEOM_IMAGE:-}" ]]; then+ echo "${ATEOM_IMAGE}"+ return+ fi+ if [[ -z "${KO_DOCKER_REPO:-}" ]]; then+ echo "Error: KO_DOCKER_REPO environment variable must be set" >&2+ exit 1+ fi++ # Resolve the substrate source for the version AX is pinned to in go.mod.+ go mod download github.com/agent-substrate/substrate+ local sub_dir ateom_ref+ sub_dir="$(go list -m -f '{{.Dir}}' github.com/agent-substrate/substrate)"+ if [[ -z "${sub_dir}" ]]; then+ echo "Error: could not locate the substrate module (go list -m)." >&2+ exit 1+ fi++ log_step "build_ateom_image (from ${sub_dir})" >&2+ ateom_ref="$(cd "${sub_dir}" && KO_DOCKER_REPO="${KO_DOCKER_REPO}" GOFLAGS="" ko build --platform=linux/amd64 -B ./cmd/ateom-gvisor)"++ if [[ "${ateom_ref}" != *@sha256:* ]]; then+ echo "Error: ko did not return a digest-pinned ateom image (got '${ateom_ref}')." >&2+ exit 1+ fi+ echo "${ateom_ref}"+}+deploy_ax_server() {log_step "deploy_ax_server"@@ -187,15 +247,23 @@ deploy_ax_server() {echo "Using GCS Bucket: ${BUCKET_NAME}"# Build and push the antigravity harness image, capturing its reference.- local antigravity_image+ local antigravity_image ateom_imageantigravity_image=$(build_antigravity_image)+ ateom_image=$(build_ateom_image)# Render template and apply with kosed -e "s|\${GEMINI_API_KEY}|${GEMINI_API_KEY}|g" \-e "s|\${BUCKET_NAME}|${BUCKET_NAME}|g" \-e "s|\${ANTIGRAVITY_IMAGE}|${antigravity_image}|g" \+ -e "s|\${ATEOM_IMAGE}|${ateom_image}|g" \internal/manifests/ax-deployment2.yaml \| run_ko -f -++ # Wait for the antigravity ActorTemplate's golden snapshot to be ready.+ log_step "wait for actortemplate/ax-harness-template to be Ready"+ wait_with_spinner "waiting for golden snapshot (timeout ${AX_WAIT_TIMEOUT:-5m})" \+ run_kubectl wait --for=condition=Ready actortemplate/ax-harness-template \+ -n ax --timeout="${AX_WAIT_TIMEOUT:-5m}"}delete_ax_server() {@@ -205,6 +273,7 @@ delete_ax_server() {sed -e "s|\${GEMINI_API_KEY}|dummy-key|g" \-e "s|\${BUCKET_NAME}|dummy-bucket|g" \-e "s|\${ANTIGRAVITY_IMAGE}|dummy-image|g" \+ -e "s|\${ATEOM_IMAGE}|dummy-image|g" \internal/manifests/ax-deployment2.yaml \| run_kubectl delete --ignore-not-found -f -}diff --git a/internal/manifests/README.md b/internal/manifests/README.mdindex 23805b0..f4d8cf1 100644--- a/internal/manifests/README.md+++ b/internal/manifests/README.md@@ -27,12 +27,16 @@ and container image are provided by AX.### 1. Build and Deploy> [!NOTE]-> Do not manually edit `internal/manifests/ax-deployment2.yaml`. The installation script automatically injects your `${GEMINI_API_KEY}`, `${BUCKET_NAME}`, and the built `${ANTIGRAVITY_IMAGE}` reference during deployment.+> Do not manually edit `internal/manifests/ax-deployment2.yaml`. The installation script automatically injects your `${GEMINI_API_KEY}`, `${BUCKET_NAME}`, and the built `${ANTIGRAVITY_IMAGE}` and `${ATEOM_IMAGE}` references during deployment.-The installation script builds two images and applies the resolved manifests to-your cluster: the AX control-plane (Go) image, built with `ko` using the-`harness` build tag, and the built-in **antigravity harness** image, built from-`python/antigravity/Dockerfile` with Docker or Podman.+The installation script builds the required images and applies the resolved+manifests to your cluster:++- the AX control-plane (Go) image, built with `ko` using the `harness` build tag;+- the built-in **antigravity harness** image, built from+ `python/antigravity/Dockerfile` with Docker or Podman;+- the **ateom-gvisor** worker image, built with `ko` from the `go.mod` pinned+ substrate module.#### Build prerequisites@@ -80,11 +84,6 @@ export KO_DEFAULTPLATFORMS="linux/amd64"./internal/hack/install-ax.sh --deploy-ax-server```-Wait until the templates are ready:-```bash-kubectl wait --for=condition=Ready actortemplate/ax-harness-template -n ax --timeout=5m-```-### 2. Port-Forward ServicesThe `harness` path has no Envoy router or `Service`; connect directly to the `ax-server` `ReplicaSet`:diff --git a/internal/manifests/ax-deployment2.yaml b/internal/manifests/ax-deployment2.yamlindex 5d12159..d33dd06 100644--- a/internal/manifests/ax-deployment2.yaml+++ b/internal/manifests/ax-deployment2.yaml@@ -34,7 +34,7 @@ metadata:namespace: axspec:replicas: 5- ateomImage: ko://github.com/agent-substrate/substrate/cmd/ateom-gvisor+ ateomImage: ${ATEOM_IMAGE}---apiVersion: ate.dev/v1alpha1kind: ActorTemplate