release runs the full .agentkit/agentkit.yaml release pipeline: scaffold release config, build the image in the cloud, create or update the AgentKit Runtime, and optionally release Feishu, WeCom, DingTalk proxies or a frontend BFF. If you use the root agentkit.yaml lifecycle config, use launch instead.
release
Without a subcommand, release runs the full pipeline. If .agentkit/agentkit.yaml is missing, it first generates the config and asks you to review it before running the command again.
release creates or updates cloud runtimes and may create VeFaaS functions, gateways, container registry resources, TOS objects, and identity configuration. Confirm .agentkit/agentkit.yaml, credentials, region, and project before running it.
--json is only for managed Sidecar releases where .agentkit/agentkit.yaml resolves a harness_sidecar configuration. Using this flag with a standard release configuration returns a failure result. Output is newline-delimited JSON with progress, runtime, and terminal result events, so Studio or CI can render build, deploy, and publish status by phase.
release config
Generate .agentkit/agentkit.yaml and a Dockerfile.
release build
Build the image in the cloud from .agentkit/agentkit.yaml and write build artifacts under .agentkit/artifacts/.
When managed Harness Sidecar is enabled, the build stage installs application dependencies on top of the platform-managed base image. veadk-python and agentkit_sdk_python entries in requirements.txt are preserved with the application so you can select explicit public package versions; the retired standalone agentkit-harness-sidecar-integration package is removed from the build context and from the base image to avoid conflicting with the implementation shipped in VeADK.
Cloud builds upload the build context to TOS before starting Code Pipeline. The CLI allows each upload request to run for up to 120 seconds and automatically retries once after retryable network errors such as connection resets, transient DNS failures, or upload timeouts.
release apply
Create or update the runtime from the latest built artifact.
For managed Harness Sidecar releases, release apply waits for the key_auth APIG binding after the runtime reaches Ready, then runs the Sidecar, model proxy, and MCP gateway checks. If the release API response is ambiguous but the runtime is already releasing or the new version is ready, the CLI continues from the observed runtime state instead of triggering the release again.
When an existing Sidecar runtime is in Error, but the current version is still the only serving Ready version and every newer version has failed, the CLI preserves the current serving version and updates in place to a new version. If a newer non-failed version exists, more than one serving instance is present, or the recovery conditions cannot be confirmed, the command fails and requires explicit runtime reconciliation first.
IM channel and frontend release settings still live in .agentkit/agentkit.yaml; see agentkit.yaml for field details.
