Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiungi CloudFormation modelli al tuo prodotto

Marketplace AWS i venditori possono pubblicare offerte di prodotti basati sull'AMI che vengono consegnati agli Marketplace AWS acquirenti utilizzando modelli. AWS CloudFormation L'aggiunta di un CloudFormation modello al prodotto basato su AMI consente agli acquirenti di implementare la soluzione senza dover configurare manualmente le risorse e le dipendenze. È possibile utilizzare i modelli per definire un cluster o un'architettura distribuita per i prodotti o per selezionare diverse combinazioni AMI o configurazioni di prodotto. Le soluzioni AMI singole possono contenere un massimo di tre CloudFormation modelli.

I CloudFormation modelli possono essere configurati per fornire una singola Amazon Machine Image (AMI) con file di configurazione e funzioni Lambda associati. Inoltre, è necessario includere un diagramma architettonico per ogni modello.

Preparazione del modello CloudFormation

Per creare i CloudFormation modelli, è necessario soddisfare i prerequisiti del modello e fornire i parametri di input e sicurezza richiesti. Quando invii il CloudFormation modello, utilizza le linee guida nelle sezioni seguenti.

Prerequisiti del modello

Requisiti per i dettagli dell'AMI

Quando si specifica la ImageId proprietà delle risorse che distribuiscono l'AMI su EC2 istanze come AWS::EC2::Instance, e AWS::EC2::LaunchTemplateresources AWS::AutoScaling::LaunchConfiguration, è necessario fare riferimento a un parametro del modello. Il tipo di parametro deve essere unAWS::EC2::Image::Id, AWS::SSM::Parameter::Value<AWS::EC2::Image::Id> o. String

È possibile assegnare a questo parametro del modello qualsiasi nome di parametro valido. Marketplace AWS copia il modello nei propri bucket Amazon S3 e sostituisce il parametro specificato con un AWS Systems Manager parametro Parameter Store. Quando gli acquirenti implementano il tuo modello, quel parametro viene risolto nell'ID Regione AWS AMI specifico del prodotto pubblicato.

I seguenti esempi di modello illustrano la ImageId proprietà che fa riferimento ai parametri del modello utilizzando la funzione intrinseca Ref.

Esempio YAML:

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

Esempio JSON:

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

Se stai distribuendo EC2 istanze all'interno di uno stack annidato anziché dello stack principale, l'ID AMI deve ereditare dinamicamente il suo valore dallo stack principale. Modifica gli stack root e nidificati in modo che nello stack principale, l'impostazione del valore del parametro del modello abbia la precedenza sull'ID AMI utilizzato in questo stack nidificato.

Requisiti per i dettagli sulle AMI utilizzando il modulo di caricamento del prodotto

AMIs deve trovarsi in una tabella di mappatura per ogni regione. Il Marketplace AWS team aggiorna gli AMI IDs dopo la clonazione. L'AMI di origine deve trovarsi nella us-east-1 regione. Le altre regioni possono utilizzare i segnaposti.

Esempio 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

Requisiti per i modelli di stack annidati

Se il modello include stack nidificati, la TemplateURL proprietà delle risorse dello stack nidificato deve fare riferimento ai parametri del modello per il nome del bucket Amazon S3, la regione del bucket e il prefisso della chiave dell'oggetto Amazon S3. I nomi dei parametri per il nome del bucket devono essereMPS3BucketName, il bucket Region deve essere MPS3BucketRegion e per il prefix della chiave dell'oggetto deve essere. MPS3KeyPrefix

Imposta i valori predefiniti per questi parametri in modo che corrispondano al tuo bucket Amazon S3 in cui sono archiviati i modelli nidificati. Tutti i modelli nidificati devono essere accessibili pubblicamente. Quando invii il modello per la pubblicazione, lo Marketplace AWS copia nei relativi bucket Amazon S3 e modifica i valori predefiniti di questi tre parametri in modo che corrispondano a dove sono archiviate le copie.

Se disponi di più livelli di stack nidificati, tutti gli stack nidificati che creano stack nidificati aggiuntivi devono essere configurati in modo che la TemplateURL proprietà erediti dinamicamente i valori del nome del bucket S3, della regione del bucket S3 e della chiave oggetto S3 dallo stack principale. Modifica gli stack root e nidificati in modo che nella pila principale, imposti il valore del parametro MPS3BucketName template e MPS3KeyPrefix sovrascriva i rispettivi valori nell'URL utilizzato in questo stack nidificato per creare ulteriori stack nidificati. MPS3BucketRegion

I seguenti esempi di modello illustrano la TemplateURL proprietà che fa riferimento ai parametri del modello utilizzando la funzione intrinseca Fn: :Sub.

Esempio 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

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

Parametri di input del modello

Parametri di rete e sicurezza

Dopo aver ricevuto il modello, Marketplace AWS convalida la configurazione e le informazioni del prodotto e fornisce feedback per eventuali revisioni richieste.

Diagramma architettonico

È necessario fornire un diagramma architettonico per ogni modello. Per ulteriori informazioni sulla creazione di diagrammi, vedi Cos'è la creazione di diagrammi di architettura?

Il diagramma deve soddisfare i seguenti criteri:

Converti modelli di prodotti esistenti CloudFormation

Se desideri utilizzare l'esperienza self-service per aggiornare un prodotto esistente che in precedenza utilizzava il modulo di caricamento del prodotto per la pubblicazione, devi apportare modifiche al modello esistente CloudFormation.

La tabella seguente descrive la differenza tra l'utilizzo del modulo di caricamento del prodotto e l'esperienza self-service:

I modelli di esempio seguenti illustrano un esempio di un prodotto esistente che ha utilizzato il modulo di caricamento del prodotto per pubblicare il modello. In questo esempio, l'ID AMI è ami-example123456 e un modello annidato si trova nel bucket S3 del venditore presso la sede. https://sellerbucket.s3.us-east-1.amazonaws.com/sellerproductfolder/nested-template.yaml

Esempio YAML pubblicato con il modulo di caricamento del prodotto:

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

Esempio JSON pubblicato con il modulo di caricamento del prodotto:

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

I seguenti esempi di modelli illustrano le modifiche necessarie per utilizzare l'esperienza self-service per aggiornare il prodotto.

Esempio YAML pubblicato con l'esperienza self-service:

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

Esempio JSON pubblicato con l'esperienza self-service:

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