Fazer solicitações aos registros do Amazon ECR

Você pode enviar, extrair, excluir, visualizar e gerenciar imagens OCI, imagens Docker e OCI-compatible artefatos nos registros privados do Amazon ECR usando IPv4-only endpoints ou endpoints de pilha dupla (IPv4 e IPv6). Para fazer solicitações de redes IPv4, você pode usar endpoints de pilha dupla ou IPv4. Para fazer solicitações de uma rede IPv6, use um endpoint de pilha dupla. Para obter mais informações sobre como fazer solicitações aos registros públicos do Amazon ECR usando IPv4 e endpoints de pilha dupla, consulte Fazer solicitações aos registros públicos do Amazon ECR. Não há custo adicional para acessar o Amazon ECR por meio do IPv6. Para ter mais informações sobre preços, consulte Preços do Amazon Elastic Container Registry.

Os endpoints do Amazon ECR são designados por atributos além do suporte para endpoints ou IPv4-only endpoints de pilha dupla. Esses atributos podem incluir:

Para obter mais informações sobre endpoints de serviço suportados pelo cliente IPv4, dual-stack, Docker e OCI, que gerencia chamadas de API do Amazon ECR a partir da CLI e dos SDKs, consulte Service endpoints. AWSAWS

Conceitos básicos para fazer solicitações por meio do IPv6

Para fazer uma solicitação para um registro do Amazon ECR por meio do IPv6, você precisa usar um endpoint de pilha dupla. Antes de acessar um registro do Amazon ECR via IPv6, verifique os seguintes requisitos:

Testar a compatibilidade com endereços IP

Se você estiver usando o use Linux/Unix ou o Mac OS X, poderá testar se é possível acessar um endpoint de pilha dupla via IPv6 usando o curl comando, conforme mostrado no exemplo a seguir:

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 estiver usando o Microsoft Windows 7 ou 10, você poderá testar se é possível acessar um endpoint de pilha dupla por meio do IPv4 ou do IPv6 usando o comando ping, conforme mostrado no exemplo a seguir.

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

Como fazer solicitações por meio do IPv6 usando endpoints de pilha dupla

Você pode fazer chamadas de API do Amazon ECR por meio do IPv6 usando endpoints de pilha dupla. A funcionalidade e o desempenho das operações de API do Amazon ECR permanecem consistentes, independentemente de você usar IPv4 ou IPv6.

Ao usar o AWS Command Line Interface (AWS CLI) e AWS os SDKs, você pode habilitar o IPv6 usando um parâmetro ou sinalizador para mudar para um endpoint de pilha dupla ou especificando diretamente o endpoint de pilha dupla em seu arquivo de configuração para substituir o endpoint padrão do Amazon ECR. Você também pode fazer alterações de configuração usando um comando, que define use_dualstack_endpoint como verdadeiro no perfil padrão. Para obter mais informações sobre endpoints FIPS use_dualstack_endpoint, consulteDual-stack .

Usar endpoints do Amazon ECR a partir da CLI do Docker

Depois de entrar no repositório do Amazon ECR e marcar sua imagem, você pode enviar e extrair imagens OCI e imagens do Docker de e para os registros do Amazon ECR. Os exemplos a seguir demonstram os comandos docker push e Docker pull com os dois endpoints de pilha dupla.

Como usar endereços do IPv6 em políticas do IAM

Antes de acessar um registro usando o IPv6, certifique-se de que as políticas de usuário do IAM e de registro do Amazon ECR que usam a filtragem de endereços IP incluam intervalos de endereços do IPv6. Se as políticas de filtragem de endereços IP não estiverem atualizadas para lidar com endereços do IPv6, os clientes podem perder ou obter acesso ao registro quando começarem a usar o IPv6. Para obter mais informações sobre como gerenciar permissões de acesso com o IAM, consulte Gerenciamento de Identidade e Acesso para o Amazon Elastic Container Registry.

As políticas do IAM que filtram endereços IP usam Operadores de condição de endereço IP. O exemplo de política de registro a seguir mostra como identificar o intervalo 54.240.143.* de endereços IPv4 permitidos usando operadores de condição de endereço IP. Todos os endereços IP fora deste intervalo terão o acesso ao registro (exampleregistry) negado. Como todos os endereços do IPv6 estão fora do intervalo permitido, essa política impede que os endereços do IPv6 possam acessar o exampleregistry.

Para permitir os intervalos de endereço IPv4 (54.240.143.0/24) e IPv6 (2001:DB8:1234:5678::/64), altere o elemento de condição da política do registro conforme mostrado no exemplo a seguir. Você pode usar esse formato de bloqueio Condition para atualizar as políticas de usuário do IAM e de registro.

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

Você pode revisar suas políticas de usuário do IAM usando o console do IAM em https://console.aws.amazon.com/iam/. Para obter mais informações sobre o IAM, consulte o Guia do usuário do IAM.