Ir para o conteúdo

Por que não consigo extrair imagens do Amazon ECR quando uso o Amazon EKS?

6 minuto de leitura
0

Não consigo extrair imagens do Amazon Elastic Container Registry (Amazon ECR) quando uso o Amazon Elastic Kubernetes Service (Amazon EKS).

Breve descrição

Não é possível extrair imagens do Amazon ECR por um dos seguintes motivos:

  • Não é possível comunicar com os endpoints do Amazon ECR.
  • Você não tem as permissões apropriadas no perfil do AWS Identity and Access Management (AWS IAM) da instância para seus nós de processamento.
  • Você não criou endpoints de interface da nuvem privada virtual (VPC).

Com base no seu caso de uso, use uma ou mais das resoluções a seguir.

Resolução

Solucione problemas de comunicação entre os nós de processamento e endpoints do Amazon ECR

Se os seus nós de processamento não conseguirem se comunicar com os endpoints do Amazon ECR, você receberá a seguinte mensagem de erro:

"Failed to pull image 'ACCOUNT.dkr.ecr.REGION.amazonaws.com/imagename:tag': rpc error: code = Unknown desc = Error response from daemon: Get https://ACCOUNT.dkr.ecr.REGION.amazonaws.com/v2/: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)"

Para resolver esse erro, confirme o seguinte:

  • A sub-rede do seu nó de processamento tem uma rota para a internet e a tabela de rotas associada à sua sub-rede está configurada corretamente.
  • O grupo de segurança associado ao seu nó de processamento permite o tráfego de saída da internet.
  • A regra de entrada e saída das suas listas de controle de acesso (ACLs) à rede permite o acesso à internet.

Atualize o perfil do IAM da instância dos seus nós de processamento

O erro a seguir ocorre em seu pod do Amazon EKS quando o perfil do IAM da instância para seus nós de processamento não tem permissão para extrair imagens do Amazon ECR:

"Warning Failed 14s (x2 over 28s) kubelet, ip-000-000-000-000.us-west-2.compute.internal Failed to pull image 'ACCOUNT.dkr.ecr.REGION.amazonaws.com/imagename:tag': rpc error: code = Unknown desc = Error response from daemon: Get https://ACCOUNT.dkr.ecr.REGION.amazonaws.com/v2/imagename/manifests/tag: no basic auth credentials Warning Failed 14s (x2 over 28s) kubelet, ip-000-000-000-000.us-west-2.compute.internal Error: ErrImagePull Normal BackOff 2s (x2 over 28s) kubelet, ip-000-000-000-000.us-west-2.compute.internal Back-off pulling image 'ACCOUNT.dkr.ecr.REGION.amazonaws.com/imagename:tag' Warning Failed 2s (x2 over 28s) kubelet, ip-000-000-000-000.us-west-2.compute.internal Error: ImagePullBackOff"

Para resolver esse erro, confirme se seus nós de processamento usam a política gerenciada do IAM AmazonEC2ContainerRegistryReadOnly. Ou atualize o perfil de instância do Amazon Elastic Compute Cloud (Amazon EC2) dos seus nós de processamento com as seguintes permissões do IAM:

"ecr:GetAuthorizationToken","ecr:BatchCheckLayerAvailability","ecr:GetDownloadUrlForLayer","ecr:GetRepositoryPolicy","ecr:DescribeRepositories","ecr:ListImages","ecr:DescribeImages","ecr:BatchGetImage","ecr:GetLifecyclePolicy","ecr:GetLifecyclePolicyPreview","ecr:ListTagsForResource","ecr:DescribeImageScanFindings"

Importante: É uma prática recomendada usar a política AmazonEC2ContainerRegistryReadOnly e evitar políticas duplicadas.

O perfil do IAM atualizado da instância dá aos seus nós de processamento a permissão de acessar o Amazon ECR e extrair imagens por meio do kubelet. O kubelet busca e atualiza periodicamente as credenciais do Amazon ECR. Para obter mais informações, consulte Imagens no site do Kubernetes.

Valide as políticas do seu repositório

Para confirmar se as políticas do seu repositório estão corretas, conclua as seguintes etapas:

  1. Abra o console do Amazon ECR em sua conta primária da AWS.
  2. Vá até a região da AWS que contém o repositório do Amazon ECR.
  3. No painel de navegação, clique em Repositórios e selecione o repositório que você deseja verificar.
  4. No painel de navegação, clique em Permissões. Em seguida, verifique se seu repositório tem as permissões corretas. Esse exemplo de política a seguir permite que um usuário específico do IAM descreva o repositório e as imagens dentro dele:
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ECR Repository Policy",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:user/username"
            },
            "Action": [
                "ecr:DescribeImages",
                "ecr:DescribeRepositories"
            ],
            "Resource": "arn:aws:ecr:REGION:cross-aws-account-id:repository/repo-name"
        }
    ]
}

