Utiliser des AWS Systems Manager paramètres au lieu de l'AMI IDs dans les modèles de lancement

Pour créer un modèle de lancement qui spécifie un paramètre de Systems Manager, vous pouvez utiliser l'un des exemples de commandes suivants. Remplacez chaque user input placeholder par vos propres informations.

Exemple : créer un modèle de lancement qui spécifie un paramètre public AWS appartenant à l'utilisateur

Utilisez la syntaxe suivante : resolve:ssm:public-parameter, où resolve:ssm est le préfixe standard et public-parameter le chemin et le nom du paramètre public.

Dans cet exemple, le modèle de lancement utilise un paramètre public AWS fourni pour lancer des instances à l'aide de la dernière AMI Amazon Linux 2 configurée pour votre profil. Région AWS

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data file://config.json

Contenu de config.json :

{ 
    "ImageId":"resolve:ssm:/aws/service/ami-amazon-linux-latest/amzn2-ami-hvm-x86_64-gp2",
    "InstanceType":"t2.micro"
}

Voici un exemple de réponse.

{
    "LaunchTemplate": {
        "LaunchTemplateId": "lt-089c023a30example",
        "LaunchTemplateName": "my-template-for-auto-scaling",
        "CreateTime": "2022-12-28T19:52:27.000Z",
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "DefaultVersionNumber": 1,
        "LatestVersionNumber": 1
    }
}

Exemple : création d'un modèle de lancement qui spécifie un paramètre stocké dans le même compte

Utilisez la syntaxe suivante : resolve:ssm:parameter-name, où resolve:ssm est le préfixe standard et parameter-name le nom du paramètre Systems Manager.

L'exemple suivant crée un modèle de lancement qui obtient l'ID d'AMI à partir d'un paramètre Systems Manager existant nommé golden-ami.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling \
  --launch-template-data file://config.json

Contenu de config.json :

{ 
    "ImageId":"resolve:ssm:golden-ami",
    "InstanceType":"t2.micro"
}

La version par défaut du paramètre, si elle n'est pas spécifiée, est la dernière version.

L'exemple suivant référence une version spécifique du paramètre golden-ami. L'exemple utilise la version 3 du paramètre golden-ami, mais vous pouvez utiliser n'importe quel numéro de version valide.

{ 
    "ImageId":"resolve:ssm:golden-ami:3",
    "InstanceType":"t2.micro"
}

L'exemple similaire suivant référence l'étiquette de paramètre prod qui est liée à une version spécifique du paramètre golden-ami.

{ 
    "ImageId":"resolve:ssm:golden-ami:prod",
    "InstanceType":"t2.micro"
}

Voici un exemple de sortie.

{
    "LaunchTemplate": {
        "LaunchTemplateId": "lt-068f72b724example",
        "LaunchTemplateName": "my-template-for-auto-scaling",
        "CreateTime": "2022-12-27T17:11:21.000Z",
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "DefaultVersionNumber": 1,
        "LatestVersionNumber": 1
    }
}

Exemple : créer un modèle de lancement qui spécifie un paramètre partagé par un autre Compte AWS

Utilisez la syntaxe suivante :resolve:ssm:parameter-ARN, où resolve:ssm se trouvent le préfixe standard et parameter-ARN l'ARN du paramètre Systems Manager.

L'exemple suivant crée un modèle de lancement qui obtient l'ID de l'AMI à partir d'un paramètre Systems Manager existant avec l'ARN dearn:aws:ssm:us-east-2:123456789012:parameter/MyParameter.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data file://config.json

Contenu de config.json :

{ 
    "ImageId":"resolve:ssm:arn:aws:ssm:us-east-2:123456789012:parameter/MyParameter",
    "InstanceType":"t2.micro"
}

La version par défaut du paramètre, si elle n'est pas spécifiée, est la dernière version.

L'exemple suivant référence une version spécifique du paramètre MyParameter. L'exemple utilise la version 3 du paramètre MyParameter, mais vous pouvez utiliser n'importe quel numéro de version valide.

{ 
    "ImageId":"resolve:ssm:arn:aws:ssm:us-east-2:123456789012:parameter/MyParameter:3",
    "InstanceType":"t2.micro"
}

L'exemple similaire suivant référence l'étiquette de paramètre prod qui est liée à une version spécifique du paramètre MyParameter.

{ 
    "ImageId":"resolve:ssm:arn:aws:ssm:us-east-2:123456789012:parameter/MyParameter:prod",
    "InstanceType":"t2.micro"
}

Voici un exemple de réponse.

{
    "LaunchTemplate": {
        "LaunchTemplateId": "lt-00f93d4588example",
        "LaunchTemplateName": "my-template-for-auto-scaling",
        "CreateTime": "2024-01-08T12:43:21.000Z",
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "DefaultVersionNumber": 1,
        "LatestVersionNumber": 1
    }
}