尧图网页设计 
agents-cli GKE 部署详解Terraform Docker Build kubectl apply 全流程【免费下载链接】agents-cliThe CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-cliagents-cli是 Google 推出的开源 CLI 工具配合 Agent Skills 可将任意编码助手变成Google Cloud AI Agent 专家。本文带你走通其中的GKE 部署全流程一条agents-cli deploy命令背后其实自动串联了Terraform 资源编排、Docker 镜像构建推送、kubectl 滚动更新三大环节帮你把 Agent 从本地能跑一路送上 GKE Autopilot 集群。 为什么选择 GKE 部署agents-cli deploy支持三种部署目标在创建项目时通过-d参数选定部署目标执行方式适用场景agent_runtime全托管 Agent Runtime免运维最快上线cloud_rungcloud run deploy轻量级容器服务gkeTerraform Docker build kubectl apply需要 Kubernetes 完整能力HPA、Workload Identity、私有集群的生产环境相关文档见 deployment.mdGKE 专属参考见 gke.md。️ 一键部署命令在项目根目录需已有agents-cli-manifest.yaml其中deployment_target: gke执行agents-cli deploy --cluster-name my-cluster --project my-gcp-project不传--cluster-name时集群名默认使用项目名。核心逻辑位于 cmd_deploy.py 中的_deploy_gke函数共 7 个线性步骤。 想先看看会执行哪些命令而不真正部署加--dry-run即可预览完整流程。 部署全流程拆解第 1 步Terraform 定向供应基础设施CLI 自动执行terraform initterraform apply -target...一次性创建13 个关键资源包括网络VPC 网络、子网10.0.0.0/20、内部防火墙规则集群GKEAutopilot 私有节点集群无外部 IP更安全出网Cloud Router Cloud NAT供私有节点访问互联网镜像仓库Artifact RegistryDOCKER 格式安全应用服务账号 Workload Identity 绑定Pod 免密钥认证K8s 资源Namespace、ServiceAccount、Deployment、内部 LoadBalancer Service、HPA、PDB这些定义全部在模板文件 service.tf 中可按需修改如副本数、CPU/内存配额。第 2 步获取集群凭证自动运行gcloud container clusters get-credentials把kubectl配好指向你的集群。第 3 步构建并推送 Docker 镜像使用项目自带的 Dockerfile与 Cloud Run 共用通过Cloud Build构建镜像推送到 Artifact Registry{region}-docker.pkg.dev/{project}/{服务名}/{服务名}:latest构建采用异步提交 状态轮询最长等待 30 分钟无需本地 Docker 环境。第 4~5 步kubectl 滚动更新 注入环境变量kubectl set image deployment/{服务名} ... # 指向新镜像 kubectl set env deployment/{服务名} ... # 注入 AGENT_VERSION、APP_URL 等其中APP_URL会自动探测内部 LoadBalancer 的 IP 填入供 A2A Agent Card 使用你也可用--update-env-vars KEYVALUE追加自定义变量。第 6~7 步等待滚动完成并输出摘要kubectl rollout status最多等待 600 秒成功后打印内部服务 IP 和本地调试提示。 如何访问部署好的 AgentGKE 的 LoadBalancer默认是内部负载均衡器不对外暴露两种访问方式# 本地端口转发调试 kubectl port-forward svc/{服务名} 8080:8080 -n {服务名} # 查看集群中所有 Deployment 状态 agents-cli deploy --list在 VPC 内部该内部 IP 可直接用于 Pod 间的 A2A 通信。 GKE 模式的限制与注意事项以下标志不适用于 GKE这些配置由 Terraform 管理改 service.tf 即可不适用标志正确做法--cpu/--memory/--min-instances等修改 Terraform 中的 resources 与 HPA默认 2~10 副本、CPU 70% 目标--secrets通过 Kubernetes Secret 或 Secret Manager CSI 驱动挂载--service-name资源名由项目名派生不可覆盖--no-wait/--statusGKE 部署为同步流程直接等待完成--labels在 Terraform 中配置⚡ CI/CD 生产模式只更新镜像上生产时用agents-cli infra cicd --staging-project ... --prod-project ...一条命令即可搭建 staging/prod 双环境集群与流水线。此时部署命令改为传入预构建镜像agents-cli deploy --image {region}-docker.pkg.dev/{project}/{服务名}/{服务名}:v1CLI 检测到--image后会自动跳过 Terraform 和镜像构建仅执行kubectl set image滚动更新——这正是 CI/CD 流水线的标准做法相关模板见 cicd/service.tf。Deployment 中设置了ignore_changes [image]确保 Terraform 不会覆盖流水线更新的镜像版本。✅ 小结环节工具你写多少代码云资源 集群Terraform13 个资源自动 apply0改模板即可镜像构建Dockerfile Cloud Build0滚动更新kubectl set image / set env0本地调试kubectl port-forward1 条命令从原型到生产agents-cli deploy把 GKE 部署最繁琐的三段式流程压成一条命令——把 Kubernetes 细节交给 Terraform把专注留给你的 Agent 本身。【免费下载链接】agents-cliThe CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 agents-cli GKE 部署详解：Terraform + Docker Build + kubectl apply 全流程
agents-cli GKE 部署详解Terraform Docker Build kubectl apply 全流程【免费下载链接】agents-cliThe CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-cliagents-cli是 Google 推出的开源 CLI 工具配合 Agent Skills 可将任意编码助手变成Google Cloud AI Agent 专家。本文带你走通其中的GKE 部署全流程一条agents-cli deploy命令背后其实自动串联了Terraform 资源编排、Docker 镜像构建推送、kubectl 滚动更新三大环节帮你把 Agent 从本地能跑一路送上 GKE Autopilot 集群。 为什么选择 GKE 部署agents-cli deploy支持三种部署目标在创建项目时通过-d参数选定部署目标执行方式适用场景agent_runtime全托管 Agent Runtime免运维最快上线cloud_rungcloud run deploy轻量级容器服务gkeTerraform Docker build kubectl apply需要 Kubernetes 完整能力HPA、Workload Identity、私有集群的生产环境相关文档见 deployment.mdGKE 专属参考见 gke.md。️ 一键部署命令在项目根目录需已有agents-cli-manifest.yaml其中deployment_target: gke执行agents-cli deploy --cluster-name my-cluster --project my-gcp-project不传--cluster-name时集群名默认使用项目名。核心逻辑位于 cmd_deploy.py 中的_deploy_gke函数共 7 个线性步骤。 想先看看会执行哪些命令而不真正部署加--dry-run即可预览完整流程。 部署全流程拆解第 1 步Terraform 定向供应基础设施CLI 自动执行terraform initterraform apply -target...一次性创建13 个关键资源包括网络VPC 网络、子网10.0.0.0/20、内部防火墙规则集群GKEAutopilot 私有节点集群无外部 IP更安全出网Cloud Router Cloud NAT供私有节点访问互联网镜像仓库Artifact RegistryDOCKER 格式安全应用服务账号 Workload Identity 绑定Pod 免密钥认证K8s 资源Namespace、ServiceAccount、Deployment、内部 LoadBalancer Service、HPA、PDB这些定义全部在模板文件 service.tf 中可按需修改如副本数、CPU/内存配额。第 2 步获取集群凭证自动运行gcloud container clusters get-credentials把kubectl配好指向你的集群。第 3 步构建并推送 Docker 镜像使用项目自带的 Dockerfile与 Cloud Run 共用通过Cloud Build构建镜像推送到 Artifact Registry{region}-docker.pkg.dev/{project}/{服务名}/{服务名}:latest构建采用异步提交 状态轮询最长等待 30 分钟无需本地 Docker 环境。第 4~5 步kubectl 滚动更新 注入环境变量kubectl set image deployment/{服务名} ... # 指向新镜像 kubectl set env deployment/{服务名} ... # 注入 AGENT_VERSION、APP_URL 等其中APP_URL会自动探测内部 LoadBalancer 的 IP 填入供 A2A Agent Card 使用你也可用--update-env-vars KEYVALUE追加自定义变量。第 6~7 步等待滚动完成并输出摘要kubectl rollout status最多等待 600 秒成功后打印内部服务 IP 和本地调试提示。 如何访问部署好的 AgentGKE 的 LoadBalancer默认是内部负载均衡器不对外暴露两种访问方式# 本地端口转发调试 kubectl port-forward svc/{服务名} 8080:8080 -n {服务名} # 查看集群中所有 Deployment 状态 agents-cli deploy --list在 VPC 内部该内部 IP 可直接用于 Pod 间的 A2A 通信。 GKE 模式的限制与注意事项以下标志不适用于 GKE这些配置由 Terraform 管理改 service.tf 即可不适用标志正确做法--cpu/--memory/--min-instances等修改 Terraform 中的 resources 与 HPA默认 2~10 副本、CPU 70% 目标--secrets通过 Kubernetes Secret 或 Secret Manager CSI 驱动挂载--service-name资源名由项目名派生不可覆盖--no-wait/--statusGKE 部署为同步流程直接等待完成--labels在 Terraform 中配置⚡ CI/CD 生产模式只更新镜像上生产时用agents-cli infra cicd --staging-project ... --prod-project ...一条命令即可搭建 staging/prod 双环境集群与流水线。此时部署命令改为传入预构建镜像agents-cli deploy --image {region}-docker.pkg.dev/{project}/{服务名}/{服务名}:v1CLI 检测到--image后会自动跳过 Terraform 和镜像构建仅执行kubectl set image滚动更新——这正是 CI/CD 流水线的标准做法相关模板见 cicd/service.tf。Deployment 中设置了ignore_changes [image]确保 Terraform 不会覆盖流水线更新的镜像版本。✅ 小结环节工具你写多少代码云资源 集群Terraform13 个资源自动 apply0改模板即可镜像构建Dockerfile Cloud Build0滚动更新kubectl set image / set env0本地调试kubectl port-forward1 条命令从原型到生产agents-cli deploy把 GKE 部署最繁琐的三段式流程压成一条命令——把 Kubernetes 细节交给 Terraform把专注留给你的 Agent 本身。【免费下载链接】agents-cliThe CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考