Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tambahkan CloudFormation template ke produk Anda

AWS Marketplace penjual dapat membuat daftar AMI-based produk yang dikirimkan ke AWS Marketplace pembeli dengan menggunakan AWS CloudFormation template. Menambahkan CloudFormation template ke AMI-based produk Anda memungkinkan pembeli untuk menerapkan solusi Anda tanpa harus mengkonfigurasi sumber daya dan dependensi secara manual. Anda dapat menggunakan templat untuk menentukan cluster atau arsitektur didistribusikan untuk produk atau untuk memilih kombinasi AMI yang berbeda atau konfigurasi produk. Solusi AMI tunggal dapat berisi maksimal tiga CloudFormation templat.

Tem CloudFormation plate dapat dikonfigurasi untuk mengirimkan satu Amazon Machine Image (AMI) dengan file konfigurasi terkait dan fungsi Lambda. Selain itu, Anda harus menyertakan diagram arsitektur untuk setiap template.

Mempersiapkan CloudFormation template Anda

Untuk membuat CloudFormation template Anda, Anda harus memenuhi prasyarat template dan memberikan parameter input dan keamanan yang diperlukan. Saat mengirimkan CloudFormation template Anda, gunakan pedoman di bagian berikut.

Prasyarat templat

Persyaratan untuk detail AMI

Saat menentukan ImageId properti sumber daya yang menerapkan AMI Anda ke instans EC2 seperti AWS: :EC2: :Instance,::, dan AWS AWS::AutoScaling: :EC2: LaunchTemplate resource LaunchConfiguration, Anda harus mereferensikan parameter template. https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html Jenis parameter harus berupa aAWS::EC2::Image::Id,AWS::SSM::Parameter::Value<AWS::EC2::Image::Id>, atauString.

Anda dapat memberi nama parameter template ini nama parameter yang valid. AWS Marketplace menyalin template Anda ke bucket Amazon S3 sendiri dan mengganti parameter yang ditentukan dengan parameter Peny AWS Systems Manager impanan Parameter. AWS Marketplace juga memperbarui deskripsi dan teks kendala untuk membuat nilai yang benar jelas bagi pembeli yang menerapkan template. Saat pembeli menerapkan template Anda, parameter tersebut diselesaikan ke ID Wilayah AWS AMI spesifik produk yang Anda publikasikan.

Contoh template berikut menggambarkan parameter template referensi ImageId properti menggunakan fungsi intrinsik Ref.

Contoh YAML:

Parameters:
  ImageId:
    Type: AWS::EC2::Image::Id
    Default: ami-example1234567890
Resources:
  MyInstance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: !Ref ImageId

Contoh JSON:

{
  "Parameters": {
    "ImageId": {
      "Type": "AWS::EC2::Image::Id",
      "Default": "ami-example1234567890"
    }
  },
  "Resources": {
    "MyInstance": {
      "Type": "AWS::EC2::Instance",
      "Properties": {
        "ImageId": {
          "Ref": "ImageId"
        }
      }
    }
  }
}

Jika Anda menerapkan instans EC2 di dalam tumpukan bersar ang alih- alih tumpukan root, ID AMI harus secara dinamis mewarisi nilainya dari tumpukan root. Edit root dan tumpukan bersarang Anda sehingga di tumpukan root, menyetel nilai parameter template Anda menggantikan ID AMI yang digunakan dalam tumpukan bersarang ini.

Persyaratan untuk detail AMI menggunakan formulir pemuatan produk

AMI harus ada dalam tabel pemetaan untuk setiap Wilayah. AWS Marketplace Tim memperbarui ID AMI setelah dikloning. Sumber AMI Anda harus berada di Wil us-east-1 ayah. Wilayah lain dapat menggunakan placeholder.

Contoh YAML:

Mappings: 
  RegionMap: 
      us-east-1: 
          ImageId: ami-0123456789abcdef0
      us-west-1: 
          ImageId: ami-xxxxxxxxxxxxxxxxx
      eu-west-1: 
          ImageId: ami-xxxxxxxxxxxxxxxxx
      ap-southeast-1: 
          ImageId: ami-xxxxxxxxxxxxxxxxx
Resources:
  EC2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: !FindInMap 
        - RegionMap
        - !Ref AWS::Region
        - ImageId

Persyaratan untuk templat tumpukan bersarang

Jika template Anda menyertakan tum pukan bersarang, TemplateURL properti resource tumpukan bersarang harus mereferensikan parameter template untuk nama bucket Amazon S3, Wilayah bucket, dan awalan kunci objek Amazon S3. Nama parameter untuk nama bucket harusMPS3BucketName, Region bucket harusMPS3BucketRegion, dan untuk awalan kunci objek harusMPS3KeyPrefix.

