Função vinculada ao serviço do Amazon ECR para cache de pull-through - Amazon ECR
Permissões de função vinculada ao serviço para o Amazon ECRCriar uma função vinculada ao serviço para o Amazon ECREditar uma função vinculada ao serviço do Amazon ECRExclusão de função vinculada ao serviço para o Amazon ECR

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Função vinculada ao serviço do Amazon ECR para cache de pull-through

O Amazon ECR usa uma função vinculada ao serviço chamada AWSServiceRoleForECRPullThroughCacheque dá permissão para o Amazon ECR realizar ações em seu nome para concluir ações de pull through cache. Para obter mais informações sobre o cache de pull-through, consulte Modelos para controlar repositórios criados durante uma ação de cache de pull-through ou replicação.

Permissões de função vinculada ao serviço para o Amazon ECR

A função AWSServiceRoleForECRPullThroughCachevinculada ao serviço confia no serviço a seguir para assumir a função.

  • pullthroughcache.ecr.amazonaws.com

Detalhes das permissões

A política de permissões da AWSECRPullThroughCache_ServiceRolePolicy está vinculada à função vinculada ao serviço. Essa política gerenciada concede permissão ao Amazon ECR para realizar as seguintes ações. Para obter mais informações, consulte AWSECRPullThroughCache_ServiceRolePolicy.

  • ecr - Permite que o serviço Amazon ECR envie imagens para um repositório privado.

  • secretsmanager:GetSecretValue— Permite que o serviço Amazon ECR recupere o conteúdo criptografado de um AWS Secrets Manager segredo. Isso é necessário ao usar uma regra de cache de pull-through para armazenar em cache imagens de um registro upstream que requer autenticação em seu registro privado. Essa permissão se aplica apenas a segredos com o prefixo de nome ecr-pullthroughcache/.

A política da AWSECRPullThroughCache_ServiceRolePolicy contém os elementos a seguir:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ECR",
            "Effect": "Allow",
            "Action": [
                "ecr:GetAuthorizationToken",
                "ecr:BatchCheckLayerAvailability",
                "ecr:InitiateLayerUpload",
                "ecr:UploadLayerPart",
                "ecr:CompleteLayerUpload",
                "ecr:PutImage"
            ],
            "Resource": "*"
        },
        {
            "Sid": "SecretsManager",
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": "arn:aws:secretsmanager:*:*:secret:ecr-pullthroughcache/*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceAccount": "${aws:PrincipalAccount}"
                }
            }
        }
    ]
}

Você deve configurar permissões para que uma entidade do IAM (por exemplo, um usuário, grupo ou função) crie, edite ou exclua uma função vinculada ao serviço. Para obter mais informações, consulte Service-linked role permissions (Permissões de nível vinculado a serviços) no Guia do usuário do IAM.

Criar uma função vinculada ao serviço para o Amazon ECR

Você não precisa criar manualmente a função vinculada ao serviço do Amazon ECR para cache de pull-through. Quando você cria uma regra de cache pull through para seu registro privado na AWS Management Console, na ou na AWS API AWS CLI, o Amazon ECR cria a função vinculada ao serviço para você.

Se você excluir essa função vinculada ao serviço e precisar criá-la novamente, poderá usar esse mesmo processo para recriar a função em sua conta. Quando você cria uma regra de cache de pull-through para seu registro privado, o Amazon ECR cria a função vinculada ao serviço para você novamente, caso ela ainda não exista.

Editar uma função vinculada ao serviço do Amazon ECR

O Amazon ECR não permite a edição manual da função vinculada ao AWSServiceRoleForECRPullThroughCacheserviço. Após a criação da função vinculada ao serviço, você não poderá alterar o nome da função, pois várias entidades podem fazer referência à função. No entanto, será possível editar a descrição da função usando o IAM. Para obter mais informações, consulte Editar um perfil vinculado ao serviço no Guia do usuário do IAM.

Exclusão de função vinculada ao serviço para o Amazon ECR

Se você não precisar mais usar um atributo ou serviço que exija uma função vinculada a um serviço, recomendamos que você exclua essa função. Dessa forma, você não tem uma entidade não utilizada que não seja monitorada ou mantida ativamente. Contudo, você deve remover as regras de cache de pull-through do seu registro em todas as regiões para poder excluir manualmente a função vinculada ao serviço.

nota

Se você tentar excluir recursos enquanto o serviço Amazon ECR ainda estiver usando as funções, sua ação de exclusão poderá falhar. Se isso acontecer, aguarde alguns minutos e tente novamente.

Para excluir os recursos do Amazon ECR usados pela função vinculada ao serviço AWSServiceRoleForECRPullThroughCache

  1. Abra o console do Amazon ECR em https://console.aws.amazon.com/ecr/.

  2. Na barra de navegação, selecione a região na qual suas regras de cache de pull-through são criadas.

  3. No painel de navegação, escolha Private registry (Registro privado).

  4. Na página Private registry (Registro privado), na seção Pull through cache configuration (Configuração de cache de pull-through), escolha Edit (Editar).

  5. Para cada regra de cache de pull-through que você criou, selecione a regra e escolha Delete rule (Excluir regra).

Como excluir manualmente o perfil vinculado ao serviço usando o IAM

Use o console do IAM AWS CLI, o ou a AWS API para excluir a função AWSServiceRoleForECRPullThroughCachevinculada ao serviço. Para obter mais informações, consulte Excluir um perfil vinculado ao serviço no Guia do usuário do IAM.