@framers/agentos-ext-cloud-aws

中文文档

0.1.5发布于 2026/11/11Apache-2.0TypeScriptES Module零依赖构建来源已验证近 30 天下载 2.1万

AWS cloud extension — deploy static sites to S3, manage Lightsail instances, configure Route53 DNS, deploy via Amplify, set up CloudFront distributions, and deploy Lambda functions using direct REST API calls with SigV4 signing.

文档目录12 节

Installation
Usage
Configuration
Tools
awsDeployS3Site
awsCreateLightsail
awsDeployAmplify
awsManageRoute53
awsConfigureCloudFront
awsConfigureLambda
Notes
License

AWS cloud

This pack gives agents tools to deploy S3 sites and Amplify apps, manage Lightsail instances and Route53 DNS, create CloudFront distributions, and deploy or invoke Lambda functions. It uses direct AWS REST API calls with SigV4 signing.

Installation

npm install @framers/agentos-ext-cloud-aws

Peer dependency: @framers/agentos with range >=0.10.40.

Usage

import { AgentOS } from '@framers/agentos';

const agentos = await AgentOS.create({
  extensionManifest: {
    packs: [
      {
        package: '@framers/agentos-ext-cloud-aws',
        options: {
          accessKeyId: process.env.AWS_ACCESS_KEY_ID,
          secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
          region: process.env.AWS_REGION,
        },
      },
    ],
  },
});

Configuration

Option	Secret id	Environment variable	Required	Default
`accessKeyId`	`aws.accessKeyId`	`AWS_ACCESS_KEY_ID`	Yes	Empty string
`secretAccessKey`	`aws.secretAccessKey`	`AWS_SECRET_ACCESS_KEY`	Yes	Empty string
`region`	`aws.region`	`AWS_REGION`	No	`us-east-1`
`secrets`			No	`context.secrets`, then `{}`

Explicit options take precedence over secrets, then environment variables. options.secrets takes precedence over context.secrets.

Tools

Tool	What it does
`awsDeployS3Site`	Deploys a local static site to an S3 bucket with website hosting and public read access.
`awsCreateLightsail`	Creates, lists, or deletes Lightsail instances.
`awsDeployAmplify`	Creates an Amplify app from a Git repository, sets up a branch, and triggers deployment.
`awsManageRoute53`	Adds, removes, upserts, or lists Route53 DNS records and lists hosted zones.
`awsConfigureCloudFront`	Creates a CloudFront distribution for an S3 bucket or custom origin.
`awsConfigureLambda`	Deploys, updates, invokes, or inspects a Lambda function.

`awsDeployS3Site`

Parameter	Type	Required	Description
`bucketName`	string	Yes	S3 bucket name, globally unique.
`sourceDir`	string	Yes	Path to the local directory containing static site files.
`indexDocument`	string	No	Index document filename, default `index.html`.
`errorDocument`	string	No	Error document filename, default `error.html`.
`region`	string	No	Bucket region, uses the configured default if omitted.

`awsCreateLightsail`

Parameter	Type	Required	Description
`action`	string: `create`, `list`, `delete`	No	Action to perform, default `create`.
`instanceName`	string	No	Instance name, required for create and delete.
`blueprintId`	string	No	OS or app image, default `ubuntu_22_04`.
`bundleId`	string	No	Instance size, default `nano_3_0`.
`availabilityZone`	string	No	Availability zone, default `{region}a`.
`userData`	string	No	User data script to run on instance launch.
`tags`	object[]	No	Tags to apply to the instance.
`tags[].key`	string	Yes, within each tag
`tags[].value`	string	Yes, within each tag

`awsDeployAmplify`

Parameter	Type	Required	Description
`appName`	string	Yes	Application name in Amplify.
`repository`	string	Yes	Git repository URL.
`branch`	string	No	Branch to deploy, default `main`.
`oauthToken`	string	No	OAuth or personal access token for private repositories.
`framework`	string	No	Framework preset, auto-detected if omitted.
`buildSpec`	string	No	Amplify build specification, `amplify.yml` content.
`environmentVariables`	object	No	Environment variables as key-value pairs.
`stage`	string	No	Deployment stage, default `PRODUCTION`.

`awsManageRoute53`

Parameter	Type	Required	Description
`action`	string: `add`, `remove`, `upsert`, `list`, `list-zones`	Yes	Action to perform.
`hostedZoneId`	string	No	Hosted zone ID, required for add, remove, upsert, and list.
`recordName`	string	No	DNS record name.
`recordType`	string: `A`, `AAAA`, `CNAME`, `MX`, `TXT`, `NS`, `SOA`, `SRV`, `CAA`	No	DNS record type.
`values`	string[]	No	Record values.
`ttl`	number	No	TTL in seconds, default 300.
`aliasTarget`	object	No	Alias target for Route53 alias records.
`aliasTarget.hostedZoneId`	string	Yes, within `aliasTarget`	Hosted zone ID of the alias target.
`aliasTarget.dnsName`	string	Yes, within `aliasTarget`	DNS name of the alias target.
`aliasTarget.evaluateTargetHealth`	boolean	No	Whether to evaluate target health, default `false`.

`awsConfigureCloudFront`

