View a markdown version of this page

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

AWS App Runner ya no está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cambio en la disponibilidad de AWS App Runner.

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 nueva versión de la aplicación en App Runner

Cuando creas un servicio en AWS App Runner, configuras el origen de una aplicación: una imagen de contenedor o un repositorio de código fuente. App Runner aprovisiona recursos para ejecutar tu servicio e implementa tu aplicación en ellos.

En este tema se describen las maneras de volver a implementar el código fuente de la aplicación en el servicio de App Runner cuando haya una nueva versión disponible. Puede tratarse de una nueva versión de imagen en el repositorio de imágenes o de una nueva confirmación en el repositorio de código. App Runner proporciona dos métodos para implementar 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 continuo de integración e implementación (CI/CD) para su servicio. App Runner monitoriza tu repositorio de imágenes o códigos para ver si hay cambios.

Repositorio de imágenes: cada vez que subes una nueva versión de imagen a tu repositorio de imágenes o una nueva confirmación a tu repositorio de código, App Runner la implementa 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 haga cambios en el directorio de origen, App Runner implementa todo tu repositorio. Dado que solo los cambios en el directorio de origen activan una implementación automática, es importante entender cómo la ubicación del directorio de origen afecta al alcance de una implementación automatizada.

  • Top-level directorio (raíz del repositorio): es el valor predeterminado que se establece para el directorio de origen al crear un servicio. Si tu 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 es la 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 envíe a tu repositorio que no esté en el directorio de origen no activará una implementación automática. Por lo tanto, debes usar una implementación manual para implementar los cambios que insertes fuera del directorio de origen.

nota

App Runner no admite el despliegue automático de imágenes públicas de Amazon ECR ni de imágenes de un repositorio de Amazon ECR que pertenezcan a una AWS cuenta diferente a la cuenta en la que se encuentra tu servicio.

Implementación manual

Usa la implementación manual cuando quieras iniciar de forma explícita cada implementación de tu servicio. Puedes iniciar una implementación si el repositorio que configuraste para tu servicio tiene una nueva versión que deseas implementar. Para obtener más información, consulte Implementación manual.

nota

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

Puedes configurar el método de implementación de tu servicio de las siguientes maneras:

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

    Configuración del método de implementación de App Runner
Comparación de despliegues automáticos y manuales

Tanto las implementaciones automáticas como las manuales arrojan 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 CLIImplementación manualEn la sección siguiente se proporcionan los procedimientos para ello.

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

Implementación manual

En el caso de la implementación manual, debe iniciar de forma explícita cada implementación en su servicio. Cuando tengas una nueva versión de la imagen o el código de tu aplicación lista para implementarse, puedes consultar las siguientes secciones para obtener información sobre cómo realizar una implementación con 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 implementarla mediante la consola de App Runner
  1. Abre la consola de App Runner y, en la lista de regiones, selecciona tu Región de AWS.

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

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

    La página del panel del servicio de App Runner muestra la lista de actividades
  3. Elija Implementar.

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

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

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

    nota

    Para aumentar la seguridad de tus aplicaciones de App Runner, el dominio*.awsapprunner.com está registrado en la lista pública de sufijos (PSL). https://publicsuffix.org/ 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, consulta la Set-Cookie página de la Red de desarrolladores de Mozilla.

App Runner API or AWS CLI

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