AWSAmplifyDomainRole Não Encontrado: Uma Solução Rápida

Você está navegando tranquilamente, implantando seu aplicativo com o AWS Amplify, e então acontece. Uma implantação falha e você é atingido por uma mensagem de erro críptica: The role with name AWSAmplifyDomainRole-Z073737928BZTN2WA6J6L cannot be found. A longa string de números e letras é diferente para todos, mas o problema é o mesmo. Este obstáculo inesperado pode parar sua implantação em seus trilhos.

Se você encontrou esse problema, não está sozinho. Este é um problema conhecido que pode ocorrer ao gerenciar domínios personalizados com o Amplify Hosting. Este guia irá guiá-lo exatamente sobre o que significa esse erro e fornecerá uma solução clara e passo a passo para que você possa voltar a entregar seu projeto.

Entendendo o Erro “AWSAmplifyDomainRole Cannot Be Found”

Então, o que é esse AWSAmplifyDomainRole e por que ele às vezes desaparece?

Quando você adiciona um domínio personalizado ao seu aplicativo Amplify, o Amplify cria uma função de IAM (Identity and Access Management). Esta função, chamada AWSAmplifyDomainRole-…, concede ao Amplify as permissões necessárias para gerenciar recursos relacionados ao seu domínio, como certificados SSL/TLS através do AWS Certificate Manager (ACM).

O erro ocorre porque essa função essencial de IAM foi excluída, mas a configuração do Amplify ainda espera que ela exista. Isso pode acontecer por várias razões:

• Exclusão Manual: Alguém da sua equipe pode ter excluído inadvertidamente a função do console do IAM, talvez durante uma limpeza de funções não utilizadas.
• Scripts Automatizados: Scripts de limpeza projetados para remover recursos não utilizados da AWS podem acidentalmente direcionar e excluir esta função.
• Reconfiguração de Domínio: Às vezes, remover e adicionar novamente um domínio personalizado em uma sequência específica pode deixar a configuração em um estado inconsistente, levando à exclusão da função enquanto a referência a ela permanece.

Independentemente da causa, o resultado é uma implantação falha porque o Amplify não consegue mais encontrar a função que precisa para gerenciar seu domínio.

A Solução: Recriando a Função IAM

Como a função está faltando, a solução mais direta é criá-la novamente com as permissões corretas. O processo envolve criar uma nova função de IAM e anexar uma política de confiança específica que permite que o Amplify assuma o controle dela.

Embora este problema tenha sido discutido pela comunidade e seja rastreado em uma issue do GitHub aqui, você não precisa esperar por um patch. Você pode resolvê-lo você mesmo em apenas alguns minutos seguindo as etapas abaixo.

Guia Passo a Passo para Criar o AWSAmplifyDomainRole

Vamos percorrer a criação da função de IAM necessária. Certifique-se de estar logado em seu Console da AWS antes de começar.

Passo 1: Navegue para o Console IAM

Primeiro, vá para o serviço IAM em seu Console da AWS. Você pode encontrá-lo digitando “IAM” na barra de pesquisa principal e selecionando-o nos resultados.

Passo 2: Crie uma Nova Função

No painel do IAM, clique em “Roles” no painel de navegação à esquerda. Em seguida, clique no botão “Create role”.

Passo 3: Selecione a Entidade de Confiança

Este é o passo mais crítico. Você precisa dizer à AWS qual serviço tem permissão para usar esta função.

1. Para o tipo de entidade confiável, selecione “Custom trust policy”.
2. Um editor JSON aparecerá. Substitua o conteúdo padrão pela seguinte política:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "amplify.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Esta política concede explicitamente ao serviço AWS Amplify (amplify.amazonaws.com) permissão para assumir esta função.

Depois de colar a política, clique em “Next”.

Passo 4: Adicione Permissões (Opcional mas Recomendado)

Na página “Add permissions”, você não precisa estritamente anexar nenhuma política para esta correção específica. A relação de confiança é a parte principal. No entanto, o Amplify usa esta função para gerenciar certificados. Se você continuar enfrentando problemas, pode anexar a política gerenciada pela AWS AWSCertificateManagerFullAccess por segurança, embora muitas vezes não seja necessário, pois o Amplify gerencia isso.

Para este guia, vamos pular a adição de permissões extras, pois a política de confiança é suficiente para resolver o erro. Clique em “Next”.

Passo 5: Nomeie a Função e Finalize

Agora, você nomeará a função. Este é outro passo crucial — o nome deve ser exato.

1. Para o “Role name”, insira o nome exato mostrado em sua mensagem de erro, como AWSAmplifyDomainRole-Z073737928BZTN2WA6J6L.
2. Você pode adicionar uma descrição opcional, como “Função para o AWS Amplify gerenciar recursos de domínio personalizado e certificados SSL.”
3. Revise os detalhes para garantir que a entidade confiável é amplify.amazonaws.com e que o nome da função está correto.
4. Clique no botão “Create role”.

Você deve ver uma mensagem de sucesso confirmando que a função foi criada.

Passo 6: Tente Novamente sua Implantação no Amplify

Com o AWSAmplifyDomainRole de volta ao seu lugar, retorne ao seu console do AWS Amplify e reinicie a construção ou implantação que falhou anteriormente. O Amplify agora será capaz de encontrar a função necessária e prosseguir com as tarefas de gerenciamento de domínio, resolvendo o erro.

Uma Correção Mais Permanente: Evite a Exclusão Acidental

Criar a função novamente é uma correção rápida, mas como você evita que isso aconteça no futuro?

1. Eduque sua Equipe: Certifique-se de que todos na sua equipe que têm acesso ao IAM entendem a importância do AWSAmplifyDomainRole. Aconselhe contra a exclusão de funções de IAM, a menos que tenham certeza de que não estão mais em uso.
2. Etiquete seus Recursos: Aplique tags ao AWSAmplifyDomainRole (ex.: Project: MyApp, ManagedBy: Amplify). Isso adiciona contexto e pode ajudar a evitar a exclusão acidental por pessoas ou scripts automatizados.
3. Refine Scripts de Limpeza: Se você usa scripts para limpar recursos não utilizados da AWS, adicione uma exceção para funções com o nome AWSAmplifyDomainRole ou funções etiquetadas como gerenciadas pelo Amplify.

Conclusão

Encontrar o erro AWSAmplifyDomainRole cannot be found é um contratempo comum para desenvolvedores que usam domínios personalizados com o AWS Amplify. Felizmente, a solução é simples. Ao recriar manualmente a função de IAM que falta com a política de confiança correta, você pode desbloquear rapidamente seu pipeline de implantação.

Este guia dá a você o poder de corrigir o problema por conta própria sem esperar por uma atualização de serviço. Com sua função restaurada e sua construção aprovada, você pode voltar ao que mais importa: construir e entregar ótimos aplicativos.

---

Meta Information

Meta Title: Correção: AWSAmplifyDomainRole Não Encontrado no AWS Amplify
Meta Description: Recebendo o erro “AWSAmplifyDomainRole cannot be found”? Nosso guia passo a passo mostra como corrigir este problema do AWS Amplify e fazer sua implantação funcionar.