AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

将软件包添加到 Distributor

您可以使用 AWS Systems Manager 控制台或 AWS CLI 将新软件包添加到 AWS Systems Manager Distributor。添加软件包时,您添加的是一个新的 SSM 文档。此文档让您能够将软件包部署到托管实例。

添加软件包(控制台)

可使用 AWS Systems Manager 控制台创建软件包。准备好您在步骤 3:将软件包和清单上传到 Amazon S3 存储桶中将软件包上传到的存储桶的 URL。

将软件包添加到 S3(控制台)

  1. 通过以下网址打开 AWS Systems Manager 控制台:https://console.amazonaws.cn/systems-manager/

  2. 在导航窗格中,选择 Distributor

  3. 在 Distributor 主页上,选择 Add package (添加软件包)

  4. Add package (添加软件包) 页面上,输入软件包的名称。软件包名称可以包含字母、数字、句点、短划线和下划线。名称应足够通用,以适用于所有版本的软件包附件,但又足够具体,可用于识别软件包的用途。

  5. Version name (版本名称) 中,输入清单文件中 version 条目的确切值。

  6. (可选)如果未将 JSON 清单上传到存储 ZIP 文件的 S3 存储桶,则可以在 JSON manifest (JSON 清单) 字段中编写清单或粘贴整个 JSON 清单。有关如何创建 JSON 清单的更多信息,请参阅步骤 2:创建 JSON 软件包清单

  7. Package location (软件包位置) 中,粘贴您将软件包内容上传到 S3 时复制的 URL,然后选择 Add package (添加软件包)

添加软件包 (AWS CLI)

可使用 AWS CLI 创建软件包。准备好您在步骤 3:将软件包和清单上传到 Amazon S3 存储桶中将软件包上传到的存储桶的 URL。

将软件包添加到 S3 (AWS CLI)

  1. 要使用 AWS CLI 创建软件包,请运行以下命令,将 package-name 替换为您的软件包名称,将 S3-bucket-URL-to-manifest-file 替换为您在步骤 3:将软件包和清单上传到 Amazon S3 存储桶中复制的 JSON 清单的 URL。S3-bucket-URL-of-package 是存储整个软件包的 S3 存储桶的 URL。在 Distributor 中运行 create-document 命令时,为 --document-type 指定 Package 值。

    如果未将清单文件添加到 S3 存储桶,则 --content 参数值为 JSON 清单文件的全部内容(在引号中)。

    aws ssm create-document --name "package-name" --content "S3-bucket-URL-to-manifest-file" --attachments Key="SourceUrl",Values="S3-bucket-URL-of-package" --version-name version-value-from-manifest --document-type Package

    以下是示例。

    aws ssm create-document --name ExamplePackage --content "https://s3.amazonaws.com/mybucket/ExamplePackage/manifest.json" --attachments Key="SourceUrl",Values="https://s3.amazonaws.com/mybucket/ExamplePackage" --version-name 1.0.1 --document-type Package
  2. 通过运行以下命令验证软件包是否已添加并显示软件包清单,将 package-name 替换为您的软件包名称。要获取文档的特定版本(不同于软件包的版本),可以添加 --document-version 参数。

    aws ssm get-document --name "package-name"

有关可以在 create-document 命令中使用的其他选项的信息,请参阅《AWS Systems Manager section of the AWS CLI Command Reference》中的 create-document。有关可以与 get-document 命令配合使用的其他选项的信息,请参阅 get-document