Esempio di «Pubblica immagine Docker su un archivio di ECR immagini Amazon» per CodeBuild

Per eseguire questo esempio

1. Se disponi già di un archivio di immagini in Amazon che ECR desideri utilizzare, vai al passaggio 3. Altrimenti, se utilizzi un utente anziché un account AWS root o un utente amministratore per lavorare con AmazonECR, aggiungi questa istruzione (tra ### BEGIN ADDING STATEMENT HERE ### e ### END ADDING STATEMENT HERE ###) all'utente (o al IAM gruppo a cui l'utente è associato). L'utilizzo di un account AWS root non è consigliato. Questa istruzione consente la creazione di ECR repository Amazon 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 Lavorare con le politiche in linea utilizzando la Guida per l'utente. AWS Management Console

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

   Nota

   L'IAMentità che modifica questa politica deve avere l'autorizzazione IAM a modificare le politiche.

2. Crea un archivio di immagini in AmazonECR. Assicurati di creare il repository nella stessa AWS regione in cui crei l'ambiente di compilazione ed esegui la build. Per ulteriori informazioni, consulta la sezione Creazione di un 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 politica del ECR repository di Amazon conceda l'accesso tramite push alle immagini per il tuo ruolo di CodeBuild servizioIAM.

3. Aggiungi questa dichiarazione (tra ### BEGIN ADDING STATEMENT HERE ### e ### END ADDING STATEMENT HERE ###) alla politica che hai allegato al tuo ruolo AWS CodeBuild di servizio. Questa dichiarazione consente di CodeBuild caricare immagini Docker nei ECR repository Amazon. 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.

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

   Nota

   L'IAMentità che modifica questa politica deve avere l'autorizzazione IAM a modificare le politiche.

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 delle 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 utilizzi un bucket di input S3, assicurati di creare un ZIP file che contenga i file, quindi caricalo nel bucket di input. Non aggiungete (root directory name) al ZIP file, ma solo i file al suo interno. (root directory name)

5. Crea un progetto di compilazione, esegui la build e visualizza le informazioni sulla build.

   Se utilizzi la console per creare il progetto:

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

   2. In Runtime, seleziona Standard.

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

   4. Aggiungere le seguenti variabili di ambiente:

      • AWS_ DEFAULT _ REGION con un valore di region-ID

      • AWS_ACCOUNT_IDcon un valore di account-ID

      • IMAGE_ TAG con un valore di Latest

      • IMAGE_ REPO _ NAME con un valore di Amazon-ECR-repo-name

   Se usi il AWS CLI per creare il progetto di compilazione, l'input in JSON formato -del create-project comando potrebbe avere un aspetto 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 aver CodeBuild inviato correttamente l'immagine Docker al repository:

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

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