Implementación de una nueva versión de la aplicación en App Runner

Al crear un servicio en AWS App Runner, se configura una fuente de aplicación: una imagen de contenedor o un repositorio de fuentes. App Runner aprovisiona recursos para ejecutar el servicio e implementa la aplicación en ellos.

En este tema se describen las formas de volver a implementar la fuente de la aplicación en el servicio de App Runner cuando haya una nueva versión disponible. Puede ser una nueva versión de imagen en el repositorio de imágenes o una nueva confirmación en el repositorio de código. App Runner proporciona dos métodos de implementación en un servicio: automático y manual.

Métodos de implementación

App Runner proporciona los siguientes métodos para controlar cómo se inician las implementaciones de las aplicaciones.

Despliegue automático

Utilice el despliegue automático cuando desee un comportamiento de integración y despliegue continuos (CI/CD) para su servicio. App Runner supervisa el repositorio de imágenes o códigos para detectar cambios.

Repositorio de imágenes: cada vez que insertas una nueva versión de una imagen en tu repositorio de imágenes o una nueva confirmación en tu repositorio de código, App Runner la despliega automáticamente en tu servicio sin que tengas que hacer nada más.

Repositorio de código: cada vez que insertas una nueva confirmación en tu repositorio de código que realiza cambios en el directorio de origen, App Runner despliega todo el repositorio. Como solo los cambios en el directorio de origen activan una implementación automática, es importante entender cómo afecta la ubicación del directorio de origen al alcance de una implementación automática.

• Directorio de nivel superior (raíz del repositorio): este es el valor predeterminado que se establece para el directorio de origen al crear un servicio. Si el directorio de origen está establecido en este valor, significa que todo el repositorio está dentro del directorio de origen. Por lo tanto, todas las confirmaciones que envíes al repositorio de origen activarán una implementación en este caso.

• Cualquier ruta de directorio que no sea la raíz del repositorio (no predeterminada): dado que solo los cambios que se inserten en el directorio de origen activarán una implementación automática, cualquier cambio que se inserte en tu repositorio que no esté en el directorio de origen no activará una implementación automática. Por lo tanto, debes usar un despliegue manual para implementar los cambios que insertes fuera del directorio de origen.

nota

App Runner no admite la implementación automática de las imágenes públicas de Amazon ECR ni de las imágenes de un repositorio de Amazon ECR que pertenezca a una AWS cuenta diferente de la cuenta en la que se encuentra su servicio.

Implementación manual

Utilice el despliegue manual cuando desee iniciar de forma explícita cada despliegue en su servicio. Usted inicia una implementación si el repositorio que configuró para su servicio tiene una nueva versión que desee implementar. Para obtener más información, consulte Despliegue manual.

nota

Cuando ejecutas una implementación manual, App Runner implementa la fuente desde el repositorio completo.

Puede configurar el método de implementación de su servicio de las siguientes maneras:

• Consola: para un servicio nuevo que esté creando o para un servicio existente, en la sección Configuración de despliegue de la página de configuración de origen e implementación, seleccione Manual o Automático.

  

• API o AWS CLI: en una llamada a la UpdateServiceacción CreateServiceo, defina el AutoDeploymentsEnabled miembro del SourceConfigurationparámetro como False para el despliegue manual o True automático.

Comparación de despliegues automáticos y manuales

Tanto las implementaciones automáticas como las manuales producen el mismo resultado: ambos métodos implementan el repositorio completo.

La diferencia entre los dos métodos es el mecanismo de activación:

• Las implementaciones manuales se activan mediante una implementación desde la consola, una llamada a la API de App Runner o una llamada a la API de App Runner. AWS CLIDespliegue manualEn la siguiente sección, se proporcionan los procedimientos correspondientes.

• Los despliegues automáticos se activan cuando se produce un cambio en el contenido del directorio de origen.

Despliegue manual

Con la implementación manual, debe iniciar de forma explícita cada implementación en su servicio. Cuando tenga una nueva versión de la imagen o el código de la aplicación lista para su implementación, puede consultar las siguientes secciones para obtener información sobre cómo realizar una implementación mediante la consola y la API.

nota

Cuando ejecutas una implementación manual, App Runner implementa el código fuente del repositorio completo.

Implementa una versión de tu aplicación mediante uno de los siguientes métodos:

App Runner console

Para realizar la implementación mediante la consola de App Runner

1. Abre la consola de App Runner y, en la lista de regiones, selecciona la tuya Región de AWS.

2. En el panel de navegación, selecciona Servicios y, a continuación, selecciona tu servicio de App Runner.

   La consola muestra el panel de servicios con una descripción general del servicio.

   

3. Elija Implementar.

   Resultado: se inicia el despliegue de la nueva versión. En la página del panel de control del servicio, el estado del servicio cambia a Funcionamiento en curso.

4. Espere a que finalice la implementación. En la página del panel de control del servicio, el estado del servicio debería volver a ser En ejecución.

5. Para comprobar que la implementación se ha realizado correctamente, en la página del panel de control del servicio, elige el valor de dominio predeterminado, que es la URL del sitio web del servicio. Inspecciona tu aplicación web o interactúa con ella y verifica el cambio de versión.

   nota

   Para aumentar la seguridad de sus aplicaciones de App Runner, el dominio*.awsapprunner.com está registrado en la lista pública de sufijos (PSL). Para mayor seguridad, te recomendamos que utilices cookies con un __Host- prefijo si alguna vez necesitas configurar cookies confidenciales en el nombre de dominio predeterminado de tus aplicaciones de App Runner. 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.

App Runner API or AWS CLI

Para realizar la implementación mediante la API de App Runner AWS CLI, o bien, llama a la acción a la StartDeploymentAPI. El único parámetro que se debe pasar es el ARN de su servicio. Ya configuró la ubicación de origen de la aplicación cuando creó el servicio y App Runner puede encontrar la nueva versión. La implementación comienza si la llamada devuelve una respuesta correcta.