Amazon EC2 Systems Manager
用户指南
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

创建 Systems Manager 文档

如果 Systems Manager 公有文档限制了您希望对托管实例执行的操作,您可以自行创建文档。创建新文档时,我们建议使用架构版本 2.2 或更高版本。

开始前的准备工作

在创建 SSM 文档之前,我们建议您阅读有关 SSM 文档可用的其他架构、功能和语法的信息。有关更多信息,请参阅 Systems Manager 文档

在创建文档时,您在 JSON 中指定文档内容。开始使用 JSON 最便捷的方式是从 Systems Manager 公有文档中复制现有的示例。

复制 Systems Manager 文档

  1. 在 Amazon EC2 控制台中,展开 Systems Manager Shared Resources,然后选择 Documents

  2. 选择一个文档。

  3. 在下方窗格中,选择 Content 选项卡。

  4. 将 JSON 复制到文本编辑器中,并指定自定义文档的详细信息。

  5. json 文件扩展名保存此文档。

在编写完文档内容后,您可以使用以下任一过程将文档添加到 Systems Manager。

注意

如果您编写的是 Policy 型文档,在将其添加到系统后,必须将该文档与您的托管实例相关联。有关更多信息,请参阅 创建关联

使用 Amazon EC2 控制台添加 Systems Manager 文档

  1. Open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

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

  3. 选择 Create Document

  4. 为文档输入一个描述性名称。

  5. Document Type 列表中,选择您要创建的文档类型。

  6. 删除 Content 字段中的方括号,然后将您之前创建的文档粘贴到这里。

  7. 选择 Create Document 保存文档。

使用 Windows PowerShell 添加 Systems Manager 文档

  1. 如前所述,复制并自定义现有文档。

  2. 使用 AWS Tools for Windows PowerShell 添加文档。

    Copy
    $json = Get-Content C:\your file | Out-String New-SSMDocument -DocumentType Command -Name document name -Content $json

使用 AWS CLI 添加 Systems Manager 文档

  1. 如前所述,复制并自定义现有文档。

  2. 使用 AWS CLI 添加文档。

    Copy
    aws ssm create-document --content file://path to your file\your file --name "document name" --document-type "Command"

    Windows 示例

    Copy
    aws ssm create-document --content file://c:\temp\PowershellScript.json --name "PowerShellScript" --document-type "Command"

    Linux 示例

    Copy
    aws ssm create-document --content file:///home/ec2-user/RunShellScript.json --name "RunShellScript" --document-type "Command"