Effettuare richieste ai registri Amazon ECR

Puoi inviare, estrarre, eliminare, visualizzare e gestire immagini OCI, immagini Docker e artefatti compatibili con OCI nei registri privati di Amazon ECR utilizzando endpoint solo IPv4 o endpoint dual-stack (and). IPv4 IPv6 Per effettuare richieste dalle reti, puoi utilizzare dual-stack o endpoint. IPv4 IPv4 Per effettuare richieste da una IPv6 rete, utilizza un endpoint dual-stack. Per ulteriori informazioni su come effettuare richieste ai registri pubblici di Amazon ECR utilizzando IPv4 endpoint dual-stack, consulta Effettuare richieste ai registri pubblici Amazon ECR. Non sono previsti costi aggiuntivi per l'accesso ad Amazon ECR tramite IPv6. Per ulteriori informazioni sui prezzi, consulta i prezzi di Amazon Elastic Container Registry.

Gli endpoint Amazon ECR sono designati da attributi che non supportano IPv4 solo endpoint o endpoint dual-stack. Questi attributi possono includere:

Per ulteriori informazioni sugli endpoint di servizio supportati dal client dual-stack IPv4, Docker e OCI, che gestisce le chiamate API Amazon ECR dalla AWS CLI, consulta Service endpoints. AWS SDKs

Inizia a inoltrare richieste su IPv6

Per effettuare una richiesta a un registro Amazon ECR IPv6, devi utilizzare un endpoint dual-stack. Prima di accedere a un registro Amazon ECR IPv6, verifica i seguenti requisiti:

Test di compatibilità degli indirizzi IP

Se utilizzi Linux/Unix o Mac OS X, puoi verificare se puoi accedere a un endpoint dual-stack IPv6 utilizzando il comando come mostrato nell'esempio seguente: curl

curl --verbose https://ecr.us-west-2.api.aws

* About to connect() to ecr.us-west-2.api.aws port 443 (#0)
* Trying IPv6 address... connected
* Connected to ecr.us-west-2.api.aws (IPv6 address) port 443 (#0)
> Host: ecr.us-west-2.api.aws
* Request completely sent off

Se si utilizza Microsoft Windows 7 o Windows 10, è possibile verificare se è possibile accedere a un endpoint dual-stack tramite IPv4 o IPv6 utilizzando il ping comando come illustrato nell'esempio seguente.

ping ecr.us-west-2.api.aws

Effettuare richieste utilizzando endpoint dual-stack IPv6

Puoi effettuare chiamate API Amazon ECR IPv6 utilizzando endpoint dual-stack. La funzionalità e le prestazioni delle operazioni dell'API Amazon ECR rimangono costanti indipendentemente dal fatto che utilizzi IPv4 o IPv6.

Quando usi AWS Command Line Interface (AWS CLI) and AWS SDKs, puoi IPv6 abilitarlo utilizzando un parametro o un flag per passare a un endpoint dual-stack o specificando direttamente l'endpoint dual-stack nel tuo file di configurazione per sovrascrivere l'endpoint Amazon ECR predefinito. Puoi anche apportare modifiche alla configurazione utilizzando un comando impostato su true nel profilo predefinito. use_dualstack_endpoint Per ulteriori informazioni suuse_dualstack_endpoint, consulta Endpoint Dual-stack e FIPS.

Utilizzo degli endpoint Amazon ECR dalla CLI docker

Dopo aver effettuato l'accesso al tuo repository Amazon ECR e taggato l'immagine, puoi inviare ed estrarre immagini OCI e immagini Docker da e verso i registri Amazon ECR. Gli esempi seguenti mostrano i comandi docker push e docker pull con entrambi gli endpoint dual-stack.

Utilizzo IPv6 degli indirizzi nelle politiche IAM

Prima di accedere a un registro utilizzando IPv6, assicurati che le politiche del tuo utente IAM e del registro Amazon ECR che utilizzano il filtro degli indirizzi IP includano intervalli di IPv6 indirizzi. Se le politiche di filtraggio degli indirizzi IP non vengono aggiornate per gestire IPv6 gli indirizzi, i client potrebbero erroneamente perdere o accedere al registro quando iniziano a utilizzarlo. IPv6 Per ulteriori informazioni sulla gestione delle autorizzazioni di accesso con IAM, consulta Identity and Access Management per Amazon Elastic Container Registry.

Le policy IAM che filtrano gli indirizzi IP utilizzano gli operatori di condizione degli indirizzi IP. Il seguente esempio di politica del registro mostra come identificare l'54.240.143.*intervallo di IPv4 indirizzi consentiti utilizzando gli operatori delle condizioni degli indirizzi IP. A tutti gli indirizzi IP al di fuori di questo intervallo viene negato l'accesso al registro (exampleregistry). Poiché tutti IPv6 gli indirizzi non rientrano nell'intervallo consentito, questa politica impedisce l'accesso IPv6 agli indirizziexampleregistry.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "IPAllow",
      "Effect": "Allow",
      "Principal": "*",
      "Action": "ecr:*",
      "Resource": "arn:aws:ecr:::exampleregistry/*",
      "Condition": {
         "IpAddress": {"aws:SourceIp": "54.240.143.0/24"}
      } 
    } 
  ]
}

Per consentire sia gli IPv4 intervalli di indirizzi IPv6 (2001:DB8:1234:5678::/64) che (), modificate l'elemento Condition della politica di registro come illustrato nell'esempio seguente. 54.240.143.0/24 Puoi utilizzare questo formato a Condition blocchi per aggiornare sia le politiche degli utenti che quelle del registro di sistema IAM.

       "Condition": {
         "IpAddress": {
            "aws:SourceIp": [
              "54.240.143.0/24",
               "2001:DB8:1234:5678::/64"
             ]
          }
        }

Puoi rivedere le tue policy utente IAM utilizzando la console IAM all'indirizzo https://console.aws.amazon.com/iam/. Per ulteriori informazioni su IAM, consulta la Guida per l'utente di IAM.