# @aws/aws-core-plugin-for-backstage-scaffolder-actions 中文文档

规范地址：https://npmcn.com/package/%40aws/aws-core-plugin-for-backstage-scaffolder-actions/

版本：0\.7\.0
npm 元数据更新时间：2026-08-06T03:37:34.442Z
中文译文更新时间：2026-11-09T20:00:50.861Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aws/aws-core-plugin-for-backstage-scaffolder-actions
原文对照：https://npmcn.com/package/%40aws/aws-core-plugin-for-backstage-scaffolder-actions/?lang=original
项目主页：https://github.com/awslabs/backstage-plugins-for-aws#readme
源码仓库：https://github.com/awslabs/backstage-plugins-for-aws

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：75.1 kB，16 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：13 个
- 首次发布：2024-03-14T02:33:23.487Z
- 最新版本发布：2026-08-06T03:37:34.156Z
- 近 30 天下载量：1761（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 3 个）

## 中文简介

后台 AWS 核心插件的脚手架动作

## 安装

```sh
npm install @aws/aws-core-plugin-for-backstage-scaffolder-actions
```

也可以使用：`pnpm add @aws/aws-core-plugin-for-backstage-scaffolder-actions`、`yarn add @aws/aws-core-plugin-for-backstage-scaffolder-actions`、`bun add @aws/aws-core-plugin-for-backstage-scaffolder-actions`

## README

# AWS 后台脚手架动作插件

这是后台.io的AWS脚手架动作插件.

它提供脚手架动作:

-   [使用 AWS 云控制 API 创建 AWS 资源](https://npmcn.com/package/%40aws/aws-core-plugin-for-backstage-scaffolder-actions/#readme-aws-cloud-control---create-resource)
-   [将事件通过 `PutEvents` API 密码](https://npmcn.com/package/%40aws/aws-core-plugin-for-backstage-scaffolder-actions/#readme-amazon-eventbridge---post-event)
-   [向 Amazon S3 桶发布文件](https://npmcn.com/package/%40aws/aws-core-plugin-for-backstage-scaffolder-actions/#readme-amazon-s3---copy-files)
-   [创建并发布文件到一个新的 AWS 代码承诺寄存器](https://npmcn.com/package/%40aws/aws-core-plugin-for-backstage-scaffolder-actions/#readme-aws-codecommit---publish-repository)

## 安装

本指南假设你熟悉将军 [开始](https://npmcn.com/package/docs/getting-started.md) 并假设您已有后台应用程序.

在您的后台应用程序中安装后端软件包 :

```shell
yarn workspace backend add @aws/aws-core-plugin-for-backstage-scaffolder-actions
```

将脚手架模块添加到 `packages/backend/src/index.ts`数字 :

```typescript
const backend = createBackend();
// ...
backend.add(import('@aws/aws-core-plugin-for-backstage-scaffolder-actions'));
// ...
backend.start();
```

## 行动

每项行动如下:.

### AWS 云控 - 创建资源

这个脚手架动作利用AWS Cloud Control API创建了AWS资源.

注:通常不鼓励利用这一机制建立阿军资源,除非有特殊用途。 我们强烈建议依靠基础设施的现成代码来创建AWS资源,并将这一行动用于任何与严格意义上的拖带项目有关的东西.

#### 权限

后台使用的 IAM 角色需要以下权限:

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["cloudcontrol:CreateResource"],
      "Resource": "*"
    }
  ]
}
```

说明: 这项政策并不反映最不重要的特权,你应该将政策进一步限制在适当的AIS资源范围内.

#### 使用量

脚手架动作可以包含在这样的软件模板中:

```yaml
steps:
  - id: create-ecr-repository
    name: Create ECR Repository
    action: aws:cloudcontrol:create
    input:
      typeName: 'AWS::ECR::Repository'
      desiredState: '{"RepositoryName": "${{ parameters.name }}-ecr-repository"}'
      wait: true
      maxWaitTime: 20
```

### 亚马逊事件- 邮政事件

这个脚手架动作将一个事件张贴到 Amazon EventBridge 事件总线上 `PutEvents` API (英语).

#### 权限

后台使用的 IAM 角色需要以下权限:

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["events:PutEvents"],
      "Resource": "*"
    }
  ]
}
```

说明: 这项政策并不反映最不重要的特权,你应该将政策进一步限制在适当的AIS资源范围内.

#### 使用量

脚手架动作可以包含在这样的软件模板中:

```yaml
steps:
  - id: eventbridge-event
    name: Post EventBridge event
    action: aws:eventbridge:event
    input:
      region: us-east-1
      eventBusName: my-event-bus
      source: my-app
      detailType: MyDetailType
      detail: '{"key": "value"}'
```

您也可以将细节作为对象通过 `detailObject`数字 :

```yaml
steps:
  - id: eventbridge-event
    name: Post EventBridge event
    action: aws:eventbridge:event
    input:
      eventBusName: my-event-bus
      source: my-app
      detailType: MyDetailType
      detailObject:
        key: value
```

### Amazon S3 - 复制文件

这个脚手架动作器复制了从脚手架工作空间到亚马逊S3桶的文件. 默认情况下,它会上传工作空间中的所有文件,所以任何由前步骤生成的内容(例如. `fetch:template`将列入。 使用 `path` 输入以限制哪些文件被复制.

#### 权限

后台使用的 IAM 角色需要以下权限:

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject"],
      "Resource": "*"
    }
  ]
}
```

说明: 这项政策并不反映最不重要的特权,你应该将政策进一步限制在适当的AIS资源范围内.

#### 使用量

脚手架动作可以包含在这样的软件模板中:

```yaml
steps:
  - id: template
    name: Fetch Skeleton
    action: fetch:template
    input:
      url: ./skeleton
      targetPath: ./skeleton
  - id: copyFiles
    name: Copy files to S3
    action: aws:s3:cp
    input:
      bucketName: my-bucket
      region: us-east-1
