agents-cli 的 variables.tf 全解8 个关键 Terraform 变量详解【免费下载链接】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一句话了解 agents-cli 与 variables.tfagents-cli是 Google 开源的命令行工具它把任意编码助手变成Google Cloud 上创建、评估、部署 AI Agent 的专家。其中 variables.tf 是整个 CI/CD 基础设施的总开关——一条agents-cli infra cicd命令背后就是这 8 个关键 Terraform 变量在决定你的 Agent 部署到哪个项目、哪个区域、连哪个仓库。8 个关键变量一览表在动手之前先花 30 秒扫一眼全局。这 8 个变量可以分成4 组每组解决一类问题#变量名类型默认值回答的问题1project_namestring脚手架项目名下划线转连字符资源叫什么名字2staging_project_idstring无必填预发环境用哪个 GCP 项目3prod_project_idstring无必填生产环境用哪个 GCP 项目4cicd_runner_project_idstring无必填流水线本身跑在哪个项目里5regionstringus-east1所有资源部署到哪个区域6repository_ownerstring无必填代码仓库归谁所有7repository_namestring无必填仓库叫什么名字8host_connection_namestring{项目名}-github-connectionCloud Build 怎么连上你的仓库 命名规律很好记2 个环境 ID 1 个流水线 ID 1 个区域 1 个名字 2 个仓库信息 1 个连接名。变量详解分组逐个讲️ 第 1 组资源命名 ——project_namevariables.tf 第 15-19 行 定义了它variable project_name { type string description Project name used as a base for resource naming default {{ cookiecutter.project_name | replace(_, -) }} }它是所有 GCP 资源的命名基底。比如 Cloud Build 触发器会直接叫pr-${var.project_name}、cd-${var.project_name}见 build_triggers.tf。默认值由脚手架自动生成——你把下划线写成什么样Terraform 里就会自动替换成连字符。 第 2 组三个 GCP 项目 ID这是新手最容易混淆的一组其实职责非常清晰staging_project_id预发环境。合并代码后流水线先部署到这里跑集成测试和负载测试。prod_project_id生产环境。通过预发验证后人工审批再部署到这里。cicd_runner_project_id流水线自己住的项目——API 密钥、触发器、日志桶都建在这里见 apis.tf。最佳实践三者可以是同一个项目 ID快速验证但生产环境强烈建议分开实现环境隔离与独立的成本核算。agents-cli infra cicd通过--staging-project/--prod-project参数传入详见 docs/src/guide/cicd.md。 第 3 组部署区域 ——region默认us-east1。它决定了 Cloud Build 连接、构建触发器、日志桶等资源的地理位置。选区口诀离你的用户和数据源越近延迟越低。改一个变量全栈资源跟着走非常省心。 第 4 组仓库与连接三件套变量说明新手建议repository_ownerGit 仓库的属主用户名或组织名填你的 GitHub 账号或组织repository_name要接入流水线的仓库名与agents-cli scaffold生成的仓库保持一致host_connection_name在 Cloud Build 中创建的连接名称一般用默认值即可除非你已手动建过同名连接三者组合成完整的仓库引用路径projects/${cicd_runner_project_id}/locations/${region}/connections/${host_connection_name}/repositories/${repository_name}见 build_triggers.tf 第 24 行。变量在哪里填env.tfvars 模板帮你省心好消息是你几乎不需要手写这些变量。脚手架在生成项目时会基于 env.tfvars 模板 自动生成一份填好大部分默认值的文件project_name my-agent-project prod_project_id your-production-project-id # ← 只需填这 3 行 staging_project_id your-staging-project-id # ← cicd_runner_project_id your-cicd-project-id # ← region us-east1之后执行agents-cli infra cicd --staging-project ... --prod-project ...CLI 就会自动渲染 Terraform 模板并创建资源。两个进阶变量顺带认识一下除了上述 8 个核心参数variables.tf 里还有两组权限列表变量它们由脚手架按你的技术选型自动生成app_sa_roles应用服务账号的角色。启用 BigQuery 分析会自动追加roles/bigquery.dataOwner等cicd_roles/cicd_sa_deployment_required_rolesCI/CD 服务账号角色按 Cloud Run / GKE 目标动态切换。另外单项目部署模板 single-project/variables.tf 更精简只有project_name、project_id、region三个必改项还多了一个telemetry_logs_filter——用来把 Agent 遥测日志导入 Cloud Logging配合 OpenTelemetry 实现全链路可观测总结5 分钟上手清单命名确认project_name自动生成一般不用管三个项目 IDstaging / prod / cicd快速验证可填同一个生产请分开区域默认us-east1按需修改仓库三件套owner、name、连接名与你的 Git 仓库对齐运行agents-cli infra cicd剩下的交给 Terraform。理解了这 8 个变量你就掌握了 agents-cli 部署体系的地基——从此再看生成的 Terraform 配置任何资源住哪儿、叫什么、连谁一眼就能读懂。【免费下载链接】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），仅供参考