Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Empiler à partir d' CloudFormation un modèle \$1 Créer
Créez une pile en pointant vers un modèle personnalisé CloudFormation (CFN) dans un compartiment S3 ou en collant le contenu de ce modèle comme entrée pour ce type de modification.
**Classification complète :** Déploiement \$1 Ingestion \$1 Stack from CloudFormation Template \$1 Créer
## Détails du type de modification
****
| | |
| --- |--- |
| Modifier l'identifiant du type | ct-36cn2avfrrj9v |
| Version actuelle | 2.0 |
| Durée d'exécution prévue | 360 minutes |
| Approbation AWS | Obligatoire |
| Approbation du client | Facultatif |
| Mode d'exécution | Automatisé |
## Informations supplémentaires
### Création d'une CloudFormation pile d'ingestion
#### Création d'une pile d' CloudFormation ingestion à l'aide de la console
![\[Create Stack From CloudFormation Template interface showing description, ID, and version.\]](http://docs.aws.amazon.com/fr_fr/managedservices/latest/ctref/images/guiCfnIngestCT.png)
**Pour créer une pile d' CloudFormation ingestion à l'aide de la console**
1. Accédez à la page **Créer une RFC** : Dans le volet de navigation de gauche de la console AMS, cliquez **RFCs**pour ouvrir la page de RFCs liste, puis cliquez sur **Créer une RFC**.
1. Choisissez un type de modification (CT) populaire dans la vue **Parcourir les types de modification** par défaut, ou sélectionnez un CT dans la vue **Choisir par catégorie**.
+ **Parcourir par type de modification** : vous pouvez cliquer sur un CT populaire dans la zone de **création rapide** pour ouvrir immédiatement la page **Run RFC**. Notez que vous ne pouvez pas choisir une ancienne version CT avec création rapide.
Pour trier CTs, utilisez la zone **Tous les types de modifications** dans l'affichage **Carte** ou **Tableau**. Dans l'une ou l'autre vue, sélectionnez un CT, puis cliquez sur **Créer une RFC** pour ouvrir la page **Exécuter une RFC**. Le cas échéant, une option **Créer avec une ancienne version** apparaît à côté du bouton **Créer une RFC**.
+ **Choisissez par catégorie** : sélectionnez une catégorie, une sous-catégorie, un article et une opération et la zone de détails du CT s'ouvre avec une option permettant de **créer avec une ancienne version**, le cas échéant. Cliquez sur **Créer une RFC** pour ouvrir la page **Exécuter une RFC**.
1. Sur la page **Run RFC**, ouvrez la zone de nom du CT pour voir la boîte de détails du CT. Un **sujet** est requis (il est renseigné pour vous si vous choisissez votre CT dans la vue **Parcourir les types de modification**). Ouvrez la zone **de configuration supplémentaire** pour ajouter des informations sur le RFC.
Dans la zone **Configuration de l'exécution**, utilisez les listes déroulantes disponibles ou entrez des valeurs pour les paramètres requis. Pour configurer les paramètres d'exécution facultatifs, ouvrez la zone **de configuration supplémentaire**.
1. Lorsque vous avez terminé, cliquez sur **Exécuter**. S'il n'y a aucune erreur, la page **RFC créée avec succès** s'affiche avec les détails de la RFC soumise et le résultat d'**exécution** initial.
1. Ouvrez la zone **Paramètres d'exécution** pour voir les configurations que vous avez soumises. Actualisez la page pour mettre à jour l'état d'exécution de la RFC. Vous pouvez éventuellement annuler la RFC ou en créer une copie à l'aide des options en haut de la page.
#### Création d'une pile d' CloudFormation ingestion à l'aide de la CLI
**Pour créer une pile d' CloudFormation ingestion à l'aide de la CLI**
1. Utilisez soit le Inline Create (vous émettez une `create-rfc` commande avec tous les paramètres RFC et d'exécution inclus), soit le Template Create (vous créez deux fichiers JSON, un pour les paramètres RFC et un pour les paramètres d'exécution) et émettez la `create-rfc` commande avec les deux fichiers en entrée. Les deux méthodes sont décrites ici.
1. Soumettez la `aws amscm submit-rfc --rfc-id ID` commande RFC : avec l'ID RFC renvoyé.
Surveillez la `aws amscm get-rfc --rfc-id ID` commande RFC :.
Pour vérifier la version du type de modification, utilisez cette commande :
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
```
**Note**
Vous pouvez utiliser n'importe quel `CreateRfc` paramètre avec n'importe quelle RFC, qu'ils fassent ou non partie du schéma du type de modification. Par exemple, pour recevoir des notifications lorsque le statut de la RFC change, ajoutez cette ligne `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` aux paramètres RFC de la demande (et non aux paramètres d'exécution). Pour obtenir la liste de tous les CreateRfc paramètres, consultez le manuel [AMS Change Management API Reference](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html).
1. Préparez le CloudFormation modèle que vous utiliserez pour créer la pile et téléchargez-le dans votre compartiment S3. Pour obtenir des informations importantes, consultez les [directives, CloudFormation les meilleures pratiques et les limites d'AWS Ingest](https://docs.aws.amazon.com/managedservices/latest/appguide/cfn-author-templates.html).
1. Créez et soumettez le RFC à AMS :
1. Créez et enregistrez le fichier JSON des paramètres d'exécution, incluez les paramètres du CloudFormation modèle que vous souhaitez. L'exemple suivant le nomme CreateCfnParams .json.
Exemple de fichier CreateCfnParams .json de pile d'applications Web :
```
{
"Name": "cfn-ingest",
"Description": "CFNIngest Web Application Stack",
"VpcId": "VPC_ID",
"CloudFormationTemplateS3Endpoint": "$S3_URL",
"TimeoutInMinutes": 120,
"Tags": [
{
"Key": "Enviroment Type"
"Value": "Dev",
},
{
"Key": "Application"
"Value": "PCS",
}
],
"Parameters": [
{
"Name": "Parameter-for-S3Bucket-Name",
"Value": "BUCKET-NAME"
},
{
"Name": "Parameter-for-Image-Id",
"Value": "AMI-ID"
}
],
}
```
Exemple de CreateCfnParams fichier .json de rubrique SNS :
```
{
"Name": "cfn-ingest",
"Description": "CFNIngest Web Application Stack",
"CloudFormationTemplateS3Endpoint": "$S3_URL",
"Tags": [
{"Key": "Enviroment Type", "Value": "Dev"}
],
"Parameters": [
{"Name": "TopicName", "Value": "MyTopic1"}
]
}
```
1. Créez et enregistrez le fichier JSON des paramètres RFC avec le contenu suivant. L'exemple suivant le nomme fichier CreateCfnRfc .json :
```
{
"ChangeTypeId": "ct-36cn2avfrrj9v",
"ChangeTypeVersion": "2.0",
"Title": "cfn-ingest"
}
```
1. Créez la RFC en spécifiant le CreateCfnRfc fichier et le CreateCfnParams fichier :
```
aws amscm create-rfc --cli-input-json file://CreateCfnRfc.json --execution-parameters file://CreateCfnParams.json
```
Vous recevez l'identifiant de la nouvelle RFC dans la réponse et vous pouvez l'utiliser pour soumettre et surveiller la RFC. Tant que vous ne l'avez pas soumise, la RFC reste en cours d'édition et ne démarre pas.
#### Conseils
**Note**
Ce type de modification est en version 2.0 et est automatisé (il n'est pas exécuté manuellement). Cela permet à l'exécution du CT d'aller plus rapidement et, un nouveau paramètre **CloudFormationTemplate**, vous permet de coller un CloudFormation modèle personnalisé dans le RFC. De plus, dans cette version, nous n'associons pas les groupes de sécurité AMS par défaut si vous spécifiez vos propres groupes de sécurité. Si vous ne spécifiez pas vos propres groupes de sécurité dans la demande, AMS associera les groupes de sécurité AMS par défaut. Dans CFN Ingest v1.0, nous avons toujours ajouté les groupes de sécurité AMS par défaut, que vous ayez fourni ou non vos propres groupes de sécurité.
AMS a activé 17 services AMS auto-provisionnés à utiliser dans ce type de modification. Pour plus d'informations sur les ressources prises en charge, voir [ CloudFormation Ingest Stack : Supported Resources](https://docs.aws.amazon.com/managedservices/latest/appguide/cfn-ingest-supp-services.html).
**Note**
La version 2.0 accepte un point de terminaison S3 qui n'est pas une URL présignée.
Si vous utilisez la version précédente de ce CT, la valeur du paramètre **CloudFormationTemplateS3Endpoint** doit être une URL présignée.
Exemple de commande pour générer une URL de compartiment S3 présignée (Mac/Linux) :
```
export S3_PRESIGNED_URL=$(aws s3 presign DASHDASHexpires-in 86400 s3://BUCKET_NAME/CFN_TEMPLATE.json)
```
Exemple de commande pour générer une URL de compartiment S3 présignée (Windows) :
```
for /f %i in ('aws s3 presign DASHDASHexpires-in 86400 s3://BUCKET_NAME/CFN_TEMPLATE.json') do set S3_PRESIGNED_URL=%i
```
Consultez également [la section Création de compartiments pré-signés URLs pour Amazon S3](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/s3-example-presigned-urls.html).
**Note**
Si le compartiment S3 existe dans un compte AMS, vous devez utiliser vos informations d'identification AMS pour cette commande. Par exemple, vous devrez peut-être ajouter `--profile saml` après avoir obtenu vos informations d'identification AMS AWS Security Token Service (AWS STS).
Types de modifications connexes :[Approuver un ensemble CloudFormation de modifications à la pile d'ingestion](management-custom-stack-from-cloudformation-template-approve-changeset-and-update.md#ex-cfn-ingest-approve-and-update-col), [Mettre à jour CloudFormation la pile d'ingestion](management-custom-stack-from-cloudformation-template-update.md#ex-cfn-ingest-update-col)
Pour en savoir plus sur AWS CloudFormation, consultez [AWS CloudFormation](https://aws.amazon.com/cloudformation/). Pour voir les CloudFormation modèles, ouvrez le manuel AWS CloudFormation [Template Reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-reference.html).
#### Validation d'une ingestion CloudFormation
Le modèle est validé pour garantir qu'il peut être créé dans un compte AMS. S'il passe la validation, il est mis à jour pour inclure toutes les ressources ou configurations requises pour être conforme à AMS. Cela inclut l'ajout de ressources telles que les CloudWatch alarmes Amazon afin de permettre à AMS Operations de surveiller la pile.
La RFC est rejetée si l'une des conditions suivantes est vraie :
+ La syntaxe RFC JSON est incorrecte ou ne suit pas le format indiqué.
+ L'URL présignée du compartiment S3 fournie n'est pas valide.
+ La CloudFormation syntaxe du modèle n'est pas valide.
+ Le modèle n'a pas de valeurs par défaut définies pour toutes les valeurs de paramètres.
+ Le modèle échoue à la validation AMS. Pour les étapes de validation AMS, consultez les informations plus loin dans cette rubrique.
La RFC échoue si la CloudFormation pile ne parvient pas à se créer en raison d'un problème de création de ressources.
Pour en savoir plus sur la validation et le validateur CFN, voir [Validation de modèles](https://docs.aws.amazon.com/managedservices/latest/appguide/cfn-author-templates.html) et [pile d'CloudFormation ingestion : exemples de validateurs CFN](https://docs.aws.amazon.com/managedservices/latest/appguide/ex-cfn-ingest-validator.html).
## Paramètres d'entrée d'exécution
Pour des informations détaillées sur les paramètres d'entrée d'exécution, consultez[Schéma pour le type de modification ct-36cn2avfrrj9v](schemas.md#ct-36cn2avfrrj9v-schema-section).
## Exemple : paramètres obligatoires
```
Example not available.
```
## Exemple : tous les paramètres
```
Example not available.
```