View a markdown version of this page

Aktualisieren Sie eine Infrastrukturkonfiguration - EC2 Image Builder

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aktualisieren Sie eine Infrastrukturkonfiguration

In diesem Abschnitt wird beschrieben, wie Sie die Image Builder-Konsole oder die imagebuilder Befehle in der verwenden können AWS CLI , um eine Infrastrukturkonfigurationsressource zu aktualisieren. Um Ihre Ressourcen im Auge zu behalten, können Sie Tags wie folgt anwenden. Geben Sie Tags als Schlüssel-Wert-Paare ein.

  • Ressourcen-Tags weisen der Amazon EC2-Instance, die Image Builder während des Build-Prozesses startet, Metadaten-Tags zu.

  • Tags weisen der Infrastrukturkonfigurationsressource, die Image Builder als Ausgabe erstellt, Metadaten-Tags zu.

Console

Sie können die folgenden Infrastrukturkonfigurationsdetails von der Image Builder-Konsole aus bearbeiten:

  • Die Beschreibung für Ihre Infrastrukturkonfiguration.

  • Die IAM-Rolle, die dem Instanzprofil zugeordnet werden soll.

  • AWS Infrastruktur, einschließlich des Instanztyps und eines SNS-Themas für Benachrichtigungen.

  • VPC, Subnetz und Sicherheitsgruppen.

  • Einstellungen zur Fehlerbehebung, einschließlich Instanz bei Ausfall beenden, Schlüsselpaar für die Verbindung und ein optionaler S3-Bucket-Speicherort für Instance-Logs.

Gehen Sie folgendermaßen vor, um eine Infrastrukturkonfigurationsressource von der Image Builder-Konsole aus zu aktualisieren:

Wählen Sie eine vorhandene Image Builder-Infrastrukturkonfiguration

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

  2. Um eine Liste der Infrastrukturkonfigurationsressourcen unter Ihrem Konto anzuzeigen, wählen Sie im Navigationsbereich Infrastrukturkonfiguration aus.

  3. Um Details anzuzeigen oder eine Infrastrukturkonfiguration zu bearbeiten, wählen Sie den Link Konfigurationsname. Dadurch wird die Detailansicht für die Infrastrukturkonfiguration geöffnet.

    Anmerkung

    Sie können auch das Kontrollkästchen neben dem Konfigurationsnamen aktivieren und dann Detail anzeigen wählen.

  4. Wählen Sie in der oberen rechten Ecke des Bereichs mit den Infrastrukturdetails die Option Bearbeiten aus.

  5. Wenn Sie bereit sind, die Aktualisierungen zu speichern, die Sie an Ihrer Infrastrukturkonfiguration vorgenommen haben, wählen Sie Änderungen speichern aus.

AWS CLI

Das folgende Beispiel zeigt, wie Sie die Infrastrukturkonfiguration für Ihr Image mit dem update-infrastructure-configuration Befehl Image Builder im aktualisieren AWS CLI.

  1. Erstellen einer CLI-Eingabe-JSON-Datei

    In diesem Beispiel entsprechen die Einstellungen dem Create-Beispiel, außer dass dieses auf gesetzt terminateInstanceOnFailure isttrue. Nachdem Sie den update-infrastructure-configuration Befehl ausgeführt haben, beenden Pipelines, die diese Infrastrukturkonfiguration verwenden, die Build- und Testinstanzen, wenn ein Build fehlschlägt.

    Das folgende Beispiel legt allgemeine Infrastrukturfelder fest. Um IMDSv2-Token für die Build- und Testinstanzen zu benötigen, fügen Sie einen instanceMetadataOptions Block mit httpTokens set auf hinzu. required

    Anmerkung

    Wir empfehlen, dass Sie alle EC2-Instances, die Image Builder von einem Pipeline-Build aus startet, so konfigurieren, dass IMDSv2 verwendet wird, sodass für Anfragen zum Abrufen von Instance-Metadaten ein signierter Token-Header erforderlich ist.

    Verwenden Sie ein Dateibearbeitungswerkzeug, um eine JSON-Datei mit den im folgenden Beispiel gezeigten Schlüsseln sowie Werten, die für Ihre Umgebung gültig sind, zu erstellen. In diesem Beispiel wird eine Datei mit dem Namenupdate-infrastructure-configuration.json:

    {
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration",
"description": "An example that will terminate instances of failed builds",
"instanceTypes": [
    "m7i.large", "m7i.2xlarge"
],
"instanceProfileName": "myIAMInstanceProfileName",
"securityGroupIds": [
    "sg-12345678"
],
"subnetId": "subnet-12345678",
"logging": {
    "s3Logs": {
        "s3BucketName": "my-logging-bucket",
        "s3KeyPrefix": "my-path"
    }
},
"terminateInstanceOnFailure": true,
"snsTopicArn": "arn:aws:sns:us-west-2:123456789012:MyTopic"
}
  2. Verwenden Sie die von Ihnen erstellte Datei als Eingabe, wenn Sie den folgenden Befehl ausführen.
    aws imagebuilder update-infrastructure-configuration --cli-input-json file://update-infrastructure-configuration.json