amazon-web-services - 如何使用 CloudFormation 创建文档类型为 'AWS::SSM::Document' 的包

Question

This AWS CloudFormation document建议可以管理 DocumentType 为“Package”的“AWS::SSM::Document”资源。然而，实现这一目标所需的“内容”仍然是个谜。

是否可以通过 CloudFormation 创建“Package”类型的文档，如果可以，作为 CloudFormation 模板(最好使用 YAML 格式)编写的有效 CLI 命令的等效项是什么？

ssm create-document --name my-package --content "file://manifest.json"--attachments Key="SourceUrl",Values="s3://my-s3-bucket"--文档类型包

尝试失败。使用的内容是使用 CLI 选项时提供的 manifest.json 的内联版本。使用 CloudFormation 时似乎没有指定 AttachmentSource 的选项:

AWSTemplateFormatVersion: 2010-09-09

Resources:
  Document:
    Type: AWS::SSM::Document
    Properties:
      Name: 'my-package'
      Content: !Sub |
        {
          "schemaVersion": "2.0",
          "version": "Auto-Generated-1579701261956",
          "packages": {
            "windows": {
              "_any": {
                "x86_64": {
                  "file": "my-file.zip"
                }
              }
            }
          },
          "files": {
            "my-file.zip": {
              "checksums": {
                "sha256": "sha...."
              }
            }
          }
        }
      DocumentType: Package

云形成错误

输入请求中未提供 AttachmentSource。 (服务:AmazonSSM；状态代码:400；错误代码:InvalidParameterValueException；

Answer 1

是的，这是可能的!我已使用 DocumentType: Package 成功创建了一个资源，并且在堆栈成功后，该包会显示在 SSM 控制台的“分发者包”下。

您的 YAML 即将完成，但您还需要包含 Attachments 属性 that is now available .

这是一个工作示例:

AWSTemplateFormatVersion: "2010-09-09"
Description: Sample to create a Package type Document

Parameters:
  S3BucketName:
    Type: "String"
    Default: "my-sample-bucket-for-package-files"
    Description: "The name of the S3 bucket."

Resources:
  CrowdStrikePackage:
    Type: AWS::SSM::Document
    Properties:
      Attachments:
        - Key: "SourceUrl"
          Values:
            - !Sub "s3://${S3BucketName}"
      Content:
        !Sub |
          {
              "schemaVersion": "2.0",
              "version": "1.0",
              "packages": {
                  "windows": {
                      "_any": {
                          "_any": {
                              "file": "YourZipFileName.zip"
                          }
                      }
                  }
              },
              "files": {
                  "YourZipFileName.zip": {
                      "checksums": {
                          "sha256": "7981B430E8E7C45FA1404FE6FDAB8C3A21BBCF60E8860E5668395FC427CE7070"
                      }
                  }
              }
          }
      DocumentFormat: "JSON"
      DocumentType: "Package"
      Name: "YourPackageNameGoesHere"
      TargetType: "/AWS::EC2::Instance"

注意:对于 Attachments 属性，在使用 DocumentType: Package 时必须使用 SourceUrl 键。创建过程将向此 S3 存储桶 URL 附加一个“/”，并将其与 list 中列出的每个文件名(创建包时的 Content 属性)连接起来。