Parameter	Type	Required	Description
`originDomainName`	string	Yes	Origin domain name.
`originId`	string	No	Custom origin ID, auto-generated if omitted.
`isS3Origin`	boolean	No	Whether the origin is an S3 bucket, default `true`; use `false` for custom origins.
`enabled`	boolean	No	Whether the distribution is enabled, default `true`.
`defaultRootObject`	string	No	Default root object, default `index.html`.
`comment`	string	No	Comment or description for the distribution.
`priceClass`	string: `PriceClass_100`, `PriceClass_200`, `PriceClass_All`	No	Price class controlling edge locations.
`aliases`	string[]	No	Custom domain aliases or CNAMEs.
`viewerProtocolPolicy`	string: `redirect-to-https`, `allow-all`, `https-only`	No	Viewer protocol policy, default `redirect-to-https`.
`originProtocolPolicy`	string: `https-only`, `http-only`, `match-viewer`	No	Custom origin protocol policy, default `https-only`.

`awsConfigureLambda`

Parameter	Type	Required	Description
`action`	string: `deploy`, `invoke`, `get`	No	Action to perform, default `deploy`.
`functionName`	string	Yes	Lambda function name.
`runtime`	string	No	Runtime, required for deploy.
`handler`	string	No	Handler entry point, required for deploy.
`roleArn`	string	No	IAM execution role ARN, required for deploy.
`zipFilePath`	string	No	Path to the zip file containing function code, required for deploy.
`memorySize`	number	No	Memory in MB, default 128, maximum 10240.
`timeout`	number	No	Timeout in seconds, default 30, maximum 900.
`environment`	object	No	Environment variables as key-value pairs.
`description`	string	No	Function description.
`invokePayload`		No	Payload to send for the invoke action.

Notes

Activation fails when either credential is missing and validates supplied credentials through STS GetCallerIdentity.

S3 deployment removes the bucket's public access block, enables website hosting, applies a public-read policy, and recursively uploads local files. The service sends file buffers as base64 text and returns an HTTP website URL.

Lightsail creation and deletion, DNS changes, Amplify deployment, CloudFront creation, and Lambda deployment or invocation change remote resources. Lightsail requires instanceName for creation and deletion. Route53 changes require hostedZoneId, recordName, recordType, and either nonempty values or aliasTarget.

Amplify deployment creates an app and triggers deployment without waiting for completion. CloudFront aliases return instructions for CNAME records and an ACM certificate in us-east-1; the tool does not provision that certificate.

Lambda deployment reads a local zip archive and requires runtime, handler, roleArn, and zipFilePath. An existing function has its code and configuration updated. The memory and timeout maxima in the schema descriptions are not enforced locally.

License

Apache-2.0

版本与发布记录

@framers/agentos-ext-cloud-aws 共发布 6 个版本，首次发布于 2026/05/02；过去 12 个月发布了 6 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本	发布日期	距今
`0.1.5`latest	2026/11/11	4 天前
`0.1.4`	2026/10/21	25 天前
`0.1.3`	2026/10/12	1 个月前
`0.1.2`	2026/10/11	1 个月前
`0.1.1`	2026/10/08	1 个月前
`0.1.0`	2026/05/02	6 个月前

关于 @framers/agentos-ext-cloud-aws 的常见问题

@framers/agentos-ext-cloud-aws 是什么？

如何安装 @framers/agentos-ext-cloud-aws？

在项目目录运行 npm install @framers/agentos-ext-cloud-aws，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@framers/agentos（>=0.10.40）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

@framers/agentos-ext-cloud-aws 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@framers/agentos-ext-cloud-aws 支持 ESM 还是 CommonJS？

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

@framers/agentos-ext-cloud-aws 需要什么版本的 Node.js？

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

@framers/agentos-ext-cloud-aws 可以商用吗？

@framers/agentos-ext-cloud-aws 使用 Apache-2.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

@framers/agentos-ext-cloud-aws 的下载量有多少？

根据 npm 官方下载统计，@framers/agentos-ext-cloud-aws 在 2026/10/16 – 2026/11/14 这 30 天内被下载 20,740 次，日均约 691 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@framers/agentos-ext-cloud-aws 还在维护吗？

最新版本 0.1.5 发布于 2026/11/11（4 天前）；至今共发布 6 个版本，其中过去 12 个月发布了 6 个；首次发布于 2026/05/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

npm install @framers/agentos-ext-cloud-aws

pnpmpnpm add @framers/agentos-ext-cloud-aws
yarnyarn add @framers/agentos-ext-cloud-aws
bunbun add @framers/agentos-ext-cloud-aws

peer 依赖@framers/agentos >=0.10.40

npm 7+ 与 pnpm 8+ 会自动安装必需的 peer 依赖，Yarn 需手动安装。

在你的项目目录中运行此命令。

近 30 天下载

20,740

约 2.1万次日均 691 次

统计周期 2026/10/16 – 2026/11/14
数据来自 npm 官方下载统计，今天更新

最新版本0.1.5发布于 4 天前

开源许可Apache-2.0宽松许可

包体积175 kB40 个文件 · 解压后

运行依赖0 个另有 1 个 peer 依赖

模块格式ES Module

TypeScript自带类型

Node.js>=22

发布版本6 个近 12 个月 6 个

首次发布2026/05/026 个月前

元数据更新2026/11/11

每一个软件包背后，
都有分享与创造的人。