Creación de servicios de App Runner

Puede crear un servicio de App Runner en el kit de herramientas para VS Code mediante el Explorador de AWS y la paleta de comandos de VS Code. Una vez que decida crear un servicio en una AWS región específica, los pasos numerados que se indican en la paleta de comandos le guiarán durante el proceso de configuración de la instancia de servicio en la que se ejecuta la aplicación.

Antes de crear un servicio de App Runner, asegúrese de haber completado los requisitos previos. Esto incluye proporcionar los IAM permisos pertinentes y confirmar el repositorio de origen específico que desea implementar.

Para crear un servicio de App Runner

1. Abre el AWS Explorador, si aún no está abierto.

2. Haga clic con el botón derecho en el nodo de App Runner y elija Create Service (Crear servicio).

   Se muestra la paleta de comandos.

3. En Seleccione un tipo de ubicación de código fuente, elija ECRo Repositorio.

   Si lo desea ECR, debe especificar una imagen de contenedor en un repositorio mantenido por Amazon Elastic Container Registry. Si elige Repository (Repositorio), especifique un repositorio de código fuente mantenido por un proveedor de repositorios compatible. Actualmente, App Runner es compatible GitHubcomo proveedor de repositorios de código fuente.

Implementación desde ECR

1. En Selecciona o introduce un repositorio de imágenes, selecciona o introduce el repositorio URL de imágenes que mantiene tu registro ECR privado de Amazon o Amazon ECR Public Gallery.

   nota

   Si especificas un repositorio de Amazon ECR Public Gallery, asegúrate de que las implementaciones automáticas estén desactivadas, ya que App Runner no admite las implementaciones automáticas de una imagen en un repositorio ECR público.

   Las implementaciones automáticas están desactivadas de forma predeterminada. Esto se indica cuando el icono del encabezado de la paleta de comandos presenta una línea diagonal a través de él. Si eligió activar las implementaciones automáticas, un mensaje le informa que esta opción puede generar costos adicionales.

2. Si en el paso de la paleta de comandos se informa de que no se han encontrado etiquetas, debe retroceder un paso y seleccionar un repositorio que contenga una imagen de contenedor etiquetada.

3. Si utilizas un registro ECR privado de Amazon, necesitas el rol de ECR acceso AppRunnerECRAccessRole, que permite a App Runner acceder a las imágenes de Amazon Elastic Container Registry (AmazonECR) de tu cuenta. Elija el icono “+” en el encabezado de la paleta de comandos para crear automáticamente este rol. (No es necesario tener un rol de acceso si la imagen está almacenada en Amazon ECR Public, donde las imágenes están disponibles públicamente).

4. En Port (Puerto), ingrese el puerto IP utilizado por el servicio (por ejemplo, Puerto 8000).

5. En Configure environment variables (Configurar variables de entorno), puede especificar un archivo que contenga variables de entorno que se utilizan para personalizar el comportamiento de la instancia de servicio. También puede omitir este paso.

6. En Name your service (Asignar un nombre al servicio), ingrese un nombre único sin espacios y pulse Enter (Intro).

7. En la configuración de instancias seleccionadas, elija una combinación de CPU unidades y memoria en GB para la instancia de servicio.

   Cuando se crea el servicio, el estado cambia de Creating (Creando) a Running (En ejecución).

8. Cuando el servicio comience a ejecutarse, haga clic con el botón derecho en él y seleccione Copy Service URL.

9. Para acceder a la aplicación implementada, pegue la copia URL en la barra de direcciones del navegador web.

Implementación desde un repositorio remoto

1. En Seleccione una conexión, elija una conexión GitHub a la que se enlace AWS. Las conexiones que están disponibles para su selección aparecen en la página de GitHub conexiones de la consola de App Runner.

2. En Seleccione un GitHub repositorio remoto, elija o introduzca un URL repositorio remoto.

   Los repositorios remotos que ya están configurados con la administración de control de código fuente de Visual Studio Code (SCM) están disponibles para su selección. También puede pegar un enlace al repositorio si no aparece en la lista.

3. En Select a branch (Seleccionar una rama), elija qué rama Git del código fuente desea implementar.

4. En Choose configuration source (Elegir el origen de configuración), especifique cómo desea definir la configuración del tiempo de ejecución.

   Si elige Use configuration file (Usar archivo de configuración), la instancia de servicio se configura mediante la configuración definida por el archivo de configuración de apprunner.yaml. Este archivo se encuentra en el directorio raíz del repositorio de la aplicación.

   Si elige Configure todos los ajustes aquí, utilice la paleta de comandos para especificar lo siguiente:

   • Runtime (Tiempo de ejecución): elija Python 3 o Nodejs 12.

   • Build command (Comando de creación): ingrese el comando para crear la aplicación en el entorno en tiempo de ejecución de la instancia de servicio.

   • Start command (Comando de inicio): ingrese el comando para iniciar la aplicación en el entorno en tiempo de ejecución de la instancia de servicio.

5. En Port (Puerto), ingrese el puerto IP utilizado por el servicio (por ejemplo, Puerto 8000).

6. En Configure environment variables (Configurar variables de entorno), puede especificar un archivo que contenga variables de entorno que se utilizan para personalizar el comportamiento de la instancia de servicio. También puede omitir este paso.

7. En Name your service (Asignar un nombre al servicio), ingrese un nombre único sin espacios y pulse Enter (Intro).

8. En la configuración de instancias seleccionadas, elija una combinación de CPU unidades y memoria en GB para la instancia de servicio.

   Cuando se crea el servicio, el estado cambia de Creating (Creando) a Running (En ejecución).

9. Cuando el servicio comience a ejecutarse, haga clic con el botón derecho en él y seleccione Copy Service URL.

10. Para acceder a la aplicación implementada, pegue la copia URL en la barra de direcciones del navegador web.

nota

Si se produce un error en el intento de crear un servicio de App Runner, el servicio muestra un estado Create failed (Error al crear) en el Explorador de AWS . Para obtener sugerencias acerca de la solución de problemas, consulte When service creation fails (Cuando falla la creación del servicio) en la Guía para desarrolladores de App Runner.