AWSAmplifyDomainRole No Se Puede Encontrar: Una Solución Rápida

Vas deslizándote, desplegando tu aplicación con AWS Amplify, y entonces sucede. Un despliegue falla y te encuentras con un mensaje de error críptico: The role with name AWSAmplifyDomainRole-Z073737928BZTN2WA6J6L cannot be found. La larga cadena de números y letras es diferente para todos, pero el problema es el mismo. Este obstáculo inesperado puede detener tu despliegue en seco.

Si te has topado con este problema, no estás solo. Este es un problema conocido que puede ocurrir cuando se gestionan dominios personalizados con Amplify Hosting. Esta guía te guiará exactamente a través de lo que significa este error y proporcionará una solución clara y paso a paso para que puedas volver a entregar tu proyecto.

Entendiendo el Error “AWSAmplifyDomainRole Cannot Be Found”

Entonces, ¿qué es este AWSAmplifyDomainRole y por qué a veces desaparece?

Cuando agregas un dominio personalizado a tu aplicación Amplify, Amplify crea un rol de IAM (Gestión de Identidad y Acceso). Este rol, denominado AWSAmplifyDomainRole-…, otorga a Amplify los permisos necesarios para gestionar recursos relacionados con tu dominio, como certificados SSL/TLS a través de AWS Certificate Manager (ACM).

El error ocurre porque este rol esencial de IAM ha sido eliminado, pero la configuración de Amplify todavía espera que exista. Esto puede suceder por varias razones:

• Eliminación Manual: Alguien de tu equipo podría haber eliminado inadvertidamente el rol desde la consola de IAM, quizás durante una limpieza de roles no utilizados.
• Scripts Automatizados: Los scripts de limpieza diseñados para eliminar recursos de AWS no utilizados podrían apuntar y eliminar este rol accidentalmente.
• Reconfiguración de Dominio: A veces, eliminar y volver a agregar un dominio personalizado en una secuencia específica puede dejar la configuración en un estado inconsistente, lo que lleva a que el rol sea eliminado mientras que la referencia a él permanece.

Independientemente de la causa, el resultado es un despliegue fallido porque Amplify ya no puede encontrar el rol que necesita para gestionar tu dominio.

La Solución: Recreando el Rol IAM

Dado que el rol está ausente, la solución más directa es crearlo nuevamente con los permisos correctos. El proceso implica crear un nuevo rol de IAM y adjuntar una política de confianza específica que permite a Amplify asumirlo.

Si bien esta comunidad ha discutido este problema y está rastreado en un issue de GitHub aquí, no tienes que esperar un parche. Puedes resolverlo tú mismo en solo unos minutos siguiendo los pasos a continuación.

Guía Paso a Paso para Crear el AWSAmplifyDomainRole

Vamos a repasar la creación del rol de IAM necesario. Asegúrate de haber iniciado sesión en tu Consola de AWS antes de comenzar.

Paso 1: Navegar a la Consola de IAM

Primero, ve al servicio IAM en tu Consola de AWS. Puedes encontrarlo escribiendo “IAM” en la barra de búsqueda principal y seleccionándolo de los resultados.

Paso 2: Crear un Nuevo Rol

En el panel de control de IAM, haz clic en “Roles” en el panel de navegación de la izquierda. Luego, haz clic en el botón “Create role”.

Paso 3: Seleccionar Entidad de Confianza

Este es el paso más crítico. Debes decirle a AWS qué servicio tiene permiso para usar este rol.

1. Para el tipo de entidad de confianza, selecciona “Custom trust policy”.
2. Aparecerá un editor de JSON. Reemplaza el contenido predeterminado con la siguiente política:

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

Esta política otorga explícitamente al servicio de AWS Amplify (amplify.amazonaws.com) permiso para asumir este rol.

Después de pegar la política, haz clic en “Next”.

Paso 4: Agregar Permisos (Opcional pero Recomendado)

En la página “Add permissions”, no es estrictamente necesario adjuntar ninguna política para esta corrección específica. La relación de confianza es la parte clave. Sin embargo, Amplify usa este rol para gestionar certificados. Si continúas enfrentando problemas, puedes adjuntar la política administrada de AWS AWSCertificateManagerFullAccess por seguridad, aunque a menudo no es necesario ya que Amplify gestiona esto.

Para esta guía, omitiremos agregar permisos extra ya que la política de confianza es suficiente para resolver el error. Haz clic en “Next”.

Paso 5: Nombrar el Rol y Finalizar

Ahora, nombrarás el rol. Este es otro paso crucial: el nombre debe ser exacto.

1. Para el “Role name”, ingresa el nombre exacto que se muestra en tu mensaje de error, como AWSAmplifyDomainRole-Z073737928BZTN2WA6J6L.
2. Puedes agregar una descripción opcional, como “Rol para que AWS Amplify gestione recursos de dominio personalizado y certificados SSL.”
3. Revisa los detalles para asegurarte de que la entidad de confianza es amplify.amazonaws.com y que el nombre del rol es correcto.
4. Haz clic en el botón “Create role”.

Verás un mensaje de éxito confirmando que el rol ha sido creado.

Paso 6: Reintentar tu Despliegue de Amplify

Con el AWSAmplifyDomainRole ahora de vuelta en su lugar, regresa a tu consola de AWS Amplify y reinicia la compilación o el despliegue que falló anteriormente. Amplify ahora podrá encontrar el rol requerido y proceder con las tareas de gestión de dominio, resolviendo el error.

Una Solución Más Permanente: Prevenir la Eliminación Accidental

Volver a crear el rol es una solución rápida, pero ¿cómo evitas que esto vuelva a suceder en el futuro?

1. Educa a tu Equipo: Asegúrate de que todos en tu equipo que tengan acceso a IAM entiendan la importancia del AWSAmplifyDomainRole. Aconseja no eliminar roles de IAM a menos que estén seguros de que ya no están en uso.
2. Etiqueta tus Recursos: Aplica etiquetas al AWSAmplifyDomainRole (por ejemplo, Project: MyApp, ManagedBy: Amplify). Esto agrega contexto y puede ayudar a prevenir la eliminación accidental por parte de personas o scripts automatizados.
3. Refina los Scripts de Limpieza: Si usas scripts para limpiar recursos de AWS no utilizados, agrega una excepción para roles con el nombre AWSAmplifyDomainRole o roles etiquetados como administrados por Amplify.

Conclusión

Encontrarse con el error AWSAmplifyDomainRole cannot be found es un contratiempo común para los desarrolladores que usan dominios personalizados con AWS Amplify. Afortunadamente, la solución es sencilla. Al recrear manualmente el rol de IAM que falta con la política de confianza correcta, puedes desbloquear rápidamente tu canal de despliegue.

Esta guía te da el poder de solucionar el problema tú mismo sin esperar una actualización del servicio. Con tu rol restaurado y tu compilación pasando, puedes volver a lo que más importa: construir y entregar grandes aplicaciones.

---

Meta Information

Meta Title: Solución: AWSAmplifyDomainRole No Se Puede Encontrar en AWS Amplify
Meta Description: ¿Estás obteniendo el error “AWSAmplifyDomainRole cannot be found”? Nuestra guía paso a paso te muestra cómo solucionar este problema de AWS Amplify y poner tu despliegue en marcha.