Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Fügen Sie Ihrem Produkt CloudFormation Vorlagen hinzu

AWS Marketplace Verkäufer können mithilfe von AWS CloudFormation Vorlagen AMI-based Produkte anbieten, die an AWS Marketplace Käufer geliefert werden. Wenn Sie Ihrem AMI-based Produkt eine CloudFormation Vorlage hinzufügen, können Ihre Käufer Ihre Lösung bereitstellen, ohne die Ressourcen und Abhängigkeiten manuell konfigurieren zu müssen. Sie können die Vorlagen dafür verwenden, einen Cluster oder verteilte Architektur für die Produkte zu definieren oder andere AMI-Kombinationen oder Produktkonfigurationen auszuwählen. Einzelne AMI-Lösungen können maximal drei CloudFormation Vorlagen enthalten.

Die CloudFormation Vorlagen können so konfiguriert werden, dass sie ein einzelnes Amazon Machine Image (AMI) mit zugehörigen Konfigurationsdateien und Lambda-Funktionen bereitstellen. Darüber hinaus müssen Sie für jede Vorlage ein Architekturdiagramm hinzufügen.

Ihre CloudFormation Vorlage wird vorbereitet

Um Ihre CloudFormation Vorlagen zu erstellen, müssen Sie die Vorlagenvoraussetzungen erfüllen und die erforderlichen Eingabe- und Sicherheitsparameter angeben. Beachten Sie beim Einreichen Ihrer CloudFormation Vorlage die Richtlinien in den folgenden Abschnitten.

Voraussetzungen für Vorlagen

Anforderungen an AMI-Angaben

Wenn Sie die ImageId Eigenschaft von Ressourcen angeben, die Ihr AMI für EC2-Instances wie AWS: :EC2: :Instance,:: und AWS AWS::AutoScaling: :EC2:: LaunchTemplate -Ressourcen bereitstellen LaunchConfiguration, müssen Sie auf einen Vorlagenparameter verweisen. https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html Der Parametertyp muss entweder ein AWS::EC2::Image::IdAWS::SSM::Parameter::Value<AWS::EC2::Image::Id>, oder seinString.

Sie können diesem Vorlagenparameter einen beliebigen gültigen Parameternamen geben. AWS Marketplace kopiert Ihre Vorlage in seine eigenen Amazon S3-Buckets und ersetzt den angegebenen Parameter durch einen AWS Systems Manager Parameter Store-Parameter. AWS Marketplace aktualisiert außerdem die Beschreibung und den Beschränkungstext, um Käufern, die die Vorlage bereitstellen, den richtigen Wert zu verdeutlichen. Wenn Käufer Ihre Vorlage bereitstellen, wird dieser Parameter in die AWS-Region-spezifische AMI-ID Ihres veröffentlichten Produkts aufgelöst.

Die folgenden Vorlagenbeispiele veranschaulichen die ImageId Eigenschaften, die auf Vorlagenparameter verweisen, mithilfe der systemeigenen Funktion Ref. https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html

YAML-Beispiel:

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

JSON-Beispiel:

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

Wenn Sie EC2-Instances in einem verschachtelten Stack statt im Root-Stack bereitstellen, muss die AMI-ID ihren Wert dynamisch vom Root-Stack erben. Bearbeiten Sie Ihren Stammstapel und Ihre verschachtelten Stacks so, dass im Root-Stack durch das Festlegen des Werts Ihres Vorlagenparameters die in diesem verschachtelten Stack verwendete AMI-ID überschrieben wird.

Anforderungen für AMI-Details mithilfe des Produktladeformulars

AMIs müssen in einer Zuordnungstabelle für jede Region enthalten sein. Das AWS Marketplace Team aktualisiert die AMI-IDs, nachdem sie geklont wurden. Ihr Quell-AMI muss sich in der us-east-1 Region befinden. Die anderen Regionen können Platzhalter verwenden.

YAML-Beispiel:

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

Anforderungen für verschachtelte Stack-Vorlagen

Wenn Ihre Vorlage verschachtelte Stacks enthält, muss die TemplateURL Eigenschaft verschachtelter Stack-Ressourcen auf die Vorlagenparameter für den Amazon S3-Bucket-Namen, die Bucket-Region und das Amazon S3-Objektschlüsselpräfix verweisen. Die Parameternamen für den Bucket-Namen müssen lautenMPS3BucketName, die Bucket-Region muss MPS3BucketRegion lauten und für das Objekt muss das Schlüsselpräfix lauten. MPS3KeyPrefix

