@grada-run/grada

中文文档
0.49.8发布于 2026/11/17MITES Module构建来源已验证近 30 天下载 6258

提供生产准备的AWS基础设施和CI/CD管线,分秒提供.

中文使用文档
文档目录15 节
  1. 问题
  2. 解决办法
  3. * 特性
  4. 文档和指南
  5. QQ 快速启动
  6. QQ CLI 命令参考
  7. 生成的文件结构
  8. 参考执行
  9. AI 上下文管理(主讲人,Roo代码,Trae,副驾驶,Windsurf,克洛德,Goose,Aider,续作)
  10. QQ AI 代理 MCP 服务器
  11. 遥测和隐私
  12. * 路线图
  13. 第10阶段:完成第0天至第N天寿命周期掌握(完成——19/19)
  14. 第11阶段: grada.run Rebrand, 每日可观察性和活性生态系统(当前)
  15. 许可证

Grada logo

格莱塔 格莱塔

零锁出云出相. 在60秒内从昂贵的 PaaS 平台将您的集装箱化网络应用弹出到可生产、可大量使用的AWS 基础设施.

NPM Version Node.js Support Security: Trivy License: MIT


问题

由Vercel,Heroku,或Render等管理平台提供快速的初始部署,但成本随座位定价,计算盖和带宽标记而迅速升级.

直接向AWS迁移可提高成本效益并控制基础设施。 然而,为ECS集群,应用负载平衡器,CloudFront分布以及无密钥的CI/CD管线设计原始的Terraform通常需要写出数百行复杂的锅炉平板基础设施代码.

解决办法

grada 是一个互动的CLI,可以简化进程。 它分析您的项目需求并生成 干净、可读和完全可弹出 Terraform 和 GitHub 动作工作流程 直接在您的仓库里.

您保留了您的基础设施代码的完整所有权而不依赖于黑盒平台.


* 特性

* 零计算部署

  • 框架不可知性: 10个支持框架的定制集装箱预设——Node.js/Express,NestJS,Next.js,Nuxt 3,SvelteKit,Python/FastAPI,Django,Rails,Go,以及Statistic Sites(React,Vue,Astro).
  • 智能发现 : 自动检测构建出输出目录并生成高度优化的多相多相多克文件.
  • 迁移引擎 : 土生土长的 Heroku Procfile 组合, vercel.json 路线规则,和 docker-compose.yml 侧车结构可以自动地将其翻译为AWS地形,跨越所有三个计算目标(Fargate + ALB,Lambda + API Gateway,或为零计算 S3 + CloudFront).
  • 数据库脚手架 : 自动为后端单片提供完全隔离,零信任的 AWS 数据库 — RDS PostgreSQL 16, RDS MySQL 8. 0, 或 Aurora PostgreSQL Serverless v2 并有 0–2 ACU 缩放为 0 ()--db-engine,或者用每引擎成本提示进行交互选择).
  • 依赖性- 警觉 : 扫描您数据库、工人、迁移和附加信号的列表,然后提示 —— 预先选择数据库问题、预先填充工人命令、预先检查检测到的附加物和证据、提供迁移门—— 或将堆栈与 --with 在无头模式下.

& 安全性

  • 自动 Trevy 扫描 : 对每个GitHub动作进行集成的IaC和容器脆弱性扫描.
  • 连续 IaC 验证 : 矩阵式管道脚手架 所有10个支持的框架 毫无头绪 每一个承诺的大门 terraform validate, (中文(简体) ), tflint,并屏蔽 Trivy 配置扫描 — HHI/CRITICaltical 错配置失败构建(容器图像扫描仍为咨询),可本地复制 npm run test:iac。 。 。 .
  • 硬化容器: 多相的阿尔卑斯山构建了滴入根权限(包括 nginx-unprivileged 用于静态站点)和从最终图像中取出条形包管理器. 为了通过ECS Exec(见ADR-0012).
  • 零秘密CI/CD: 使用AWS IAM OpenID Connect(OIDC)进行自动化部署——在 GitHub 中没有长寿的 AWS 键.
  • 内建保密管理器: 推动本地 .env 变量进入加密的 AWS 秘密管理器金库,将其拉回新机器,并审计本地-vs-远程漂移——单速滚动的ECS重启只值旋转.

