Créer une configuration d'infrastructure

Ouvrez la console EC2 Image Builder à https://console.aws.amazon.com/imagebuilder/ l'adresse.

Dans le volet de navigation, choisissez Configuration de l'infrastructure.

Choisissez Créer une configuration d'infrastructure.

Dans la section Général, entrez les informations requises suivantes :

Dans le panneau AWS Infrastructure, configurez les autres paramètres d'infrastructure. Saisissez les informations requises suivantes :

Si vous ne fournissez pas de valeurs pour les paramètres suivants, ils utilisent les valeurs par défaut spécifiques au service, le cas échéant.

Dans la section Balises d'infrastructure (facultatif), vous pouvez attribuer des balises de métadonnées à l'instance Amazon EC2 qu'Image Builder lance pendant le processus de création. Entrez les balises sous forme de paires clé-valeur.

Dans la section Tags (facultatif), vous pouvez attribuer des balises de métadonnées à la ressource de configuration d'infrastructure créée par Image Builder en sortie. Entrez les balises sous forme de paires clé-valeur.

Créer un fichier JSON d'entrée CLI

Les exemples suivants présentent des variantes du fichier JSON que vous pouvez créer pour la configuration de l'infrastructure. Utilisez un outil d'édition de fichiers pour créer votre propre fichier JSON.

Exemple 1 : Configuration pour conserver une instance d'une compilation ayant échoué

Cet exemple spécifie deux types d'instances, m7i.large etm7i.xlarge. Nous vous recommandons de spécifier plusieurs types d'instance, car cela permet à Image Builder de lancer une instance à partir d'un pool doté d'une capacité suffisante. Cela peut réduire vos échecs de construction transitoires.

instanceProfileNameSpécifie le profil d'instance qui fournit à l'instance les autorisations dont elle a besoin pour effectuer des activités de personnalisation. Par exemple, si vous avez un composant qui extrait des ressources d'Amazon S3, le profil d'instance nécessite des autorisations pour accéder à ces fichiers. Le profil d'instance nécessite également un ensemble minimal d'autorisations pour qu'EC2 Image Builder puisse communiquer correctement avec l'instance. Pour de plus amples informations, veuillez consulter Préparez-vous à créer des images personnalisées avec Image Builder.

{
    "name": "ExampleInfraConfigDontTerminate",
    "description": "An example that will retain instances of failed builds",
    "instanceTypes": [
        "m7i.large", "m7i.xlarge"
    ],
    "instanceProfileName": "myIAMInstanceProfileName",
    "securityGroupIds": [
        "sg-12345678"
    ],
    "subnetId": "subnet-12345678",
    "logging": {
        "s3Logs": {
            "s3BucketName": "my-logging-bucket",
            "s3KeyPrefix": "my-path"
        }
    },
    "keyPair": "myKeyPairName",
    "terminateInstanceOnFailure": false,
    "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:MyTopic"
}

Exemple 2 : configuration macOS avec placement automatique

Cet exemple spécifie les types d'instances et leur emplacement pour une instance Mac où le placement automatique est activé sur l'hôte dédié.

{
   "name": "macOSInfraConfigAutoPlacement",
   "description": "An example infrastructure configuration for macOS.",
   "instanceProfileName": "EC2InstanceProfileForImageBuilder",
   "instanceTypes": ["mac1.metal", "mac2.metal"],
   "terminateInstanceOnFailure": false,
   "placement": {
      "tenancy": "host"
   }
}

Exemple 3 : configuration macOS avec l'ID d'hôte spécifié

Cet exemple spécifie le type d'instance et l'emplacement d'une instance Mac qui cible un hôte dédié spécifique.

{
   "name": "macOSInfraConfigHostPlacement",
   "description": "An example infrastructure configuration for macOS.",
   "instanceProfileName": "EC2InstanceProfileForImageBuilder",
   "instanceTypes": ["mac2-m1ultra.metal"],
   "terminateInstanceOnFailure": false,
   "placement": {
      "tenancy": "host",
      "hostId" : "h-1234567890abcdef0"
   }
}

Exemple 4 : VPC personnalisé avec IMDSv2 et journalisation Amazon S3

Cet exemple lance des instances dans un sous-réseau et un groupe de sécurité spécifiques, nécessite des jetons IMDSv2 et écrit les journaux des applications sur Amazon S3. Parce que l'exemple définitsubnetId, il doit également définirsecurityGroupIds.

{
    "name": "VpcInfraConfigWithLogging",
    "description": "Build in a custom VPC with IMDSv2 and S3 logging",
    "instanceTypes": ["m7i.large", "m8i.large"],
    "instanceProfileName": "EC2InstanceProfileForImageBuilder",
    "subnetId": "subnet-12345678",
    "securityGroupIds": ["sg-12345678"],
    "instanceMetadataOptions": {
        "httpTokens": "required",
        "httpPutResponseHopLimit": 2
    },
    "logging": {
        "s3Logs": {
            "s3BucketName": "my-logging-bucket",
            "s3KeyPrefix": "image-builder-logs"
        }
    },
    "resourceTags": {
        "Project": "golden-ami"
    },
    "terminateInstanceOnFailure": true
}

Exemple 5 : placement d'un hôte dédié auprès d'un groupe de ressources d'hôtes

Cet exemple cible un groupe de ressources hôtes au lieu d'un ID d'hôte spécifique. Parce tenancy que ouihost, vous pouvez spécifier l'ARN d'un groupe de ressources hôtes. Ne spécifiez pas également unhostId.

{
    "name": "HostResourceGroupInfraConfig",
    "instanceProfileName": "EC2InstanceProfileForImageBuilder",
    "instanceTypes": ["mac2.metal"],
    "terminateInstanceOnFailure": false,
    "placement": {
        "tenancy": "host",
        "hostResourceGroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/my-host-group"
    }
}

Utilisez le fichier que vous avez créé comme entrée lorsque vous exécutez la commande suivante.

aws imagebuilder create-infrastructure-configuration --cli-input-json file://create-infrastructure-configuration.json