Détails du type de modification Informations supplémentaires Paramètres d'entrée d'exécution Exemple : paramètres obligatoires Exemple : tous les paramètres

EC2 Stack | Create (avec volumes supplémentaires)

Créez une instance Amazon Elastic Compute Cloud (EC2) avec jusqu'à cinq volumes supplémentaires.

Classification complète : Déploiement | Composants de stack avancés | EC2 Stack | Create (avec volumes supplémentaires)

Détails du type de modification

Modifier l'identifiant du type	ct-1aqsjf86w6vxg
Version actuelle	5.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éer une pile (avec des volumes supplémentaires)

Ce qui suit montre ce type de modification dans la console AMS.

EC2 stack creation details showing ID, execution mode, and version for additional volumes.

Comment cela fonctionne :

Accédez à la page Créer une RFC : Dans le volet de navigation de gauche de la console AMS, cliquez RFCspour ouvrir la page de RFCs liste, puis cliquez sur Créer une RFC.
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.
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.
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.
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.

Comment cela fonctionne :

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.
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.

CRÉATION EN LIGNE :

Émettez la commande create RFC avec les paramètres d'exécution fournis en ligne (évitez les guillemets lorsque vous fournissez des paramètres d'exécution en ligne), puis soumettez l'ID RFC renvoyé (l'exemple montre uniquement les paramètres requis). Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :


aws amscm create-rfc --change-type-id "ct-1aqsjf86w6vxg" --change-type-version "4.0" --title "EC2-Create-A-V-QC" --execution-parameters "{\"Description\":\"My EC2 stack with addl vol\",\"VpcId\":\"VPC_ID\",\"Name\":\"My Stack\",\"StackTemplateId\":\"stm-nn8v8ffhcal611bmo\",\"TimeoutInMinutes\":60,\"Parameters\":{\"InstanceAmiId\":\"AMI_ID\",\"InstanceSubnetId\":\"SUBNET_ID\"}}

CRÉATION D'UN MODÈLE :

Exportez les paramètres d'exécution pour ce type de modification dans un fichier JSON nommé Create EC2 AVParams .json.


aws amscm get-change-type-version --change-type-id "ct-1aqsjf86w6vxg" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateEC2AVParams.json

