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.

Richten Sie sich ein, um benutzerdefinierte Images mit Image Builder zu erstellen

Bevor Sie Images mit EC2 Image Builder erstellen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen für die Erstellung einer Image-Pipeline erfüllen. Sofern nicht ausdrücklich anders angegeben, sind diese Voraussetzungen für alle Arten von Pipelines erforderlich.

Nachdem Sie die Voraussetzungen erfüllt haben, können Sie EC2 Image Builder über eine der folgenden Schnittstellen verwalten.

Mit dem Service verknüpfte Image Builder Builder-Rolle

EC2 Image Builder verwendet eine dienstverknüpfte Rolle, um anderen AWS Diensten in Ihrem Namen Berechtigungen zu erteilen. Sie müssen eine serviceverknüpfte Rolle nicht manuell erstellen. Wenn Sie Ihre erste Image Builder-Ressource in der AWS Management Console, der AWS CLI oder der AWS API erstellen, erstellt Image Builder die serviceverknüpfte Rolle für Sie. Weitere Informationen zu der dienstbezogenen Rolle, die Image Builder in Ihrem Konto erstellt, finden Sie unterVerwenden Sie mit dem IAM-Dienst verknüpfte Rollen für Image Builder.

Konfigurationsanforderungen

Container-Repository für Container-Image-Pipelines

Für Container-Image-Pipelines definiert das Rezept die Konfiguration für die Docker-Images, die im Ziel-Container-Repository erzeugt und gespeichert werden. Sie müssen das Ziel-Repository erstellen, bevor Sie das Container-Rezept für Ihr Docker-Image erstellen.

Image Builder verwendet Amazon ECR als Ziel-Repository für Container-Images. Um ein Amazon ECR-Repository zu erstellen, folgen Sie den unter Erstellen eines Repositorys im Amazon Elastic Container Registry-Benutzerhandbuch beschriebenen Schritte.

Dedizierter Host für macOS-Images

Amazon EC2 Mac-Instances benötigen einen Dedicated Host, der auf einem Metal-Instance-Typ ausgeführt wird. Bevor Sie ein benutzerdefiniertes macOS-Image erstellen, müssen Sie Ihrem Konto einen Dedicated Host zuweisen. Weitere Informationen zu Mac-Instances und eine Liste der Instance-Typen, die das macOS-Betriebssystem nativ unterstützen, finden Sie unter Amazon EC2 Mac-Instances im EC2 Amazon-Benutzerhandbuch.

Wenn Sie einen Dedicated Host erstellt haben, können Sie die Einstellungen in der Infrastrukturkonfigurationsressource für Ihr Image konfigurieren. Die Infrastrukturkonfiguration umfasst Platzierungseigenschaften, in denen Sie den Host, die Host-Platzierungsgruppe oder die Availability Zone angeben können, in der sich die Instances befinden sollen, die von Ihrem Image aus gestartet werden.

IAM-Voraussetzungen

Die IAM-Rolle, die Sie Ihrem Instanzprofil zuordnen, muss über Berechtigungen zum Ausführen der in Ihrem Image enthaltenen Build- und Testkomponenten verfügen. Die folgenden IAM-Rollenrichtlinien müssen der IAM-Rolle angehängt werden, die dem Instanzprofil zugeordnet ist:

Wenn Sie die Protokollierung konfigurieren, muss das in Ihrer Infrastrukturkonfiguration angegebene Instance-Profil über s3:PutObject Berechtigungen für den Ziel-Bucket (arn:aws:s3:::BucketName/*) verfügen. Zum Beispiel:

{
"Version": "2012-10-17",
"Statement": [
    {
        "Effect": "Allow",
        "Action": [
            "s3:PutObject"
        ],
        "Resource": "arn:aws:s3:::bucket-name/*"
    }
]
}

Richtlinie anfügen

Die folgenden Schritte führen Sie durch den Prozess des Anfügens der IAM-Richtlinien an eine IAM-Rolle, um die oben genannten Berechtigungen zu gewähren.

Voraussetzungen für den Systems Manager Agent

EC2 Image Builder führt den Agenten AWS Systems Manager (Systems Manager) auf den EC2 Instanzen aus, die es startet, um Ihr Image zu erstellen und zu testen. Image Builder sammelt zusätzliche Informationen über die Instanz, die während der Buildphase mit Systems Manager Inventory verwendet wurde. Diese Informationen umfassen den Namen und die Version des Betriebssystems (OS) sowie die Liste der Pakete und ihrer jeweiligen Versionen, wie von Ihrem Betriebssystem gemeldet.

Um die Erfassung dieser Informationen abzulehnen, wählen Sie die Methode aus, die Ihrer bevorzugten Umgebung entspricht:

Image Builder sendet RunCommand im Rahmen des Workflows zum Erstellen und Testen von Images Aktionen an Ihre Build- und Testinstanz. Sie können die Verwendung von RunCommand zum Senden von Aktionen an Ihre Build- und Testinstanz nicht deaktivieren.