Implementación de una aplicación Next.js en Amplify Hosting - AWS Amplify Hospedaje
Paso 1: Conectar un repositorioPaso 2: Confirmar la configuración de compilaciónPaso 3: implementación de la aplicaciónPaso 4: Limpieza de recursos (opcional)Agregar características a su aplicación

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.

Implementación de una aplicación Next.js en Amplify Hosting

En este tutorial, se explica cómo crear e implementar una aplicación Next.js desde un repositorio de Git.

Antes de comenzar este tutorial, complete los siguientes requisitos previos.

Registro en una Cuenta de AWS

Si aún no es cliente de AWS, debe seguir las instrucciones en línea para crear una Cuenta de AWS. Cuando lo haga, tendrá acceso a Amplify y otros servicios de AWS que puede usar con su aplicación.

Crear una aplicación

Cree una aplicación Next.js básica para utilizarla en este tutorial. Para ello, siga las instrucciones create-next-app en la documentación de Next.js.

Creación de un repositorio de Git

Amplify admite GitLab, GitHub y Bitbucket y AWS CodeCommit. Envíe la aplicación create-next-app a su repositorio de Git.

Paso 1: Conectar un repositorio de Git

En este paso, conecta la aplicación Next.js en un repositorio de Git a Amplify Hosting.

Conexión de una aplicación a un repositorio de Git

  1. Abra la consola de Amplify.

  2. Si va a implementar su primera aplicación en la región actual, de forma predeterminada empezará desde la página de servicio de AWS Amplify.

    Elija Crear nueva aplicación en la parte superior de la página.

  3. En la página Comenzar a crear con Amplify, seleccione el proveedor de repositorios de Git y, a continuación, elija Siguiente.

    Amplify usa la característica de aplicaciones de GitHub para autorizar el acceso de Amplify a los repositorios de GitHub. Para obtener más información sobre la instalación y autorización de la aplicación de GitHub, consulte Configurar el acceso de Amplify a repositorios de GitHub.

    nota

    Después de autorizar la consola de Amplify con Bitbucket, GitLab o AWS CodeCommit, Amplify obtiene un token de acceso del proveedor del repositorio, pero no lo almacena en los servidores de AWS. Amplify obtiene acceso a su repositorio utilizando claves de implementación instaladas solo en un repositorio específico.

  4. En la página Añadir ramificación de repositorio, siga estos pasos:

    1. Seleccione el nombre del repositorio que desea conectar.

    2. Seleccione el nombre de la ramificación del repositorio que desea conectar.

    3. Elija Siguiente.

Paso 2: Confirmar la configuración de compilación

Amplify detecta automáticamente la secuencia de comandos de compilación que se va a ejecutar en la ramificación que se va a implementar. En este paso, se revisa y confirma la configuración de compilación.

Confirmación de la configuración de compilación de una aplicación

  1. En la página de Configuración de la aplicación, busque la sección Configuración de compilación.

    Compruebe que el comando de compilación de Frontend y el directorio de salida de compilación sean correctos. Para esta aplicación Next.js de ejemplo, el directorio de salida de compilación está establecido en .next.

  2. El procedimiento para agregar un rol de servicio varía en función de si desea crear uno nuevo o usar uno existente.

    • Creación de un nuevo rol:

      1. Elija Crear y utilizar un nuevo rol de servicio.

    • Uso de un rol existente:

      1. Elija Usar un rol existente.

      2. En la lista de roles de servicio, seleccione el que desee utilizar.

  3. Elija Siguiente.

Paso 3: implementación de la aplicación

En este paso, implementa su aplicación en una red de entrega de contenido (CDN) global de AWS.

Guardar e implementar una aplicación

  1. En la página de revisión, confirme que los detalles del repositorio y la configuración de la aplicación son correctos.

  2. Elija Guardar e implementar. La compilación de frontend suele tardar de 1 a 2 minutos, pero puede variar en función del tamaño de la aplicación.

  3. Una vez completada la implementación, podrá ver su aplicación con el enlace en el dominio predeterminado amplifyapp.com.

nota

Para aumentar la seguridad de las aplicaciones de Amplify, el dominio amplifyapp.com se ha registrado en la lista de sufijos públicos (PSL). Para una mayor seguridad, le recomendamos que utilice cookies con un prefijo __Host- si alguna vez necesita configurar cookies confidenciales en el nombre de dominio predeterminado de las aplicaciones de Amplify. Esta práctica le ayudará a proteger su dominio de los intentos de falsificación de solicitudes entre sitios (CSRF). Para obtener más información, consulte la página de configuración de cookies en la red de desarrolladores de Mozilla.

Paso 4: Limpieza de recursos (opcional)

Si ya no necesita la aplicación que implementó para el tutorial, puede eliminarla. Este paso le permite asegurarse de que no se le cobre por los recursos que no vaya a utilizar.

Eliminación de una aplicación

  1. En Configuración de la aplicación del menú del panel de navegación, elija Configuración general.

  2. En la página Configuración general, elija Eliminar aplicación.

  3. En la ventana de confirmación, introduzca delete. A continuación, elija Eliminar aplicación.

Agregar características a su aplicación

Ahora que tiene una aplicación implementada en Amplify, puede explorar algunas de las siguientes características disponibles para su aplicación alojada.

Variables de entorno

Las aplicaciones suelen necesitar información de configuración en el tiempo de ejecución. Estas configuraciones pueden ser los detalles de conexión de la base de datos, las claves de API o los parámetros. Las variables de entorno proporcionan una manera de exponer estas configuraciones en el momento de la compilación. Para obtener más información, consulte Environment variables.

Dominios personalizados

En este tutorial, Amplify aloja su aplicación en el dominio amplifyapp.com predeterminado con una URL como https://branch-name.d1m7bkiki6tdw1.amplifyapp.com. Si conecta su aplicación a un dominio personalizado, los usuarios verán que su aplicación está alojada en una URL personalizada, como https://www.example.com. Para obtener más información, consulte Setting up custom domains.

Vista previa de una solicitud de extracción

Las vistas previas de las solicitudes de extracción ofrecen una manera de previsualizar los cambios de las solicitudes de extracción (PR) antes de fusionar el código en una ramificación de producción o integración. Para obtener más información, consulte Web previews for pull requests.

Administrar varios entornos

Para saber cómo Amplify trabaja con las ramificaciones de características y los flujos de trabajo de GitFlow para admitir varias implementaciones, consulte Feature branch deployments and team workflows.