Beispiel für „Docker-Image in einem ECR Amazon-Image-Repository veröffentlichen“ für CodeBuild

So führen Sie das Beispiel aus

1. Wenn Sie bereits über ein Bild-Repository in Amazon verfügen, das ECR Sie verwenden möchten, fahren Sie mit Schritt 3 fort. Andernfalls, wenn Sie einen Benutzer anstelle eines AWS Root-Kontos oder eines Administrator-Benutzers für die Arbeit mit Amazon verwendenECR, fügen Sie diese Aussage hinzu (zwischen ### BEGIN ADDING STATEMENT HERE ### and ### END ADDING STATEMENT HERE ###) für den Benutzer (oder die IAM Gruppe, der der Benutzer zugeordnet ist). Die Verwendung eines AWS Root-Kontos wird nicht empfohlen. Diese Anweisung ermöglicht die Erstellung von ECR Amazon-Repositorys zum Speichern von Docker-Images. Auslassungspunkte (...) werden zur Abkürzung verwendet und weisen auf die Stellen hin, an denen die Anweisung hinzugefügt wird. Entfernen Sie keine Anweisungen und geben Sie die Auslassungspunkte nicht in die Richtlinie ein. Weitere Informationen finden Sie unter Arbeiten mit Inline-Richtlinien mithilfe von im AWS Management Console Benutzerhandbuch.

   {
     "Statement": [
       ### BEGIN ADDING STATEMENT HERE ###
       {
         "Action": [
           "ecr:CreateRepository"
         ],
         "Resource": "*",
         "Effect": "Allow"
       },
       ### END ADDING STATEMENT HERE ###
       ...
     ],
     "Version": "2012-10-17"
   }

   Anmerkung

   Die IAM Entität, die diese Richtlinie ändert, muss berechtigt sein, Richtlinien IAM zu ändern.

2. Erstellen Sie ein Bild-Repository in AmazonECR. Stellen Sie sicher, dass Sie das Repository in derselben AWS Region erstellen, in der Sie Ihre Build-Umgebung erstellen und Ihren Build ausführen. Weitere Informationen finden Sie unter Erstellen eines Repositorys im ECRAmazon-Benutzerhandbuch. Der Name dieses Repositorys muss mit dem Namen des Repositorys übereinstimmen, den Sie zu einem späteren Zeitpunkt in diesem Verfahren festlegen und der durch die IMAGE_REPO_NAME-Umgebungsvariable dargestellt wird. Stellen Sie sicher, dass die ECR Amazon-Repository-Richtlinie Image-Push-Zugriff für Ihre CodeBuild IAM Servicerolle gewährt.

3. Fügen Sie diese Aussage hinzu (zwischen ### BEGIN ADDING STATEMENT HERE ### and ### END ADDING STATEMENT HERE ###) zu der Richtlinie, die Sie Ihrer AWS CodeBuild Servicerolle hinzugefügt haben. Diese Anweisung ermöglicht das Hochladen CodeBuild von Docker-Images in ECR Amazon-Repositorys. Auslassungspunkte (...) werden zur Abkürzung verwendet und weisen auf die Stellen hin, an denen die Anweisung hinzugefügt wird. Entfernen Sie keine Anweisungen und geben Sie die Auslassungspunkte nicht in die Richtlinie ein.

   {
     "Statement": [
       ### BEGIN ADDING STATEMENT HERE ###
       {
         "Action": [
           "ecr:BatchCheckLayerAvailability",
           "ecr:CompleteLayerUpload",
           "ecr:GetAuthorizationToken",
           "ecr:InitiateLayerUpload",
           "ecr:PutImage",
           "ecr:UploadLayerPart"
         ],
         "Resource": "*",
         "Effect": "Allow"
       },
       ### END ADDING STATEMENT HERE ###
       ...
     ],
     "Version": "2012-10-17"
   }

   Anmerkung

   Die IAM Entität, die diese Richtlinie ändert, muss über die Erlaubnis verfügen, Richtlinien IAM zu ändern.

4. Erstellen Sie die Dateien wie in den Dateien Abschnitten Verzeichnisstruktur und in diesem Thema beschrieben und laden Sie sie dann in einen S3-Eingabe-Bucket oder ein AWS CodeCommit, GitHub, oder Bitbucket-Repository hoch. Weitere Informationen findest du unter Referenz zur Datei mit Bilddefinitionen im AWS CodePipeline Benutzerhandbuch.

   Wichtig

   Laden Sie nicht (root directory name) hoch, sondern nur die Dateien in (root directory name).

   Wenn Sie einen S3-Eingabe-Bucket verwenden, stellen Sie sicher, dass Sie eine ZIP Datei erstellen, die die Dateien enthält, und laden Sie sie dann in den Eingabe-Bucket hoch. Fügen Sie der ZIP Datei nichts (root directory name) hinzu, sondern nur die darin enthaltenen Dateien(root directory name).

5. Erstellen Sie ein Build-Projekt, führen Sie den Build aus und zeigen Sie die Build-Informationen an.

   Wenn Sie die Konsole verwenden, um Ihr Projekt zu erstellen:

   1. Wählen Sie für Operating system (Betriebssystem) die Option Ubuntu aus.

   2. Wählen Sie unter Runtime (Laufzeit) die Option Standard aus.

   3. Wählen Sie für Image (Abbild) die Option aws/codebuild/standard:5.0 aus.

   4. Fügen Sie die folgenden Umgebungsvariablen hinzu:

      • AWS_ DEFAULT _ REGION mit einem Wert von region-ID

      • AWS_ACCOUNT_IDmit einem Wert von account-ID

      • IMAGE_ TAG mit dem Wert Latest

      • IMAGE_ REPO _ NAME mit einem Wert von Amazon-ECR-repo-name

   Wenn Sie das AWS CLI Build-Projekt mit dem erstellen, könnte die JSON -formatierte Eingabe für den create-project Befehl etwa so aussehen. (Ersetzen Sie die Platzhalter durch Ihre eigenen Werte.)

   {
     "name": "sample-docker-project",
     "source": {
       "type": "S3",
       "location": "codebuild-region-ID-account-ID-input-bucket/DockerSample.zip"
     },
     "artifacts": {
       "type": "NO_ARTIFACTS"
     },
     "environment": {
       "type": "LINUX_CONTAINER",
       "image": "aws/codebuild/standard:5.0",
       "computeType": "BUILD_GENERAL1_SMALL",
       "environmentVariables": [
         {
           "name": "AWS_DEFAULT_REGION",
           "value": "region-ID"
         },
         {
           "name": "AWS_ACCOUNT_ID",
           "value": "account-ID"
         },
         {
           "name": "IMAGE_REPO_NAME",
           "value": "Amazon-ECR-repo-name"
         },
         {
           "name": "IMAGE_TAG",
           "value": "latest"
         }
       ],
     },
     "serviceRole": "arn:aws:iam::account-ID:role/role-name",
     "encryptionKey": "arn:aws:kms:region-ID:account-ID:key/key-ID"
   }

6. Bestätigen Sie, dass das Docker-Image CodeBuild erfolgreich in das Repository übertragen wurde:

   1. Öffnen Sie die ECR Amazon-Konsole unter https://console.aws.amazon.com/ecr/.

   2. Wählen Sie den Namen des Repositorys aus. Das Bild muss in der Spalte Image Tag (Image-Tag) aufgelistet werden.