Modifiez et enregistrez le EC2 AVParams fichier Create (l'exemple montre la plupart des paramètres). Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :


{
"Description":      "EC2-Create-1-Addl-Volumes",
"VpcId":            "VPC_ID",
"StackTemplateId":  "stm-nn8v8ffhcal611bmo",
"Name":             "My-EC2-1-Addl-Volume",
"TimeoutInMinutes": 60,
"Parameters":   {
    "InstanceAmiId":    "AMI_ID",
    "InstanceSecurityGroupIds": "SECURITY_GROUP_ID",
    "InstanceCoreCount": 1,
    "InstanceThreadsPerCore": 2,    
    "InstanceDetailedMonitoring": "true",
    "InstanceEBSOptimized": "false",
    "InstanceProfile": "customer-mc-ec2-instance-profile",
    "InstanceRootVolumeIops": 100,
    "InstanceRootVolumeName": "/dev/xvda",
    "InstanceRootVolumeSize": 50,
    "InstanceRootVolumeType": "io1",
    "RootVolumeKmsKeyId": "default",
    "InstancePrivateStaticIp": "10.27.0.100",
    "InstanceSecondaryPrivateIpAddressCount": 0,
    "InstanceTerminationProtection": "false",
    "InstanceType": "t3.large",
    "CreditSpecification": "unlimited",
    "InstanceUserData": "echo $",
    "Volume1Encrypted": "true",
    "Volume1Iops":      "IOPS"
    "Volume1KmsKeyId":  "KMS_MASTER_KEY_ID",
    "Volume1Name":      "xvdh"
    "Volume1Size":      "2 GiB",
    "Volume1Snapshot":  "SNAPSHOT_ID",
    "Volume1Type":      "iol",
    "InstanceSubnetId": "SUBNET_ID"
    }
}

Exportez le modèle RFC dans un fichier de votre dossier actuel ; cet exemple le nomme Create EC2 AVRfc .json :
```
aws amscm create-rfc --generate-cli-skeleton > CreateEC2AVRfc.json
```
Modifiez et enregistrez le fichier Create EC2 AVRfc .json. Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :
```
{
"ChangeTypeVersion":    "4.0",
"ChangeTypeId":         "ct-1aqsjf86w6vxg",
"Title":                "EC2-Create-1-Addl-Volume-RFC"
}
```
Créez la RFC en spécifiant le fichier de création et le EC2 AVRfc fichier de création EC2 AVParams :
```
aws amscm create-rfc --cli-input-json file://CreateEC2AVRfc.json  --execution-parameters file://CreateEC2AVParams.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.

Important

Il existe une nouvelle version de ce type de modification, v 4.0, qui utilise un autre StackTemplateId (stm-nn8v8ffhcal611bmo). Ceci est important si vous soumettez la RFC avec ce type de modification sur la ligne de commande. La nouvelle version introduit deux nouveaux paramètres (RootVolumeKmsKeyIdet CreditSpecification) et modifie la valeur par défaut d'un paramètre existant (InstanceType).

Types d'instances

Si vous choisissez de spécifier le nombre de cœurs ou de threads, vous devez spécifier des valeurs pour les deux. Utilisez les paramètres InstanceCoreCount etInstanceThreadsPerCore. Pour trouver des combinaisons valides de cœurs/threads, consultez la section Nombre de cœurs de processeur et de threads par cœur de processeur et par type d'instance.
AMS ne recommande pas les types d'instance t2.micro/t3.micro ou t2.nano/t3.nano. Ils sont trop petits pour prendre en charge les outils AMS tels que EPS, SSM et Cloudwatch en plus de la charge de travail de votre entreprise. Pour plus d'informations, consultez Choisir le type d' EC2 instance adapté à votre application.
Dans la version 4.0, le type par défaut est passé de t2.large à t3.large. Les instances T3 sont lancées avec des « crédits illimités » par défaut. Vous ne subirez aucun ralentissement du processeur même si l'instance consomme tous les crédits du processeur. Vous pouvez plutôt choisir des instances T2 et utiliser l'option CreditSpecification illimitée.
Pour plus d'informations sur Amazon EC2, y compris les recommandations relatives à la taille, consultez la documentation Amazon Elastic Compute Cloud.

Pour mettre à jour votre EC2 pile avec des volumes supplémentaires après leur création, voir Stack d'EC2 instances : mise à jour (avec volumes supplémentaires)

Paramètres d'entrée d'exécution

Pour des informations détaillées sur les paramètres d'entrée d'exécution, consultezSchéma pour le type de modification ct-1aqsjf86w6vxg.

Exemple : paramètres obligatoires


{
  "Description" : "Test description",
  "VpcId" : "vpc-12345678901234567",
  "Name" : "TestStack",
  "StackTemplateId" : "stm-nn8v8ffhcal611bmp",
  "TimeoutInMinutes" : 60,
  "Parameters" : {
    "InstanceAmiId" : "ami-1234567890abcdef0",
    "InstanceSubnetId" : "subnet-1234567890abcdef0",
    "EnforceIMDSV2": "true"
  }
}

Exemple : tous les paramètres


{
  "Description": "This is a test description",
  "VpcId": "vpc-12345678",
  "Name": "Test Stack",
  "Tags": [
    {
      "Key": "key1",
      "Value": "value1"
    },
    {
      "Key": "key2",
      "Value": "value2"
    }
  ],
  "Parameters": {
    "InstanceAmiId": "ami-12345678",
    "InstanceCoreCount": 0,
    "InstanceThreadsPerCore": 0,
    "InstanceRootVolumeName": "/dev/xvda",
    "InstanceRootVolumeSize": 100,
    "InstanceSubnetId": "subnet-12345678",
    "InstanceDetailedMonitoring": "false",
    "InstanceEBSOptimized": "false",
    "InstanceProfile": "customer-mc-ec2-instance-profile",
    "InstanceRootVolumeIops": 1000,
    "InstanceRootVolumeType": "io1",
    "InstancePrivateStaticIp": "172.16.0.10",
    "InstanceSecondaryPrivateIpAddressCount" : 1,
    "InstanceTerminationProtection" : "true",
    "InstanceType": "t2.small",
    "InstanceUserData": "#!/bin/bash\\npwd\\nls -ltrh\\necho \"Hello, World\"",
    "Volume1Iops": 100,
    "Volume1KmsKeyId": "12345678-1234-1234-1234-1234567890ab",
    "Volume1Name": "/dev/sdf",
    "Volume1Size": 100,
    "Volume1Type": "io1",
    "Volume2Iops": 100,
    "Volume2KmsKeyId": "12345678-1234-1234-1234-1234567890ab",
    "Volume2Name": "/dev/sdg",
    "Volume2Size": 100,
    "Volume2Type": "io1",
    "Volume3Iops": 100,
    "Volume3KmsKeyId": "12345678-1234-1234-1234-1234567890ab",
    "Volume3Name": "/dev/sdh",
    "Volume3Size": 100,
    "Volume3Type": "io1",
    "Volume4Iops": 100,
    "Volume4KmsKeyId": "12345678-1234-1234-1234-1234567890ab",
    "Volume4Name": "/dev/sdi",
    "Volume4Size": 100,
    "Volume4Type": "io1",
    "Volume5Iops": 100,
    "Volume5KmsKeyId": "12345678-1234-1234-1234-1234567890ab",
    "Volume5Name": "/dev/sdj",
    "Volume5Size": 100,
    "Volume5Type": "io1",
    "EnforceIMDSV2": "true"
  },
  "TimeoutInMinutes": 60,
  "StackTemplateId": "stm-nn8v8ffhcal611bmp"
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

EC2 Empiler | Créer

Système de fichiers Elastic (EFS) | Créer