```

您也可以指定文件模式和前缀 :

```yaml
steps:
  - id: copyFiles
    name: Copy files to s3
    action: aws:s3:cp
    input:
      accountId: '1234567890'
      region: us-east-1
      bucketName: my-bucket
      path: 'build/**'
      prefix: 'artifacts/'
```

### AWS 代码承诺 - 发布寄存器

这个脚手架动作创建了一个新的AWS CodeCommit寄存器,并向它发布工作空间内容.

#### 权限

后台使用的 IAM 角色需要以下权限:

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["codecommit:CreateRepository", "codecommit:CreateCommit"],
      "Resource": "*"
    }
  ]
}
```

说明: 这项政策并不反映最不重要的特权,你应该将政策进一步限制在适当的AIS资源范围内.

#### 使用量

脚手架动作可以包含在这样的软件模板中:

```yaml
steps:
  - id: publish
    name: Publish to CodeCommit
    action: aws:codecommit:publish
    input:
      repositoryName: my-new-repo
      defaultBranch: main
```

有自定义作者和子目录 :

```yaml
steps:
  - id: publish
    name: Publish to CodeCommit
    action: aws:codecommit:publish
    input:
      accountId: '1234567890'
      region: us-west-2
      repositoryName: my-new-repo
      defaultBranch: main
      sourcePath: ./output
      gitCommitMessage: 'Initial scaffolded commit'
      gitAuthorName: Backstage
      gitAuthorEmail: backstage@example.com
```

## 常见问题

### @aws/aws-core-plugin-for-backstage-scaffolder-actions 是什么？

后台 AWS 核心插件的脚手架动作

### 如何安装 @aws/aws-core-plugin-for-backstage-scaffolder-actions？

在项目目录运行 npm install @aws/aws-core-plugin-for-backstage-scaffolder-actions，或使用 pnpm add / yarn add / bun add。

### @aws/aws-core-plugin-for-backstage-scaffolder-actions 支持 TypeScript 吗？

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

### @aws/aws-core-plugin-for-backstage-scaffolder-actions 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @aws/aws-core-plugin-for-backstage-scaffolder-actions 可以商用吗？

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

### @aws/aws-core-plugin-for-backstage-scaffolder-actions 的下载量有多少？

根据 npm 官方下载统计，@aws/aws-core-plugin-for-backstage-scaffolder-actions 在 2026/10/08 – 2026/11/06 这 30 天内被下载 1,761 次，日均约 59 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aws/aws-core-plugin-for-backstage-scaffolder-actions 还在维护吗？

最新版本 0\.7\.0 发布于 2026/08/06（3 个月前）；至今共发布 20 个版本，其中过去 12 个月发布了 3 个；首次发布于 2024/03/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。