AWS 原生建筑

  • 生产默认 : 提供Amazon ECS Fargate集群,由应用程序负载平衡器覆盖多个可用区.
  • 无服务器目标 : 更喜欢比零? --target lambda (或交互快取)生成一个Lambda + API Gateway HTTP API v2地貌,通过Lambda Web适配器运行同一容器-$0/mo闲取计算,并改编了第2天的命令和文件中的Fargate-vs-Lambda取舍指南.
  • 零计算静态目标 : --target static 主机静态站台框架(Vite、Astro、SPA出口)和检测到的静态出口(Next.js) output: 'export'缩写 adapter-static)在CloudFront后有源入控制装置的私人S3桶上——没有VPC,没有容器,没有多克文件,0.00美元/莫闲置基线. 任何其它的都以验证错误被否决,管道在每次推力上都会被构建,同步并失效.
  • 全球边缘加速 : 集成AWS CloudFront CDN发售与SSL终止和边缘缓存.
  • 模块化 Day-2 Addons : 附加私有的 S3 存储器 (add storage:s3),无服务器的 DynamoDB(add db:dynamodb),Valkey缓存(add db:redis), SQS 队列(add queue:sqs), Bedrock AI访问(英语:add ai:bedrock),或SES交易电子邮件(add email:ses输入之后的任何时候——不使用Terraform手写,并包括集装箱管线——加上预定的克龙作业(add cron运行一次性的Fargate任务 在事件布里奇时间表.
  • 成本可观察性( O) : 保持AWS在每条规定前的固定基线成本预览,明确14天的"云表"日志保留,以及自动生成的5XX出错提醒前的可见度. status 使活出金色信号--watch 喷漆, alerts 脚手架 SNS 电子邮件和 Slack/Discord webhook 在每个计算目标上的通知,暂停闲置环境并使用一个命令(sleep编号 :wake),并看到准确的小时节省,并用预定的IaC漂流探测器捕捉出频控制台的变化(drift) (中文(简体) ).

开发者经验

  • 0 供应商锁定 : 生成标准, 可读的 Terraform ().tf)档案. 你拥有基础设施.
  • 原生 S3 状态锁定 : 使用现代 Terraform 货币锁定自动创建加密的 S3 状态桶 .
  • 安全迭代 : 同上,CLI安全备份现有配置 .bak 用于保证零数据损失的文件.
  • Ephemeral PR预览( Opt- In) : 自动旋转完全隔离的 AWS 环境用于每个 Pull 请求,并将现场预览 URL 发布到 GitHub, 加速团队代码审查.
  • IDE AI 整合: 自动生成Cursor、Windsurf、Copilot和Claude的背景和目标意识规则,以防止Terraform 幻觉——现在有主动的护栏(自动) terraform validate,秘密审计提醒,并在构建输出变化时应用活度.

* * 第2天操作

  • 观察和问题检查( T) : 流出云表日志( E)logs --tail --error -f检查服务健康(status自动diagnose (d) 在运行的容器中打开一发炮弹(exec)——不离开终点站.
  • 数据库生命周期 : 隧道进入您的私人数据库( T)db connect,与 mysql:// URIs和Aurora集群发现),运行于VPC内部的迁移(db migrate,自动检测,或用电线接入CI --setup-ci),启用 pgvector 人工智能嵌入(db enable-vector),现有数据流(db import --file/--from,通过一个临时的SSM隧道)并快照并恢复它(db backup, (中文(简体) ), db restoreAurora的集群意识.
  • 成本控制与安全: 暂停闲置环境( N)sleep [env]编号 :wake [env],带有精确的节省和RDS自动启动后卫),赶上出带控制台的改变(drift,或每日与 drift --setup(b) 清理孤儿资源gc,并恢复到先前的部署(rollback [revision](原始内容存档于2013-10-12) (中文(简体) ). with live progress).

文档和指南

从PaaS到AWS的过渡涉及几起建筑转变. 从我们开始 现场文件网站 用于完整的CLI参考、指南和迁移。 我们还写了简明指南 帮助你理解 grada 处理举重:


QQ 快速启动

在您的工程根中直接运行 CLI :

npx grada-run

交互式向导将分析您的代码库, 检测您的框架, 估计您的 AWS 成本, 并生成您的 Terraform 和 GitHub 动作配置 .


QQ CLI 命令参考

grada 管理您的基础设施的整个生命周期。 每个命令都链接到其全部参考文献——旗帜,示例,以及环境覆盖.

命令它会做什么
apply (单位:千美元)deploy(中文(简体) )提供您的 AWS 基础设施并打印实时 URL(--dry-run 预览地貌和成本; 拒绝睡眠环境 --force) (中文(简体) ).
secrets push 编号 : pull 编号 : audit加密 .env 文件输入密件管理器,同步它们返回,然后 diffs 漂移.
doctor验证多克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克.
diagnose (单位:千美元)wtf(中文(简体) )解释停止任务及其日志中ECS部署失败的原因.
logs流出云表日志--tail, (中文(简体) ), -f, (中文(简体) ), --error, (中文(简体) ), --since) (中文(简体) ).
status健康仪表板 现场金色信号 自动diagnose 关于退化, --json 用于脚本,以及 --watch 为活再油漆.
rollback将实时服务返回到先前的任务修改中, 并有实时进度( 仅限 ECS) .
exec在运行中的容器中通过会话管理器打开 shell(仅限ECS).
run在VPC内部的新鲜可支配容器中运行一次性指令——回填,种子,管理员脚本——并有活日志(仅限ECS).
db connect打开 a localhost 连接您的私人数据库( PostgreSQL、 MySQL 或 Aurora) 的隧道.
db migrate运行 VPC (自动检测) 内部的迁移或安装 CI 预部署门.
db enable-vector启用 pgvector 用于安装一次性 VPC 任务的AI .
db import在 SSM 隧道上将本地垃圾堆或远程数据库流入您的私人实例 .
db backup 编号 : db restore快照检查站和以Terraform为支撑的恢复(Aurora的集群意识).
gc删除孤儿的ECR图像、日志组和EIP——先干后,明确确认(或 --yes(三); --deep 审计VPC,秘密, 和州桶只报告.
sleep 编号 : wake暂停环境计算为0美元,并恢复精确的复制计数(--skip-db, (中文(简体) ), --no-wait, (中文(简体) ), --strict) (中文(简体) ).
drift旗外AWS在本地或每日在CI中更改(--setup) (中文(简体) ).
alerts脚手架上有一个SNS主题+提醒,每个目标都有电子邮件和聊天-webhook发送(--email, (中文(简体) ), --webhook, (中文(简体) ), --threshold) (中文(简体) ).
add附上S3, DynamoDB, Redis, SQS, Bedrock, SES, 预定的克龙任务, 或关系数据库(db:postgres, (中文(简体) ), db:mysql, (中文(简体) ), db:aurora-postgresql)不写"Terraform".
domain附加带有自动ACM TLS(Route 53或外部DNS)的自定义域.
destroy撕下AWS资源以停止计费(状态桶可选择保留).
eject条纹 grada 元数据,留下纯Terraform and Action 文件.
--headlessCI/CD全程方案运行--target, (中文(简体) ), --with, (中文(简体) ), --db-engine, (中文(简体) ), --setup-ci-migrate, (中文(简体) ), --setup-ci-drift, (中文(简体) ), --setup-ci-plan, (中文(简体) ), --offline) (中文(简体) ).
sync-ai生成您的堆栈的 IDE 助手规则( Cursor, Copilot, Windsurf, Claude) .
mcp为AI代理(STDIO/HTTP)服务或安装编辑器配置的MCP服务器(--install) (中文(简体) ).

生成的文件结构

运行 CLI 将模块化, DevSecOps 硬化的架构无缝地整合到您的寄存器中 :

your-project/
├── Dockerfile                  # Multi-stage container preset
├── .dockerignore               # Prevents secret leaks into container builds
├── .gitignore                  # Automatically updated to ignore tfstate and .bak files
├── .github/
│   └── workflows/
│       ├── deploy.yml          # Keyless OIDC CI/CD deployment pipeline
│       ├── drift.yml           # Scheduled IaC drift detection (opt-in via `--setup-ci-drift` or `drift --setup`)
│       └── plan.yml            # Terraform plan comments on PRs (via `--setup-ci-plan`, on by default interactively)
└── terraform/
    ├── main.tf                 # ECR repository + compute (ECS Cluster/Fargate Task, Lambda + API Gateway with `--target lambda`, or S3 + CloudFront with `--target static`)
    ├── network.tf              # VPC, Public Subnets, ALB, and Security Groups
    ├── cloudfront.tf           # CloudFront CDN edge distribution
    ├── domain.tf               # Custom domain + ACM certificate (via `domain add`, when configured)
    ├── oidc.tf                 # GitHub Actions keyless IAM OIDC Provider & Roles
    ├── secrets.tf              # AWS Secrets Manager integration
    ├── backend.tf              # S3 Remote State backend with native locking
    ├── database.tf             # Managed database — RDS PostgreSQL/MySQL or Aurora Serverless v2 (backend frameworks only)
    ├── worker.tf               # Background worker service (ECS Procfile projects only)
    ├── s3.tf / dynamodb.tf / redis.tf / sqs.tf / bedrock.tf / ses.tf / cron.tf   # Modular addons via `grada add` (when added)
    └── secret_keys.json        # Dynamic key map for injected environment variables

参考执行

  • 下一个.js Fullstack App数字 : 一个完整的 Next.js 部署显示生成的 Terraform, CloudFront 设置, 和自动的 OIDC 工作流程.
  • Docker 写入 AWS 迁移数字 : 显示本地文本的自动翻译 docker-compose.yml 侧车( 如 Redis) 成为多容器 AWS ECS 任务定义 localhost。 。 。 .
  • Heroku 到 AWS 迁移 (Django)数字 : 一个经典的"Heroku"风格的单体通过Procfile导入器迁移.
  • Zero-Secret AWS 秘密管理器注入数字 : 一个生产级的Node.js架构,演示了零平面文字秘密注射. 加密当地 .env 变量直接输入AWS,并将其映射入容器后缀的ECS内存,对照GitHub的API进行验证.

👉 查看我们实例库中所有 14+ 的引用执行


AI 上下文管理(主讲人,Roo代码,Trae,副驾驶,Windsurf,克洛德,Goose,Aider,续作)

AI编码助理是不可思议的,但他们常常会幻觉自定义的Terraform或原始的AWS CLI命令可以打破你的基础设施状态. grada 通过提供严格的部署规则和具体项目的背景(如您准确的AWS区域和集装箱港),在您的IDE中直接拦截并引导AI代理.

如何运作:

  • 快速启动流程 : CLI 默默的自动检测, 如果您正在您的存储器中使用 AI 工具并安全地注入上下文 .
  • 高级流程 : 明确要求您选择您的团队使用的 AI 助手 .
  • 独立命令 : 你们可以跑 npx grada-run sync-ai 随时有选择地在以后产生这些规则.

安全性与非破坏性 : 我们使用孤立的规则文件( 如 .cursor/rules/grada.mdc)或严格划定的区块(<!-- BEGIN GRADA CONTEXT --> . <!-- END GRADA CONTEXT -->),以确保你的团队现有的代理指令,编码标准和项目提示是 从未覆盖。 。 。 .

QQ AI 代理 MCP 服务器

grada 本地船舶 示范背景协议 这样AI助手就可以直接检查和操作您的基础设施——堆栈分析,附加供给,活状态,日志,以及秘密漂移. 不需要托管 : 您的代理商根据需求在当地生成它 .

一个命令安装 (将服务器条目写入您的编辑器的 MCP 配置 ):

npx grada-run mcp --install cursor        # → ~/.cursor/mcp.json
npx grada-run mcp --install vscode        # → user mcp.json (default profile)
npx grada-run mcp --install claude-desktop # → Claude Desktop config
npx grada-run mcp --install windsurf      # → ~/.codeium/windsurf/mcp_config.json
npx grada-run mcp --install zed           # → ~/.config/zed/settings.json
npx grada-run mcp --install gemini-cli    # → ~/.muse/settings.json

手动配置 (任何其他 MCP 客户端 — Claude 代码插件 Cline, 继续):

{
    "mcpServers": {
        "grada": { "command": "npx", "args": ["grada-run", "mcp"] }
    }
}

MCP登记列表(Smithery, mcp.so, Glama, Anthropic 目录)正在进行;自定义的GPT路径通过自办的HTTP运输(--transport http在你自己的地道后边.


遥测和隐私

默认, grada 收集匿名和散列使用数据来帮助改进CLI(例如所使用的框架预设,部署成功率). 从未收集过密码库文件、AWS证书或个人数据.

持续选择退出此机( 覆盖每次运行, 包括编辑器 MCP 服务器 ):

grada telemetry off

选择退出单跑,请附加旗:

npx grada-run --no-telemetry

通过环境选择退出,设置 DO_NOT_TRACK=1。随时检查当前状态 grada telemetry status。 。 。 .


* 路线图

第10阶段:完成第0天至第N天寿命周期掌握(完成——19/19)

目标: 零相机生产独立. 消除最终的建筑,数据,操作触发器,迫使开发者在整个应用生命周期打开AWS管理控制台.

第11阶段: grada.run Rebrand, 每日可观察性和活性生态系统(当前)

目标: 向平台身份过渡 格拉达grada.run(中文(简体) ),用零成本的 Cloud Watch Golden Signals 关闭日常可观察性差距,消除跨指令状态-过渡错误,并启动本地的MCP和AI Agent插件生态系统.

👉 看什么是运出,什么是下一个 在完整的路线图


许可证

分发于 MIT 许可证。见 自由主义 更多信息.

版本与发布记录

@grada-run/grada 共发布 51 个版本,首次发布于 2026/09/29;过去 12 个月发布了 51 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.49.8latest2026/11/17今天
0.49.72026/11/161 天前
0.49.62026/11/152 天前
0.49.52026/11/143 天前
0.49.42026/11/134 天前
0.49.32026/11/125 天前

关于 @grada-run/grada 的常见问题

@grada-run/grada 是什么?

提供生产准备的AWS基础设施和CI/CD管线,分秒提供.

如何安装 @grada-run/grada?

在项目目录运行 npm install @grada-run/grada,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 grada、grada-run、deploy-stack,可以用 npx grada 直接运行。

@grada-run/grada 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/grada-run__grada 是否存在。

@grada-run/grada 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@grada-run/grada 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@grada-run/grada 可以商用吗?

@grada-run/grada 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@grada-run/grada 的下载量有多少?

根据 npm 官方下载统计,@grada-run/grada 在 2026/10/17 – 2026/11/15 这 30 天内被下载 6,258 次,日均约 209 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@grada-run/grada 还在维护吗?

最新版本 0.49.8 发布于 2026/11/17(今天);至今共发布 51 个版本,其中过去 12 个月发布了 51 个;首次发布于 2026/09/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。