Tetapkan nilai default untuk parameter ini agar sesuai dengan bucket Amazon S3 tempat templat bersarang disimpan. Semua templat bersarang harus dapat diakses publik. Saat Anda mengirimkan template untuk diterbitkan, AWS Marketplace salin templat Anda ke bucket Amazon S3 sendiri dan memodifikasi properti dari ketiga parameter tersebut agar nilai default dan nilai yang diizinkan ditetapkan sesuai dengan tempat penyimpanan salinan. AWS Marketplace juga memperbarui deskripsi dan teks kendala untuk membuat nilai yang benar jelas bagi pembeli yang menerapkan template.

Jika Anda memiliki beberapa level tumpukan bersarang, semua tumpukan bersarang yang membuat tumpukan bersarang tambahan harus dikonfigurasi sehingga TemplateURL properti secara dinamis mewarisi nilai nama bucket Amazon S3, Wilayah bucket Amazon S3, dan kunci objek Amazon S3 dari tumpukan root. Edit root dan tumpukan bersarang Anda sehingga di tumpukan root, mengatur nilai parameter template, MPS3BucketNameMPS3BucketRegion, dan MPS3KeyPrefix mengganti nilainya masing-masing dalam URL yang digunakan dalam tumpukan bersarang ini untuk membuat tumpukan bersarang tambahan.

Contoh template berikut menggambarkan parameter template referensi TemplateURL properti menggunakan fungsi intrinsik Fn:: Sub.

Contoh YAML:

AWSTemplateFormatVersion: '2010-09-09'
Metadata:
  AWS::CloudFormation::Interface:
    ParameterGroups:
      - Label:
          default: AWS Marketplace Parameters
        Parameters:
          - ImageId
          - MPS3BucketName
          - MPS3BucketRegion
          - MPS3KeyPrefix
Parameters:
  ImageId:
    Type: AWS::EC2::Image::Id
    Default: ami-example1234567890
    Description: The AMI that will be used to launch EC2 resources.
  MPS3BucketName:
    Type: String
    Default: sellerbucket
    Description: Name of the S3 bucket for your copy of the nested templates.
  MPS3BucketRegion:
    Type: String
    Default: us-east-1
    Description: AWS Region where the S3 bucket for your copy of the nested templates is hosted.
  MPS3KeyPrefix:
    Type: String
    Default: sellerproductfolder/
    Description: S3 key prefix that is used to simulate a folder for your copy of the nested templates.
Resources:
  EC2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: !Ref ImageId
  NestedStack:
    Type: AWS::CloudFormation::Stack
    Properties:
      TemplateURL: !Sub https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml

Contoh JSON:

{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Metadata": {
        "AWS::CloudFormation::Interface": {
            "ParameterGroups": [
                {
                    "Label": {
                        "default": "AWS Marketplace Parameters"
                    },
                    "Parameters": [
                        "ImageId",
                        "MPS3BucketName",
                        "MPS3BucketRegion",
                        "MPS3KeyPrefix"
                    ]
                }
            ]
        }
    },
    "Parameters": {
        "ImageId": {
            "Type": "AWS::EC2::Image::Id",
            "Default": "ami-example1234567890",
            "Description": "The AMI that will be used to launch EC2 resources."
        },
        "MPS3BucketName": {
            "Type": "String",
            "Default": "sellerbucket",
            "Description": "Name of the S3 bucket for your copy of the nested templates."
        },
        "MPS3BucketRegion": {
            "Type": "String",
            "Default": "us-east-1",
            "Description": "AWS Region where the S3 bucket for your copy of the nested templates is hosted."
        },
        "MPS3KeyPrefix": {
            "Type": "String",
            "Default": "sellerproductfolder/",
            "Description": "S3 key prefix that is used to simulate a folder for your copy of the nested templates."
        }
    },
    "Resources": {
        "EC2Instance": {
            "Type": "AWS::EC2::Instance",
            "Properties": {
                "ImageId": {
                    "Ref": "ImageId"
                }
            }
        },
        "NestedStack": {
            "Type": "AWS::CloudFormation::Stack",
            "Properties": {
                "TemplateURL": {
                    "Fn::Sub": "https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml"
                }
            }
        }
    }
}

Parameter input templat

Jaringan dan parameter keamanan

Setelah template Anda diterima, AWS Marketplace memvalidasi konfigurasi dan informasi produk dan memberikan umpan balik untuk setiap revisi yang diperlukan.

Diagram arsitektur

Anda harus memberikan diagram arsitektur untuk setiap template. Untuk mempelajari lebih lanjut tentang pembuatan diagram, lihat Apa itu diagram arsitektur?

Diagram harus memenuhi kriteria berikut:

Konversi CloudFormation templat produk yang ada

Jika Anda ingin menggunakan pengalaman layanan mandiri untuk memperbarui produk yang sudah ada yang sebelumnya menggunakan formulir pemuatan produk untuk dipublikasikan, Anda harus membuat perubahan pada CloudFormation template yang ada.

