Effettuare richieste ai registri Amazon ECR

Puoi inviare, estrarre, eliminare, visualizzare e gestire immagini OCI, immagini Docker e OCI-compatible artefatti nei registri privati di Amazon ECR utilizzando IPv4-only endpoint o endpoint dual-stack (IPv4 e IPv6). Per effettuare richieste da reti IPv4, puoi utilizzare endpoint dual-stack o IPv4. Per effettuare richieste da una rete IPv6, utilizza un endpoint dual-stack. Per ulteriori informazioni su come effettuare richieste ai registri pubblici di Amazon ECR utilizzando IPv4 e 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 oltre al supporto degli IPv4-only endpoint o degli endpoint dual-stack. Questi attributi possono includere:

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

Guida introduttiva all'invio di richieste tramite IPv6

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

Test di compatibilità degli indirizzi IP

Se utilizzi use Linux/Unix o Mac OS X, puoi verificare se puoi accedere a un endpoint dual-stack tramite 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 comando come illustrato nell'pingesempio seguente.

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

Esecuzione di richieste su IPv6 tramite gli endpoint dual-stack

Puoi effettuare chiamate API Amazon ECR su 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) e gli AWS SDK, puoi abilitare IPv6 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 sugli endpoint FIPSuse_dualstack_endpoint, consulta Dual-stack and 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 degli indirizzi IPv6 nelle policy 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 indirizzi IPv6. Se le politiche di filtraggio degli indirizzi IP non vengono aggiornate per gestire gli indirizzi IPv6, i client potrebbero erroneamente perdere o ottenere l'accesso al registro quando iniziano a utilizzare 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 indirizzi IPv4 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 gli indirizzi IPv6 non rientrano nell'intervallo consentito, questo criterio impedisce l'accesso agli indirizzi IPv6. exampleregistry

Per consentire sia gli intervalli di indirizzi IPv4 (54.240.143.0/24) che IPv6 (2001:DB8:1234:5678::/64), modificate l'elemento Condition dei criteri di registro come illustrato nell'esempio seguente. Puoi utilizzare questo formato a Condition blocchi per aggiornare le policy relative agli utenti e al 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.