@geekmidas/云
SST(离子/钚)集成 @geekmidas 应用——有见解,可链接
将1:1地图绘制到可部署部队和 验证其环境
部署前,加上解决链接资源的运行时间助手
环境变量.
两分之一:
@geekmidas/cloud/sst- 那个 临时 构造您在sst.config.ts(单位:千美元)App, (中文(简体) ),Stack, (中文(简体) ),Function, (中文(简体) ),Api, (中文(简体) ),Cron) (中文(简体) ).@geekmidas/cloud编号 :@geekmidas/cloud/utils- 那个 运行时间 帮助者 (单位:千美元)buildResourceEnv, (中文(简体) ),ResourceType变成SSTResource链接为平面 在Lambda内的环境变量.
设计说明和原理
docs/sst-constructs.md(建筑)和docs/sst-testing.md(测试).
安装
pnpm add @geekmidas/cloud
./sst 目标 SST v4 请检查url=值 (帮助) (同类依赖) sst@^4) 并按原样分发
TypeScript source — 它延伸环境 sst.aws.* 仅存在的环球
之后 sst install 在你的应用程序.
@geekmidas/cloud/sst
import { App, Api, Function, Cron } from '@geekmidas/cloud/sst';
应用堆栈( S)
App 是一个简单的同步构造; 在呼叫时解决主控区域
并传递到现场. app.stack(name) 创建一个 Stack 绑在应用程序.
const { zoneId } = await aws.route53.getZone({ name: 'example.com' });
const app = new App({
name: 'my-app',
stage: 'prod',
domain: 'example.com',
hostedZoneId: zoneId,
region: 'us-east-1',
});
const stack = app.stack('api');
stack.logicalPrefixedName('handler'); // "prod-my-app-api-handler"
stack.select({ prod: 'live', default: 'dev' }); // by-stage value with a default
函数
扩展 sst.aws.FunctionArgs (本地选项通过),合并标准
env 默认,默认为 nodejs24.x + JSON 伐木,以及 验证 envVars
反对 links 合成时间 - 只附加一个函数需要的链接
(最少的特权).
const fn = new Function(stack, 'Processor', {
handler: 'src/processor.handler',
links: [db, topic],
envVars: ['DATABASE_URL'], // validated against links; fails synth if missing
});
阿庇语Name
扩展 sst.aws.ApiGatewayV2Args (CORS/域/etc.通过). 路线是
键入的表格,每条路由内嵌验证,最小连接,以及一个键入
授权模式.
const api = new Api(stack, 'Api', {
links: [db],
authorizers: {
jwt: { issuer: 'https://issuer', audiences: ['aud'] }, // 'jwt' → JWT settings
employee: { handler: 'src/employee-auth.handler' }, // custom → Lambda authorizer
},
routes: [
{ method: 'GET', path: '/me', handler: 'me.handler', authorizer: 'jwt' },
{ method: 'GET', path: '/adm', handler: 'adm.handler', authorizer: 'employee' },
{ method: 'POST', path: '/pub', handler: 'pub.handler' }, // public (none)
],
});
一条路线 authorizer 类型限制为 'iam' | 'none' 加上声明
授权人名称——未申报名称是编译错误,以及 jwt 要求 JWT
自定义授权方需要设置时 handler。 。 。 .
克龙
环绕 sst.aws.CronV2 (单位:千美元)sst.aws.Cron 已贬值. processor 是一个
Function (或任何带有 arn(三); schedule 是输入的 cron(…) 编号 :
at(…)。 。 。 .
const cron = new Cron(stack, 'Nightly', { processor: fn, schedule: 'cron(0 0 * * ? *)' });
从a gkm build 显示
gkm build 发布部署清单(类型: @geekmidas/manifest) (中文(简体) ). 每个
构造有静态 fromManifest 将它直接映射到下面的工厂:
import routes from './.gkm/routes-manifest.json';
const api = Api.fromManifest(stack, 'Api', routes, { links: [db], authorizers });
const workers = Function.fromManifest(stack, functionsManifest, { links: [db] });
const crons = Cron.fromManifest(stack, cronsManifest, { links: [db] });
@geekmidas/cloud/utils (运行时间)
import { buildResourceEnv } from '@geekmidas/cloud';
buildResourceEnv 转换 SST 的记录 Resource 连接到平坦环境中
变量,使用共享 ResourceType 词汇.