Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Solución de problemas generales de Amplify
La siguiente información puede ayudarlo a solucionar problemas generales con Amplify Hosting.
Temas
Código de estado HTTP 429 (demasiadas solicitudes)
Amplify controla la cantidad de solicitudes por segundo (RPS) a su sitio web en función del tiempo de procesamiento y la transferencia de datos que consumen las solicitudes entrantes. Si su aplicación devuelve un código de estado HTTP 429, las solicitudes entrantes exceden el tiempo de procesamiento y transferencia de datos asignado a su aplicación. Este límite de aplicaciones se administra mediante la cuota de servicio REQUEST_TOKENS_PER_SECOND de Amplify. Para obtener más información sobre las cuotas, consulte Service Quotas de Amplify Hosting.
Para solucionar este problema, recomendamos optimizar la aplicación para reducir la duración de las solicitudes y la transferencia de datos a fin de aumentar la RPS de la aplicación. Por ejemplo, con los mismos 20 000 tokens, una página SSR altamente optimizada que responda en 100 milisegundos puede admitir una RPS más alta en comparación con una página con una latencia superior a 200 milisegundos.
Del mismo modo, una aplicación que devuelva un tamaño de respuesta de 1 MB consumirá más tokens que una aplicación que devuelva uno de 250 KB.
También le recomendamos que configure encabezados que maximicen el tiempo que una respuesta determinada se almacena en la CloudFront memoria caché para aprovechar la memoria caché de Amazon configurando Cache-Control encabezados que maximicen el tiempo que una respuesta determinada se almacena en la memoria caché para aprovechar la memoria caché de Amazon. Las solicitudes que se distribuyen desde la CloudFront memoria caché no se tienen en cuenta en el límite de velocidad. Cada CloudFront distribución puede gestionar hasta 250 000 solicitudes por segundo, lo que le permite escalar su aplicación a un nivel muy alto mediante la memoria caché. Para obtener más información sobre la CloudFront caché, consulte Optimización del almacenamiento en caché y la disponibilidad en la Guía para CloudFront desarrolladores de Amazon.
La consola Amplify no muestra el estado de compilación ni la hora de la última actualización de mi aplicación
Al navegar a la página Todas las aplicaciones de la consola de Amplify, se muestra un mosaico para cada una de las aplicaciones de la región actual. Si no ves el estado de compilación de una aplicación, como Implementada, ni la hora de la última actualización, significa que la aplicación no tiene ninguna rama de Production fase asociada.
Para enumerar las aplicaciones en la consola, Amplify usa la ListApps API. Amplify usa el ProductionBranch.status atributo para mostrar el estado de la compilación y el ProductionBranch.lastDeployTime atributo para mostrar la hora de la última actualización. Para obtener más información sobre esta API, consulta la documentación ProductionBranchde la API de Amplify Hosting.
Siga estas instrucciones para asociar una Production etapa a la ramificación de la aplicación.
-
Inicia sesión en la consola de Amplify
. -
En la página Todas las aplicaciones, seleccione la aplicación que desea actualizar.
-
En el panel de navegación, selecciona Configuración de la aplicación y, a continuación, Configuración de sucursal.
-
En la sección Configuración de sucursal, selecciona Editar.
-
Para la ramificación de producción, elija el nombre de ramificación que desea utilizar.
-
Seleccione Save.
-
Vuelva a la página Todas las aplicaciones. Ahora deberían mostrarse el estado de compilación y la hora de la última actualización de tu aplicación.
No se crean vistas previas web para las nuevas solicitudes de cambios
La función de vistas previas web te permite previsualizar los cambios de las solicitudes de extracción antes de fusionarlos en una rama de integración. La vista previa web presenta todas las solicitudes de extracción realizadas en el repositorio en una URL de vista previa única. Esta URL es diferente a la de su sitio principal.
Si has activado las vistas previas web de tu aplicación, pero no se están creando para una nueva PRs, investiga si alguna de las siguientes razones es la causa del problema.
-
Comprueba si tu aplicación ha alcanzado la cuota máxima
Branches per appde servicio. Para obtener más información sobre las cuotas, consulte Service Quotas de Amplify Hosting.Para mantenerte dentro de la cuota predeterminada de 50 sucursales por aplicación, considera habilitar la eliminación automática de sucursales en tu aplicación. Esto evitará que acumules sucursales en tu cuenta que ya no existen en tu repositorio.
-
Si utilizas un GitHub repositorio público y tu aplicación Amplify tiene una función de servicio de IAM asociada, Amplify no crea vistas previas por motivos de seguridad. Por ejemplo, las aplicaciones con backend y aquellas que se implementan en la plataforma de alojamiento de
WEB_COMPUTErequieren un rol de servicio de IAM. Por lo tanto, si su repositorio es público, no podrá habilitar las vistas previas web para este tipo de aplicaciones.Para permitir que las vistas previas web funcionen en tu aplicación, puedes desasociar la función de servicio (si la aplicación no tiene un backend o no es una
WEB_COMPUTEaplicación) o puedes hacer que el repositorio sea privado. GitHub
Mi implementación manual está bloqueada con un estado pendiente en la consola Amplify
Las implementaciones manuales le permiten publicar su aplicación web con Amplify Hosting sin necesidad de conectar un proveedor de Git. Puede utilizar una de las siguientes cuatro opciones de implementación.
-
Arrastra y suelta la carpeta de aplicaciones en la consola de Amplify.
-
Arrastra y suelta un archivo.zip (que contiene los artefactos de construcción de tu sitio) en la consola de Amplify.
-
Cargue un archivo.zip (que contiene los artefactos de creación de su sitio) en un bucket de Amazon S3 y conecte el bucket a una aplicación en la consola de Amplify.
-
Usa una URL pública que apunte a un archivo.zip (que contiene los artefactos de creación de tu sitio) en la consola de Amplify.
Somos conscientes de que hay problemas con la función de arrastrar y soltar cuando se utiliza una carpeta de aplicaciones para una implementación manual en la consola Amplify. Estas implementaciones pueden fallar por las siguientes razones.
-
Se producen problemas de red transitorios.
-
Se produce un cambio local en los archivos durante la carga.
-
La sesión del navegador intenta cargar una gran cantidad de activos estáticos simultáneamente.
Mientras trabajamos para mejorar la fiabilidad de nuestras subidas mediante la función de arrastrar y soltar, te recomendamos que utilices un archivo.zip en lugar de arrastrar y soltar las carpetas de la aplicación.
Recomendamos encarecidamente subir un archivo.zip a un bucket de Amazon S3, ya que esto evita la carga de archivos desde la consola Amplify y proporciona una mayor fiabilidad para las implementaciones manuales. La integración de Amplify con Amazon S3 simplifica este proceso. Para obtener más información, consulte Implementación de un sitio web estático en Amplify desde un bucket de Amazon S3.
Necesito actualizar la versión Node.js de mi aplicación
Amplify finaliza el soporte para las aplicaciones que utilizan las versiones 16 y 18 de Node.js el 15 de septiembre de 2025. Las aplicaciones que ya estén desplegadas seguirán ejecutándose. Sin embargo, después de esta fecha, no podrá implementar actualizaciones en su aplicación hasta que actualice a la versión 20 o posterior de Node.js.
Si utiliza la imagen de compilación de Amazon Linux 2023, la versión 20 de Node.js es compatible de forma predeterminada. A partir del 15 de septiembre de 2025, la imagen AL2 023 admitirá automáticamente la Node.js 22 y cambiará su versión Node.js predeterminada de la 18 a la 22.
Amazon Linux 2 (AL2) no admite automáticamente la versión 20 o posterior de Node.js. Si está utilizando actualmente AL2, recomendamos que cambie a AL2 023. Puede cambiar la imagen de compilación en la consola de Amplify. También puede usar una imagen de compilación personalizada que sea compatible con la versión de Node.js que especifique.
Antes de actualizar, le recomendamos que pruebe la aplicación en una nueva ramificación para comprobar que funciona correctamente.
Opciones de actualización
- Amplify.
Puede utilizar la función de actualizaciones de paquetes en tiempo real de la consola Amplify para especificar la versión de Node.js que se va a utilizar. Para obtener instrucciones, consulte Uso de versiones específicas de paquetes y dependencias en la imagen de compilación.
- Imagen de compilación personalizada
Si utilizas una imagen de compilación personalizada y la NVM está instalada en la imagen, puedes añadirla
nvm install 20a tu Dockerfile. Para obtener más información sobre los requisitos y las instrucciones de configuración de una imagen de compilación personalizada, consulte. Personalización de la imagen de compilación- Configuración de compilación
Para especificar la versión de Node.js que se utilizará en la configuración de
amplify.ymlcompilación de la aplicación, añada elnvm usecomando a la sección de comandos de PreBuild. Para obtener instrucciones sobre cómo actualizar la configuración de compilación de una aplicación, consulteAjuste de la configuración de compilación de una aplicación de Amplify.El siguiente ejemplo muestra cómo personalizar la configuración de compilación para establecer la versión predeterminada de Node.js en Node.js 18 y actualizar a Node.js versión 20 en una rama de prueba denominada
node-20.frontend: phases: preBuild: commands: - nvm use 18 - if [ "${AWS_BRANCH}" = "node-20" ]; then nvm use 20; fiaviso
Tenga en cuenta que
preBuildlos comandos se ejecutan después de las actualizaciones de paquetes en tiempo real. La versión de Node.js especificada por elnvm usecomando anulará la versión de Node.js establecida por las actualizaciones de paquetes en vivo.
