mcpField
A
adk-infra-expert

adk-infra-expert

github.com/jeremylongshore云与 DevOps2.9k37 次安装2 天前更新
代码仓库

关于 adk-infra-expert

adk-infra-expert 是用于生成和验证 Vertex AI ADK 基础设施 Terraform 配置的技能，面向部署团队，涵盖安全设置并可输出部署清单和验证报告。

主要功能

  1. 01生成并验证 Terraform 模块
  2. 02配置安全 VPC 与 Private Service Connect
  3. 03设置最小权限 IAM
  4. 04配置 Agent Engine、Code Execution 和 Memory Bank
  5. 05启用 VPC Service Controls 并配置监控
  6. 06生成部署验证结果与清单

适用场景

  1. 01为 Vertex AI ADK Agent 配置基础设施
  2. 02落实企业网络与 IAM 限制
  3. 03检查部署组件和配置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill adk-infra-expert

安装后在 Claude Code 中输入/adk-infra-expert确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
ARD.md
errors.md
examples.md
implementation.md
PRD.md
scripts/
init-terraform.sh

详细介绍

ADK 基础设施专家

概述

使用 Terraform 配置生产级 Vertex AI ADK 基础设施：安全网络、最小权限 IAM、Agent Engine 运行时、Code Execution 沙箱默认设置和 Memory Bank 配置。使用此技能生成或验证 Terraform 模块，并创建符合企业安全约束的部署检查清单（需要时包括 VPC Service Controls）。

前提条件

使用此技能前，请确保：

  • 已启用结算功能的 Google Cloud 项目
  • 已安装 Terraform 1.0+
  • 已通过 gcloud CLI 完成身份验证，并具备相应权限
  • 已在目标项目中启用 Vertex AI API
  • 已创建 VPC Service Controls 访问政策（适用于企业）
  • 了解 Agent Engine 的架构和要求

说明

  1. 初始化 Terraform：设置远程状态存储后端
  2. 配置变量：定义 project_id、region 和 Agent 配置
  3. 配置 VPC：创建包含 Private Service Connect 的网络基础设施
  4. 设置 IAM：创建遵循最小权限原则的服务账号
  5. 部署 Agent Engine：配置包含代码执行和 Memory Bank 的运行时
  6. 启用 VPC-SC：应用服务边界以防止数据外泄
  7. 配置监控：设置 Cloud Monitoring 信息中心和警报
  8. 验证部署：测试 Agent 端点并验证所有组件

输出

  • 应用于项目的配置文件或代码更改
  • 确认实现正确的验证报告
  • 所做更改及其原因的摘要

输出格式规范请参阅 Terraform 实现详情。

错误处理

全面的错误处理说明请参阅 ${CLAUDE_SKILL_DIR}/references/errors.md。

示例

详细示例请参阅 ${CLAUDE_SKILL_DIR}/references/examples.md。

资源

评论

支持 Markdown