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.
# AMI \$1 Créer
Créez une Amazon Machine Image (AMI) basée sur une instance EC2 autonome existante dans votre compte AMS. L'instance doit être à l'état arrêté avant d'exécuter ce type de modification.
**Classification complète :** Déploiement \$1 Composants de pile avancés \$1 AMI \$1 Créer
## Détails du type de modification
****
| | |
| --- |--- |
| Modifier l'identifiant du type | ct-3rqqu43krekby |
| 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éer une AMI
#### Création d'une AMI avec la console
Ce qui suit montre ce type de modification dans la console AMS.
![\[Modification type details for creating an Amazon Machine Image (AMI) from an EC2 instance.\]](http://docs.aws.amazon.com/fr_fr/managedservices/latest/ctref/images/guiAmiCreateCT.png)
**Important**
Avant de commencer, préparez l'instance EC2 que vous utiliserez pour créer l'AMI. Sans préparation adéquate, la RFC de création d'AMI risque d'être rejetée ou d'échouer. Pour plus d'informations sur la préparation de votre instance afin de créer correctement une AMI, consultez les instructions incluses dans ce didacticiel.
Fonctionnement :
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 le RFC ou en créer une copie avec les options en haut de la page.
#### Création d'une AMI avec la CLI
Fonctionnement :
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).
*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é. Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :
```
aws --profile saml --region us-east-1 amscm create-rfc --change-type-id "ct-3rqqu43krekby" --change-type-version "2.0" --title "AMI-Create-IC" --execution-parameters "{\"AMIName\":\"MyAmi\",\"VpcId\":\"VPC_ID\",\"EC2InstanceId\":\"INSTANCE_ID\"}"
```
*CRÉATION DU MODÈLE* :
1. Afficher le schéma JSON des paramètres d'exécution pour ce type de modification dans un fichier ; cet exemple le nomme CreateAmiParams .json :
```
aws amscm get-change-type-version --change-type-id "ct-3rqqu43krekby" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateAmiParams.json
```
1. Modifiez et enregistrez le fichier CreateAmiParams .json des paramètres d'exécution. Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :
```
{
"AMIName": "My-AMI",
"InstanceId": "EC2_INSTANCE_ID"
}
```
1. Exportez le fichier JSON du modèle RFC dans un fichier de votre dossier actuel ; cet exemple le nomme CreateAmiRfc .json :
```
aws amscm create-rfc --generate-cli-skeleton > CreateAmiRfc.json
```
1. Modifiez et enregistrez le fichier CreateAmiRfc .json. Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :
```
{
"ChangeTypeId": "ct-3rqqu43krekby",
"ChangeTypeVersion": "2.0",
"Title": "AMI-Create-RFC"
}
```
1. Créez la RFC en spécifiant le CreateAmiRfc fichier et le CreateAmiParams fichier :
```
aws amscm create-rfc --cli-input-json file://CreateAmiRfc.json --execution-parameters file://CreateAmiParams.json
```
Vous recevez l'identifiant de la nouvelle RFC dans la réponse et 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**
Après avoir créé une AMI personnalisée, vous pouvez envoyer une demande de service à AMS pour que votre groupe EC2 Auto Scaling existant utilise la nouvelle AMI. Pour plus d'informations sur la création d'une demande de service, consultez la section [Exemples de demandes de service](https://docs.aws.amazon.com/managedservices/latest/userguide/serv-req-mgmt-examples.html).
**Important**
Avant de commencer, préparez l'instance EC2 que vous utiliserez pour créer l'AMI. Sans préparation adéquate, la RFC de création d'AMI risque d'être rejetée ou d'échouer.
Pour éviter les problèmes d'authentification liés aux instances créées à partir de la nouvelle AMI, exécutez ces commandes système sur l'instance après avoir appliqué des modifications personnalisées et avant d'appeler le Create AMI CT.
**Important**
Si l'instance spécifiée n'est pas arrêtée et séparée de son domaine actuel, la RFC de création d'AMI échoue. Préparez l'instance comme décrit.
Pour plus d'informations, consultez [Créer une image de machine Amazon standard à l'aide de Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#23ami-create-standard).
Vous pouvez vous abonner à une rubrique de notification AMS SNS AMI pour recevoir une alerte chaque fois qu'un nouvel AMS AMIs qui vous intéresse est déployé. Pour plus d'informations, consultez le [service de notification AMI AMS](https://docs.aws.amazon.com/managedservices/latest/userguide/ams-ami-notify.html).
##### Préparation de Linux pour la création d'AMI
Téléchargez et exécutez le script suivant pour préparer votre instance à la création d'AMI. Vous devez exécuter ce script en tant qu'utilisateur root.
```
curl https://amazon-ams-us-east-1.s3.amazonaws.com/latest/linux/prepare_instance_for_ami_and_shutdown.sh -o ./prepare_instance_for_ami_and_shutdown.sh
chmod 744 prepare_instance_for_ami_and_shutdown.sh
./prepare_instance_for_ami_and_shutdown.sh
```
Remarque : Le script précédent arrête l'instance et les utilisateurs connectés sont déconnectés de la session.
##### Préparation de Windows pour la création d'AMI
Windows Powershell (exécuté en tant qu'administrateur) :
```
Invoke-AMSSysprep
```
L'instance est arrêtée et tout utilisateur connecté est déconnecté de la session Windows RDP en cours.
Pour plus d'informations sur la création d'AWS Windows AMIs, consultez la section [Création d'une AMI Windows personnalisée](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#23ami-create-standard).
##### UserData pour AMI Create
Si vous avez besoin que les données utilisateur soient exécutées lors du prochain démarrage à partir de votre AMI, assurez-vous de ce qui suit :
+ `HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\ManagedServices\RunUserDataViaAMSBootModule`La clé de registre est présente ; si cette clé n'est pas présente, les données utilisateur ne seront pas exécutées la prochaine fois.
+ Pour permettre l'exécution des données utilisateur lors du prochain démarrage :
1. Démarrer un Windows avec PowerShell les privilèges d'administrateur (exécuter en tant qu'administrateur)
1. Exécutez la commande suivante :
```
Install-AMSDependencies
```
Pour plus d'informations sur l'échec de la création d'AMI RFCs, consultez la section [Résolution des défaillances RFC](https://docs.aws.amazon.com/managedservices/latest/userguide/rfc-failures.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-3rqqu43krekby](schemas.md#ct-3rqqu43krekby-schema-section).
## Exemple : paramètres obligatoires
```
{
"InstanceId": "i-01234567890abcdef",
"AmiName": "MyAMI"
}
```
## Exemple : tous les paramètres
```
{
"InstanceId": "i-12345678",
"AmiName": "MyAMI",
"AmiTags": [
{
"Key": "foo",
"Value": "bar"
},
{
"Key": "testkey",
"Value": "testvalue"
}
]
}
```