Erstellen einer Infrastrukturkonfiguration

Öffnen Sie die EC2 Image Builder-Konsole unter https://console.aws.amazon.com/imagebuilder/.

Wählen Sie im Navigationsbereich die Option Infrastrukturkonfiguration aus.

Wählen Sie Infrastrukturkonfiguration erstellen aus.

Geben Sie im Abschnitt Allgemein die folgenden erforderlichen Informationen ein:

Konfigurieren Sie im Bereich AWS Infrastruktur die verbleibenden Infrastruktureinstellungen. Geben Sie die folgenden erforderlichen Informationen ein:

Wenn Sie für die folgenden Einstellungen keine Werte angeben, verwenden sie gegebenenfalls dienstspezifische Standardwerte.

Im Abschnitt Infrastruktur-Tags (optional) können Sie der Amazon EC2-Instance, die Image Builder während des Build-Prozesses startet, Metadaten-Tags zuweisen. Geben Sie Tags als Schlüssel-Wert-Paare ein.

Im Abschnitt „Tags“ (optional) können Sie der Infrastrukturkonfigurationsressource, die Image Builder als Ausgabe erstellt, Metadaten-Tags zuweisen. Geben Sie Tags als Schlüssel-Wert-Paare ein.

Erstellen einer CLI-Eingabe-JSON-Datei

Die folgenden Beispiele zeigen Varianten der JSON-Datei, die Sie für die Infrastrukturkonfiguration erstellen könnten. Verwenden Sie ein Dateibearbeitungswerkzeug, um eine eigene JSON-Datei zu erstellen.

Beispiel 1: Konfiguration zur Beibehaltung einer Instanz aus einem fehlgeschlagenen Build

In diesem Beispiel werden zwei Instanztypen angegeben, m7i.large undm7i.xlarge. Wir empfehlen, mehr als einen Instanztyp anzugeben, da Image Builder so eine Instanz aus einem Pool mit ausreichender Kapazität starten kann. Dies kann Ihre vorübergehenden Build-Fehler reduzieren.

Das instanceProfileName gibt das Instanzprofil an, das der Instanz die Berechtigungen gewährt, die das Profil zur Durchführung von Anpassungsaktivitäten benötigt. Wenn Sie beispielsweise über eine Komponente verfügen, die Ressourcen von Amazon S3 abruft, benötigt das Instanzprofil Berechtigungen für den Zugriff auf diese Dateien. Das Instanzprofil erfordert außerdem einen Mindestsatz an Berechtigungen, damit EC2 Image Builder erfolgreich mit der Instance kommunizieren kann. Weitere Informationen finden Sie unter Richten Sie sich ein, um benutzerdefinierte Images mit Image Builder zu erstellen.

{
    "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"
}

Beispiel 2: macOS-Konfiguration mit automatischer Platzierung

In diesem Beispiel werden Instanztypen und deren Platzierung für eine Mac-Instanz angegeben, bei der die automatische Platzierung für den Dedicated Host aktiviert ist.

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

Beispiel 3: macOS-Konfiguration mit angegebener Host-ID

Dieses Beispiel spezifiziert den Instanztyp und die Platzierung für eine Mac-Instanz, die auf einen bestimmten Dedicated Host abzielt.

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

Beispiel 4: Benutzerdefinierte VPC mit IMDSv2- und Amazon S3-Protokollierung

Dieses Beispiel startet Instances in einem bestimmten Subnetz und einer bestimmten Sicherheitsgruppe, erfordert IMDSv2-Token und schreibt Anwendungsprotokolle in Amazon S3. Da das Beispiel festlegtsubnetId, muss es auch gesetzt werden. securityGroupIds

{
    "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
}

Beispiel 5: Platzierung eines dedizierten Hosts mit einer Host-Ressourcengruppe

Dieses Beispiel zielt auf eine Hostressourcengruppe statt auf eine bestimmte Host-ID ab. tenancyDenn jahost, Sie können einen ARN für eine Hostressourcengruppe angeben. Geben Sie nicht auch eine anhostId.

{
    "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"
    }
}

Verwenden Sie die von Ihnen erstellte Datei als Eingabe, wenn Sie den folgenden Befehl ausführen.

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