Esempio di «Pubblicazione di un'immagine Docker in un archivio di immagini Amazon ECR» per CodeBuild

Per eseguire questo esempio

1. Se hai già un repository di immagini in Amazon ECR che desideri utilizzare, vai al passaggio 3. Altrimenti, se utilizzi un utente anziché un account AWS root o un utente amministratore per lavorare con Amazon ECR, aggiungi questa dichiarazione (tra ### BEGIN ADDING STATEMENT HERE ### e### END ADDING STATEMENT HERE ###) all'utente (o al gruppo IAM a cui è associato l'utente). L'utilizzo di un account AWS root non è consigliato. Questa dichiarazione consente la creazione di repository Amazon ECR per l'archiviazione di immagini Docker. Le ellissi (...) vengono utilizzate per brevità e per aiutare i clienti a individuare il punto in cui aggiungere l'istruzione. Non rimuovere nessuna istruzione e non digitare queste ellissi nella policy. Per ulteriori informazioni, consulta Working with inline policies using the Console di gestione AWS in the user Guide.

   JSON

   {
       "Version":"2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "ecr:CreateRepository"
               ],
               "Resource": "*"
           }
       ]
   }
   

   Nota

   L'entità IAM che modifica questa policy deve disporre dell'autorizzazione in IAM per modificare le policy.

2. Crea un repository di immagini in Amazon ECR. Assicurati di creare il repository nella stessa AWS regione in cui crei l'ambiente di compilazione ed esegui la build. Per ulteriori informazioni, consulta Creating a repository nella Amazon ECR User Guide. Il nome di questo repository deve essere uguale a quello che viene specificato più avanti in questa procedura, rappresentato dalla variabile di ambiente IMAGE_REPO_NAME. Assicurati che la policy del repository Amazon ECR conceda l'accesso push all'immagine per il tuo ruolo IAM del servizio. CodeBuild

3. Aggiungi questa dichiarazione (tra ### BEGIN ADDING STATEMENT HERE ### e### END ADDING STATEMENT HERE ###) alla policy che hai allegato al tuo AWS CodeBuild ruolo di servizio. Questa dichiarazione consente di CodeBuild caricare immagini Docker nei repository Amazon ECR. Le ellissi (...) vengono utilizzate per brevità e per aiutare i clienti a individuare il punto in cui aggiungere l'istruzione. Non rimuovere nessuna istruzione e non digitare queste ellissi nella policy.

   JSON

   {
       "Version":"2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "ecr:BatchCheckLayerAvailability",
                   "ecr:CompleteLayerUpload",
                   "ecr:GetAuthorizationToken",
                   "ecr:InitiateLayerUpload",
                   "ecr:PutImage",
                   "ecr:UploadLayerPart"
               ],
               "Resource": "*"
           }
       ]
   }
   

   Nota

   L'entità IAM che modifica questa policy deve disporre dell'autorizzazione in IAM per modificare le policy.

4. Crea i file come descritto nelle File sezioni Struttura delle directory e di questo argomento, quindi caricali in un bucket di input S3 o in un repository AWS CodeCommit, GitHub, o Bitbucket. Per ulteriori informazioni, consulta il riferimento al file di definizioni delle immagini nella Guida per l'utente. AWS CodePipeline

   Importante

   Non caricare (root directory name), ma solo i file all'interno di (root directory name)

   Se si sta utilizzando un bucket di input S3, assicurarsi di creare un file ZIP contenente i file, quindi caricarlo nel bucket di input. Non aggiungere (root directory name) al file ZIP, ma solo i file all'interno di (root directory name)

5. Create un progetto di compilazione, eseguitelo e visualizzate le informazioni sulla compilazione.

   Se utilizzi la console per creare il progetto:

   1. In Operating system (Sistema operativo), seleziona Ubuntu.

   2. In Runtime, seleziona Standard.

   3. Per Image, scegli aws/codebuild /standard:5.0.

   4. Aggiungere le seguenti variabili di ambiente:

      • AWS_DEFAULT_REGION con un valore di region-ID

      • AWS_ACCOUNT_ID con un valore di account-ID

      • IMAGE_TAG con un valore di Latest

      • IMAGE_REPO_NAME con un valore di Amazon-ECR-repo-name

   Se si utilizza AWS CLI per creare il progetto di compilazione, l' JSON-formatted input del create-project comando potrebbe essere simile a questo. (Sostituire i segnaposto con i propri valori).

   {
     "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. Conferma di CodeBuild aver inviato correttamente l'immagine Docker al repository:

   1. Apri la console Amazon ECR all'indirizzo. https://console.aws.amazon.com/ecr/

   2. Selezionare il nome del repository L'immagine deve essere elencata nella colonna Tag immagine.