Tabel berikut menjelaskan perbedaan antara menggunakan formulir pemuatan produk dan pengalaman layanan mandiri:

Template contoh berikut menggambarkan contoh produk yang ada yang menggunakan formulir pemuatan produk untuk menerbitkan template. Dalam contoh ini, ID AMI adalah ami-example123456 dan template bersarang ada di bucket S3 penjual di lokasihttps://sellerbucket.s3.us-east-1.amazonaws.com/sellerproductfolder/nested-template.yaml.

Contoh YAML yang diterbitkan dengan formulir pemuatan produk:

AWSTemplateFormatVersion: '2010-09-09'
Mappings:
  RegionMap:
    us-east-1:
      AMI: ami-example123456
Resources:
  EC2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: !FindInMap 
        - RegionMap
        - !Ref AWS::Region
        - AMI
  NestedStack:
    Type: AWS::CloudFormation::Stack
    Properties:
      TemplateURL: https://sellerbucket.s3.us-east-1.amazonaws.com/sellerproductfolder/nested-template.yaml

Contoh JSON diterbitkan dengan formulir pemuatan produk:

{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Mappings": {
        "RegionMap": {
            "us-east-1": {
                "AMI": "ami-example123456"
            }
        }
    },
    "Resources": {
        "EC2Instance": {
            "Type": "AWS::EC2::Instance",
            "Properties": {
                "ImageId": {
                    "Fn::FindInMap": [
                        "RegionMap",
                        {
                            "Ref": "AWS::Region"
                        },
                        "AMI"
                    ]
                }
            }
        },
        "NestedStack": {
            "Type": "AWS::CloudFormation::Stack",
            "Properties": {
                "TemplateURL": "https://sellerbucket.s3.us-east-1.amazonaws.com/sellerproductfolder/nested-template.yaml"
            }
        }
    }
}

Contoh template berikut menggambarkan perubahan yang diperlukan untuk menggunakan pengalaman layanan mandiri untuk memperbarui produk.

Contoh YAML yang dipublikasikan dengan pengalaman layanan mandiri:

AWSTemplateFormatVersion: '2010-09-09'
Metadata:
  AWS::CloudFormation::Interface:
    ParameterGroups:
      - Label:
          default: AWS Marketplace Parameters
        Parameters:
          - ImageId
          - MPS3BucketName
          - MPS3BucketRegion
          - MPS3KeyPrefix
Parameters:
  ImageId:
    Type: AWS::EC2::Image::Id
    Default: ami-example123456
    Description: The AMI that will be used to launch EC2 resources.
  MPS3BucketName:
    Type: String
    Default: sellerbucket
    Description: Name of the S3 bucket for your copy of the nested templates.
  MPS3BucketRegion:
    Type: String
    Default: us-east-1
    Description: AWS Region where the S3 bucket for your copy of the nested templates is hosted.
  MPS3KeyPrefix:
    Type: String
    Default: sellerproductfolder/
    Description: S3 key prefix that is used to simulate a folder for your copy of the nested templates.
Resources:
  EC2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: !Ref ImageId
  NestedStack:
    Type: AWS::CloudFormation::Stack
    Properties:
      TemplateURL: !Sub https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml

Contoh JSON diterbitkan dengan pengalaman layanan mandiri:

{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Metadata": {
        "AWS::CloudFormation::Interface": {
            "ParameterGroups": [
                {
                    "Label": {
                        "default": "AWS Marketplace Parameters"
                    },
                    "Parameters": [
                        "ImageId",
                        "MPS3BucketName",
                        "MPS3BucketRegion",
                        "MPS3KeyPrefix"
                    ]
                }
            ]
        }
    },
    "Parameters": {
        "ImageId": {
            "Type": "AWS::EC2::Image::Id",
            "Default": "ami-example123456",
            "Description": "The AMI that will be used to launch EC2 resources."
        },
        "MPS3BucketName": {
            "Type": "String",
            "Default": "sellerbucket",
            "Description": "Name of the S3 bucket for your copy of the nested templates."
        },
        "MPS3BucketRegion": {
            "Type": "String",
            "Default": "us-east-1",
            "Description": "AWS Region where the S3 bucket for your copy of the nested templates is hosted."
        },
        "MPS3KeyPrefix": {
            "Type": "String",
            "Default": "sellerproductfolder/",
            "Description": "S3 key prefix that is used to simulate a folder for your copy of the nested templates."
        }
    },
    "Resources": {
        "EC2Instance": {
            "Type": "AWS::EC2::Instance",
            "Properties": {
                "ImageId": {
                    "Ref": "ImageId"
                }
            }
        },
        "NestedStack": {
            "Type": "AWS::CloudFormation::Stack",
            "Properties": {
                "TemplateURL": {
                    "Fn::Sub": "https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml"
                }
            }
        }
    }
}