Stellen Sie die Standardwerte für diese Parameter so ein, dass sie Ihrem Amazon S3-Bucket entsprechen, in dem Ihre verschachtelten Vorlagen gespeichert sind. Alle verschachtelten Vorlagen müssen öffentlich zugänglich sein. Wenn Sie Ihre Vorlage zur Veröffentlichung einreichen, AWS Marketplace kopiert Ihre Vorlagen in ihre eigenen Amazon S3-Buckets und ändert die Eigenschaften dieser drei Parameter, sodass der Standardwert und der zulässige Wert so eingestellt sind, dass sie dem Speicherort der Kopien entsprechen. AWS Marketplace aktualisiert außerdem die Beschreibung und den Beschränkungstext, um Käufern, die die Vorlage bereitstellen, die richtigen Werte klar zu machen.

Wenn Sie mehrere Ebenen verschachtelter Stacks haben, müssen alle verschachtelten Stacks, die zusätzliche verschachtelte Stacks erstellen, so konfiguriert werden, dass die TemplateURL Eigenschaft die Werte des Amazon S3-Bucket-Namens, der Amazon S3-Bucket-Region und des Amazon S3-Objektschlüssels dynamisch vom Root-Stack erbt. Bearbeiten Sie Ihre Stamm- und verschachtelten Stacks so, dass sie im Stammstapel den Wert des Template-Parameters festlegen und ihre jeweiligen Werte in der URL MPS3KeyPrefix überschreiben MPS3BucketNameMPS3BucketRegion, die in diesem verschachtelten Stack verwendet wird, um zusätzliche verschachtelte Stapel zu erstellen.

Die folgenden Vorlagenbeispiele veranschaulichen die TemplateURL Eigenschaften, die auf Vorlagenparameter verweisen, mithilfe der systemeigenen Funktion Fn: :Sub. https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-sub.html

YAML-Beispiel:

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

JSON-Beispiel:

{
    "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"
                }
            }
        }
    }
}

Eingabeparameter für die Vorlage

Netzwerk- und Sicherheitsparameter

AWS Marketplace Validiert nach Erhalt Ihrer Vorlage die Produktkonfiguration und die Informationen und gibt Feedback für alle erforderlichen Änderungen.

Architektonisches Diagramm

Sie müssen für jede Vorlage ein Architekturdiagramm angeben. Weitere Informationen zur Diagrammerstellung finden Sie unter Was ist Architekturdiagramme?

Das Diagramm muss die folgenden Kriterien erfüllen:

CloudFormation Vorlagen vorhandener Produkte konvertieren

Wenn Sie die Self-Service-Oberfläche nutzen möchten, um ein vorhandenes Produkt zu aktualisieren, für dessen Veröffentlichung zuvor das Produktladeformular verwendet wurde, müssen Sie Änderungen an Ihrer vorhandenen CloudFormation Vorlage vornehmen.

In der folgenden Tabelle wird der Unterschied zwischen der Verwendung des Produktladeformulars und der Self-Service-Erfahrung beschrieben:

Die folgenden Beispielvorlagen veranschaulichen ein Beispiel für ein vorhandenes Produkt, das das Produktladeformular verwendet hat, um die Vorlage zu veröffentlichen. In diesem Beispiel lautet die AMI-ID ami-example123456 und eine verschachtelte Vorlage befindet sich im S3-Bucket eines Verkäufers am Standorthttps://sellerbucket.s3.us-east-1.amazonaws.com/sellerproductfolder/nested-template.yaml.

YAML-Beispiel, das mit dem Produktladeformular veröffentlicht wurde:

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

JSON-Beispiel, das mit dem Produktladeformular veröffentlicht wurde:

{
    "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"
            }
        }
    }
}

Die folgenden Vorlagenbeispiele veranschaulichen die Änderungen, die erforderlich sind, um das Produkt mithilfe der Self-Service-Oberfläche zu aktualisieren.

Ein YAML-Beispiel, das zusammen mit der Self-Service-Erfahrung veröffentlicht wurde:

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

JSON-Beispiel, das mit der Self-Service-Erfahrung veröffentlicht wurde:

{
    "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"
                }
            }
        }
    }
}