awstoe 运行命令 - EC2 Image Builder
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

awstoe 运行命令

此命令将按照包含在配置文件中的顺序运行 YAML 组件文档脚本。--config参数,或者由--documents参数。

注意

您必须确切指定以下参数之一,不要两项参数:

— config

— 文档

语法

awstoe run [--config <file path>] [--cw-ignore-failures <?>] [--cw-log-group <?>] [--cw-log-region us-west-2] [--cw-log-stream <?>] [--document-s3-bucket-owner <owner>] [--documents <file path,file path,...>] [--execution-id <?>] [--log-directory <file path>] [--log-s3-bucket-name <name>] [--log-s3-bucket-owner <owner>] [--log-s3-key-prefix <?>] [--parameters name1=value1,name2=value2...] [--phases <phase name>] [--state-directory <directory path>] [--version <?>] [--help] [--trace]

参数和选项

参数

— config./config-example.json

简短格式 ፦c./config-example.json

配置文件(有条件). 此参数包含 JSON 文件的文件位置,该文件包含此命令正在运行的组件的配置设置。如果你指定run配置文件中的命令设置,则不能指定--documents参数。有关输入配置的更多信息,请参阅配置输入EC2 TOE运行命令.

有效位置包括:

  • 本地文件路径 (./config-example.json

  • S3 URI (s3://bucket/key

—cw-忽略失败

简短表:不适用

忽略 CloudWatch Logs 中的日志记录失败。

—cw-log 组

简短表:不适用

这些区域有:LogGroupCloudWatch Logs 的名称。

—cw-log 区域

简短表:不适用

这些区域有:Amazon适用于 CloudWatch Logs 的区域。

—cw-log-stream

简短表:不适用

这些区域有:LogStream指示的 CloudWatch Logs 的名称EC2 TOE在哪里直播console.log文件。

— 文档-s3 存储桶所有者

简短表:不适用

基于 S3 URI 的文档的存储桶拥有者的账户 ID。

— 文档./doc-1.yaml./doc-n.yaml

简短表格 ፦d./doc-1.yaml./doc-n

组件文档(有条件). 此参数包含要运行 YAML 组件文档的文件位置的逗号分隔列表。如果您为run使用的命令--documents参数,则不能指定--config参数。

有效位置包括:

  • 本地文件路径 (. /组件doc-示例.yaml)。

  • S3 URI (s3://bucket/key)。

  • Image Builder 组件构建版本 ARN (arn: aw:aw: imageBuilder: us-west-2:123456789012: 组件/我的例子组件/2021.12.02/1)。

注意

列表中的项目之间没有空格,只有逗号。

— 执行编号

简短表格 ፦i

这是适用于当前执行的唯一 IDrun命令。此 ID 包含在输出和日志文件名中,用于唯一标识这些文件,并将它们链接到当前的命令执行。如果忽略了这个设置,EC2 TOE生成 GUID。

— log-Directory

简短表格 ፦l

其中的目标目录EC2 TOE存储此命令执行中的所有日志文件。默认情况下,此目录位于以下父目录中:TOE_<DATETIME>_<EXECUTIONID>. 如果您不指定日志目录,EC2 TOE使用当前的工作目录(.)。

—log-s3 存储桶名

简短表格 ፦b

如果组件日志存储在 Amazon S3 中(推荐),EC2 TOE将组件应用程序日志上传到此参数中命名的 S3 存储桶。

—log-s3 存储桶拥有者

简短表:不适用

如果组件日志存储在 Amazon S3 中(推荐),则这是存储桶的所有者账户 IDEC2 TOE写日志文件。

—log-s3 键前缀

简短表格 ፦k

如果组件日志存储在 Amazon S3 中(推荐),则这是存储桶中日志位置的 S3 对象 key prefix。

--parameters姓名 1=Value1姓名 2=Value2...

简短表:不适用

参数是组件文档中定义的可变变量,具有调用应用程序可在运行时提供的设置。

阶段

简短表格 ፦p

一个逗号分隔的列表,它指定要从 YAML 组件文档中运行哪些阶段。如果组件文档包括其他阶段,那么这些阶段将无法运行。

— 状态目录

简短表格 ፦s

存储状态跟踪文件的文件路径。

--version

简短格式 ፦v

指定组件应用程序版本。

选项

--help

简短格式 ፦h

显示有关使用组件管理应用程序选项的帮助手册。

— 跟踪

简短格式 ፦t

启用详细记录到控制台。