Observação: substitua 123456789012 pelo ID da sua conta e username pelo nome de usuário ou perfil do IAM. Substitua REGION pela sua região, cross-aws-account-id pelo ID da sua conta e repo-name pelo nome do seu repositório do Amazon ECR.

Configure as políticas do seu repositório para permitir o acesso entre contas do Amazon ECR

Se você não tiver acesso às imagens de contêiner em outra conta, o kubelet falhará com a seguinte mensagem de erro:

<aws-account-containing-eks-cluster><node-instance-role-for-worker-node>"Failed to pull image 'cross-aws-account-id:.dkr.ecr.REGION.amazonaws.com/repo-name:image-tag': rpc error: code = Unknown desc = Error response from daemon: pull access denied for arn:aws:ecr:REGION:cross-aws-account-id:repository/repo-name, repository does not exist or may require 'docker login': denied: User: arn:aws:sts:::assumed-role/ is not authorized to perform: ecr:BatchGetImage on resource: arn:aws:ecr:REGION:cross-aws-account-id:repository/repo-name"

Para resolver esse erro, use a seguinte política:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/eksctl-cross-account-ecr-access-n-NodeInstanceRole"
            },
            "Action": [
                "ecr:GetAuthorizationToken",
                "ecr:BatchCheckLayerAvailability",
                "ecr:GetDownloadUrlForLayer",
                "ecr:GetRepositoryPolicy",
                "ecr:DescribeRepositories",
                "ecr:ListImages",
                "ecr:DescribeImages",
                "ecr:BatchGetImage",
                "ecr:GetLifecyclePolicy",
                "ecr:GetLifecyclePolicyPreview",
                "ecr:ListTagsForResource",
                "ecr:DescribeImageScanFindings"
            ],
            "Resource": "*"
        }
    ]
}

Observação: substitua 123456789012 pelo ID da sua conta e eksctl-cross-account-ecr-access-n-NodeInstanceRole pelo perfil do IAM da instância do seu nó. Use o nome do recurso da Amazon (ARN) do perfil do IAM da instância na política do Amazon ECR, não o ARN do perfil da instância.

A política permite que o perfil do IAM de uma instância em uma conta descreva e extraia imagens de contêiner de um repositório do Amazon ECR em outra conta.

Crie endpoints de interface da VPC

Para extrair imagens do Amazon ECR, você deve criar e configurar endpoints de interface da VPC para o Amazon ECS.

Valide a configuração do perfil de execução do seu pod

Se o seu pod CoreDNS do AWS Fargate estiver preso no estado ImagePullBackOff quando você recupera imagens dos repositórios hospedados na Amazon, você receberá a seguinte mensagem de erro:

"Warning Failed 27s (x2 over 40s) kubelet Failed to pull image '151284513677.dkr.ecr.eu-central-1.amazonaws.com/coredns:latest': rpc error: code = Unknown desc = failed to pull and unpack image '151284513677.dkr.ecr.eu-central-1.amazonaws.com/coredns:latest': failed to resolve reference '151284513677.dkr.ecr.eu-central-1.amazonaws.com/coredns:latest': pulling from host 151284513677.dkr.ecr.eu-central-1.amazonaws.com failed with status code [manifests latest]: 401 Unauthorized"

Para resolver esse erro, configure o perfil de execução do seu pod para usar AmazonEKSFargatePodExecutionRolePolicy.

Exemplo de política:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/eksctl-cross-account-ecr-access-n-NodeInstanceRole"
            },
            "Action": [
                "ecr:GetAuthorizationToken",
                "ecr:BatchCheckLayerAvailability",
                "ecr:GetDownloadUrlForLayer",
                "ecr:GetRepositoryPolicy",
                "ecr:DescribeRepositories",
                "ecr:ListImages",
                "ecr:DescribeImages",
                "ecr:BatchGetImage",
                "ecr:GetLifecyclePolicy",
                "ecr:GetLifecyclePolicyPreview",
                "ecr:ListTagsForResource",
                "ecr:DescribeImageScanFindings"
            ],
            "Resource": "*"
        }
    ]
}

Observação: substitua 123456789012 pelo ID da sua conta e eksctl-cross-account-ecr-access-n-NodeInstanceRole pelo perfil do IAM da instância do seu nó.

AWS OFICIALAtualizada há 8 meses