Ritaggare un'immagine in Amazon ECR

Con le immagini Docker Image Manifest V2 Schema 2, puoi usare l'opzione --image-tag del comando put-image per inserire nuovamente un tag in un'immagine esistente. Puoi inserire nuovamente il tag senza estrarre o inviare l'immagine con Docker. Per le immagini più grandi, questo processo consente di risparmiare una notevole quantità di larghezza di banda di rete e il tempo richiesto per reinserire un tag a un'immagine.

Per inserire nuovamente un tag in un'immagine (AWS CLI)

Per rietichettare un'immagine con AWS CLI

1. Utilizza il comando batch-get-image per ottenere il manifesto dell'immagine al fine di inserire nuovamente il tag nell'immagine e scriverla su un file. In questo esempio, il manifesto di un'immagine con il tag, latest, nel repository, amazonlinux, viene scritto in una variabile di ambiente denominata MANIFEST.

   MANIFEST=$(aws ecr batch-get-image --repository-name amazonlinux --image-ids imageTag=latest --output text --query 'images[].imageManifest')

2. Usa l'--image-tagopzione del put-image comando per inserire il manifesto dell'immagine su Amazon ECR con un nuovo tag. In questo esempio, l'immagine è etichettata come 2017.03.

   Nota

   Se l'--image-tagopzione non è disponibile nella tua versione di AWS CLI, esegui l'aggiornamento alla versione più recente. Per ulteriori informazioni, consulta Installazione dell' AWS Command Line Interface nella Guida per l'utente dell'AWS Command Line Interface .

   aws ecr put-image --repository-name amazonlinux --image-tag 2017.03 --image-manifest "$MANIFEST"

3. Verifica che il nuovo tag dell'immagine sia collegato all'immagine. Nell'output seguente, l'immagine presenta i tag latest e 2017.03.

   aws ecr describe-images --repository-name amazonlinux

   L'output è il seguente:

   {
       "imageDetails": [
           {
               "imageSizeInBytes": 98755613,
               "imageDigest": "sha256:8d00af8f076eb15a33019c2a3e7f1f655375681c4e5be157a26EXAMPLE",
               "imageTags": [
                   "latest",
                   "2017.03"
               ],
               "registryId": "aws_account_id",
               "repositoryName": "amazonlinux",
               "imagePushedAt": 1499287667.0
           }
       ]
   }

Per inserire nuovamente un tag in un'immagine (AWS Tools for Windows PowerShell)

Per rietichettare un'immagine con AWS Tools for Windows PowerShell

1. Utilizzare il cmdlet Get-ECRImageBatch per ottenere la descrizione dell'immagine a cui assegnare nuovamente il tag e scriverla su una variabile di ambiente. In questo esempio, un'immagine con il tag, latest, nel repository, amazonlinux, viene scritto nella variabile di ambiente, $Image.

   Nota

   Se il tuo sistema non dispone del cmdlet Get-ECRImageBatch, consulta Configurazione di AWS Tools for Windows PowerShell nella Guida per l'utente di AWS Tools for Windows PowerShell .

   $Image = Get-ECRImageBatch -ImageId @{ imageTag="latest" } -RepositoryName amazonlinux

2. Scrivi il manifesto dell'immagine nella $Manifest variabile d'ambiente.

   $Manifest = $Image.Images[0].ImageManifest

3. Utilizza l'-ImageTagopzione del Write-ECRImage cmdlet per inserire il manifesto dell'immagine in Amazon ECR con un nuovo tag. In questo esempio, l'immagine è contrassegnata come 2017.09.

   Write-ECRImage -RepositoryName amazonlinux -ImageManifest $Manifest -ImageTag 2017.09

4. Verifica che il nuovo tag dell'immagine sia collegato all'immagine. Nell'output seguente, l'immagine presenta i tag latest e 2017.09.

   Get-ECRImage -RepositoryName amazonlinux

   L'output è il seguente:

   ImageDigest                                                             ImageTag
   -----------                                                             --------
   sha256:359b948ea8866817e94765822787cd482279eed0c17bc674a7707f4256d5d497 latest
   sha256:359b948ea8866817e94765822787cd482279eed0c17bc674a7707f4256d5d497 2017.09