AWS App Runner dejará de estar abierto a nuevos clientes a partir del 30 de abril de 2026. Si quieres usar App Runner, regístrate antes de esa fecha. 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](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).
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.
# Creación de un servicio App Runner
AWS App Runner automatiza la transición de una imagen de contenedor o un repositorio de código fuente a un servicio web en ejecución que se escala automáticamente. Apuntas App Runner a tu imagen o código fuente y especificas solo una pequeña cantidad de configuraciones obligatorias. App Runner crea la aplicación si es necesario, aprovisiona recursos informáticos e implementa la aplicación para que se ejecute en ellos.
Al crear un servicio, App Runner crea un recurso *de servicio*. En algunos casos, es posible que tengas que proporcionar un recurso de *conexión*. Si utilizas la consola de App Runner, la consola crea implícitamente el recurso de conexión. Para obtener más información sobre los tipos de recursos de App Runner, consulte[Recursos de App Runner](architecture.md#architecture.resources). Estos tipos de recursos tienen cuotas asociadas a tu cuenta en cada uno de ellos Región de AWS. Para obtener más información, consulte [Cuotas de recursos de App Runner](architecture.md#architecture.quotas).
Existen pequeñas diferencias en el procedimiento de creación de un servicio según el tipo de fuente y el proveedor. En este tema se describen diferentes procedimientos para crear estos tipos de fuentes, de modo que pueda seguir el que mejor se adapte a su situación. Para iniciar un procedimiento básico con un ejemplo de código, consulte[Cómo empezar a usar App Runner](getting-started.md).
## Requisitos previos
Antes de crear el servicio App Runner, asegúrate de completar las siguientes acciones:
+ Complete los pasos de configuración que se indican en[Configuración de App Runner](setting-up.md).
+ Asegúrese de que la fuente de la aplicación esté lista. Puedes usar un repositorio de código en [GitHub](https://github.com/)[Bitbucket](https://bitbucket.org/) o una imagen de contenedor en [Amazon Elastic Container Registry (Amazon ECR)](https://docs.aws.amazon.com/AmazonECR/latest/userguide/) para crear un servicio de App Runner.
## Crear un servicio
En esta sección, se explica el proceso de creación de los dos tipos de servicios de App Runner: los basados en el código fuente y los basados en una imagen de contenedor.
**nota**
Si crea un conector de VPC de tráfico saliente para un servicio, el proceso de inicio del servicio que sigue experimentará una latencia única. Puedes establecer esta configuración para un servicio nuevo al crearlo o, posteriormente, con una actualización del servicio. Para obtener más información, consulte [Latencia única](network-vpc.md#network-vpc.VPC-connector.latency) el capítulo *Redes con App Runner* de esta guía.
### Cree un servicio a partir de un repositorio de código
En las siguientes secciones, se muestra cómo crear un servicio de App Runner cuando tu fuente es un repositorio de código en [GitHub](https://github.com/)[Bitbucket](https://bitbucket.org/). Cuando utilizas un repositorio de código, App Runner debe conectarse a la organización o cuenta del proveedor. Por lo tanto, necesitas ayudar a establecer esta conexión. Para obtener más información sobre las conexiones de App Runner, consulte[Administrar las conexiones de App Runner](manage-connections.md).
Al crear el servicio, App Runner crea una imagen de Docker que contiene el código y las dependencias de la aplicación. A continuación, lanza un servicio que ejecuta una instancia contenedora de esta imagen.
#### Crear un servicio a partir del código mediante la consola de App Runner
**Para crear un servicio de App Runner mediante la consola**
1. Configure el código fuente.
1. Abre la [consola de App Runner](https://console.aws.amazon.com/apprunner) y, en la lista de **regiones**, selecciona la tuya Región de AWS.
1. Si aún Cuenta de AWS no tiene ningún servicio de App Runner, aparecerá la página de inicio de la consola. Selecciona **Crear un servicio de App Runner**.
![\[Página de inicio de la consola de App Runner que muestra el botón de creación de servicio\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/getting-started-home.png)
Si Cuenta de AWS tiene servicios existentes, se muestra la página de **servicios** con una lista de sus servicios. Elija **Crear servicio**.
![\[Página de servicios de la consola de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/getting-started-services.png)
1. En la página **Origen e implementación**, en la sección **Fuente**, para **Tipo de repositorio**, elija **Repositorio de código fuente**.
1. Seleccione un **tipo de proveedor**. Elige entre Bitbucket **GitHub**o **Bitbucket.**
1. A continuación, selecciona una cuenta u organización para el proveedor que hayas utilizado anteriormente o selecciona **Añadir nueva**. A continuación, realice el proceso de proporcionar las credenciales del repositorio de código y elegir una cuenta u organización a la que conectarse.
1. En **Repositorio**, selecciona el repositorio que contiene el código de tu aplicación.
1. En **Branch**, selecciona la rama que deseas implementar.
1. En el **directorio de origen**, introduzca el directorio del repositorio de origen que almacena el código de la aplicación y los archivos de configuración.
**nota**
Los comandos build e start se ejecutan desde el directorio de origen que especifique. App Runner trata la ruta como absoluta desde la raíz. Si no especificas ningún valor aquí, el directorio toma como valor predeterminado la raíz del repositorio.
1. Configure sus despliegues.
1. En la sección **Configuración de despliegue**, elija **Manual** o **Automático**.
Para obtener más información sobre los métodos de despliegue, consulte[Métodos de implementación](manage-deploy.md#manage-deploy.methods).
1. Elija **Siguiente**.
![\[Configuración de origen e implementación al crear un servicio de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/getting-started-create-source-depl.png)
1. Configure la compilación de la aplicación.
1. En la página **Configurar la compilación**, en **Archivo de configuración**, selecciona **Configurar todos los ajustes aquí** si tu repositorio no contiene un archivo de configuración de App Runner o **Usar un archivo de configuración** si lo tiene.
**nota**
Un archivo de configuración de App Runner es una forma de mantener la configuración de compilación como parte del código fuente de la aplicación. Cuando proporcionas uno, App Runner lee algunos valores del archivo y no te permite configurarlos en la consola.
1. Proporcione la siguiente configuración de compilación:
+ **Tiempo de ejecución**: elija un tiempo de ejecución gestionado específico para su aplicación.
+ **Comando de compilación**: introduzca un comando que cree la aplicación a partir de su código fuente. Puede ser una herramienta específica del idioma o un script incluido con el código.
+ **Comando de inicio**: introduzca el comando que inicia el servicio web.
+ **Puerto**: introduzca el puerto IP que escucha su servicio web.
1. Elija **Siguiente**.
![\[Cree la configuración al crear un servicio de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/getting-started-create-build.png)
1. Configure su servicio.
1. En la página **Configurar el servicio**, en la sección **Configuración del servicio**, introduzca un nombre de servicio.
**nota**
Todos los demás ajustes del servicio son opcionales o tienen los valores predeterminados proporcionados por la consola.
1. Si lo desea, cambie o añada otros ajustes para cumplir con los requisitos de su aplicación.
1. Elija **Siguiente**.
![\[Configuración del servicio al crear un servicio de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/manage-create-github-service.png)
1. En la página **Revisar y crear**, compruebe todos los detalles que ha introducido y, a continuación, seleccione **Crear e implementar**.
**Resultado:** si el servicio se ha creado correctamente, la consola muestra el panel de **servicio con una descripción general** del nuevo servicio.
![\[Página del panel de servicios de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/getting-started-create-dashboard.png)
1. Comprueba que el servicio esté en ejecución.
1. En la página del panel de control del servicio, espere hasta que el **estado** del servicio sea En **ejecución**.
1. Elija el valor **de dominio predeterminado**. Es la URL del sitio web de tu servicio.
1. Usa tu sitio web y comprueba que funciona correctamente.
#### Crear un servicio a partir del código mediante la API de App Runner o AWS CLI
Para crear un servicio mediante la API de App Runner AWS CLI, llame a la acción de la `CreateService` API. Para obtener más información y un ejemplo, consulte [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html). Si es la primera vez que creas un servicio con una organización o cuenta específica para un repositorio de código fuente (GitHub o Bitbucket), comienza por llamar [CreateConnection](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateConnection.html). Esto establece una conexión entre App Runner y la organización o cuenta del proveedor del repositorio. Para obtener más información sobre las conexiones de App Runner, consulte[Administrar las conexiones de App Runner](manage-connections.md).
Si la llamada devuelve una respuesta correcta y muestra un objeto de [servicio](https://docs.aws.amazon.com/apprunner/latest/api/API_Service.html)`"Status": "CREATING"`, el servicio comienza a crearse.
Para ver un ejemplo de llamada, consulta Cómo [crear un servicio de repositorio de código fuente](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html#API_CreateService_Example_1) en la *referencia de la AWS App Runner API*
### Crear un servicio a partir de una imagen de Amazon ECR
En las siguientes secciones, se muestra cómo crear un servicio de App Runner cuando la fuente es una imagen de contenedor almacenada en [Amazon ECR.](https://docs.aws.amazon.com/AmazonECR/latest/userguide/) Amazon ECR es un Servicio de AWS. Por lo tanto, para crear un servicio basado en una imagen de Amazon ECR, debes proporcionar a App Runner un rol de acceso que contenga los permisos de acción de Amazon ECR necesarios.
**nota**
Las imágenes almacenadas en Amazon ECR Public están disponibles públicamente. Por lo tanto, si su imagen está almacenada en Amazon ECR Public, no se requiere un rol de acceso.
Cuando se crea el servicio, App Runner lanza un servicio que ejecuta una instancia contenedora de la imagen que usted proporciona. En este caso, no hay ninguna fase de creación.
Para obtener más información, consulte [Servicio App Runner basado en una imagen de origen](service-source-image.md).
#### Crear un servicio a partir de una imagen mediante la consola de App Runner
**Para crear un servicio de App Runner mediante la consola**
1. Configure el código fuente.
1. Abre la [consola de App Runner](https://console.aws.amazon.com/apprunner) y, en la lista de **regiones**, selecciona la tuya Región de AWS.
1. Si aún Cuenta de AWS no tiene ningún servicio de App Runner, aparecerá la página de inicio de la consola. Selecciona **Crear un servicio de App Runner**.
![\[Página de inicio de la consola de App Runner que muestra el botón de creación de servicio\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/getting-started-home.png)
Si Cuenta de AWS tiene servicios existentes, se muestra la página de **servicios** con una lista de sus servicios. Elija **Crear servicio**.
![\[Página de servicios de la consola de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/getting-started-services.png)
1. En la página **Origen e implementación**, en la sección **Origen**, para **Tipo de repositorio**, elija **Registro de contenedores**.
1. En **Proveedor**, elija el proveedor en el que se almacena la imagen:
+ **Amazon ECR**: imagen privada que se almacena en Amazon ECR.
+ **Amazon ECR Public**: imagen legible públicamente que se almacena en Amazon ECR Public.
1. **Para el **URI de la imagen del contenedor**, seleccione Browse.**
1. En el cuadro de diálogo **Select Amazon ECR container image**, en **Repositorio de imágenes**, seleccione el repositorio que contiene la imagen.
1. En **Etiqueta de imagen**, seleccione la etiqueta de imagen específica que desee implementar (por ejemplo, la **más reciente**) y, a continuación, elija **Continuar**.
![\[Selección de una imagen de Amazon ECR al crear un servicio de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/manage-create-ecr-select-image.png)
1. Configure sus despliegues.
1. En la sección **Configuración de despliegue**, elija **Manual** o **Automático**.
**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.
Para obtener más información sobre los métodos de implementación, consulte. [Métodos de implementación](manage-deploy.md#manage-deploy.methods)
1. [Proveedor de **Amazon ECR**] Para el **rol de acceso a ECR**, elija un rol de servicio existente en su cuenta o cree uno nuevo. Si utiliza el despliegue manual, también puede optar por utilizar el rol de usuario de IAM en el momento del despliegue.
1. Elija **Siguiente**.
![\[Configuración de origen e implementación al crear un servicio de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/manage-create-ecr-source-depl.png)
1. Configure su servicio.
1. En la página **Configurar el servicio**, en la sección **Configuración del servicio**, introduzca el nombre del servicio y el puerto IP que escucha el sitio web del servicio.
**nota**
Todos los demás ajustes del servicio son opcionales o tienen valores predeterminados proporcionados por la consola.
1. (Opcional) Cambie o añada otras configuraciones para adaptarlas a las necesidades de la aplicación.
1. Elija **Siguiente**.
![\[Configuración del servicio al crear un servicio de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/manage-create-ecr-service.png)
1. En la página **Revisar y crear**, compruebe todos los detalles que ha introducido y, a continuación, seleccione **Crear e implementar**.
**Resultado:** si el servicio se ha creado correctamente, la consola muestra el panel de control del **servicio, con una descripción general** del nuevo servicio.
![\[Página del panel de servicios de App Runner\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/manage-create-ecr-dashboard.png)
1. Comprueba que el servicio esté en ejecución.
1. En la página del panel de control del servicio, espere hasta que el **estado** del servicio sea En **ejecución**.
1. Elija el valor **de dominio predeterminado**. Es la URL del sitio web de tu servicio.
1. Usa tu sitio web y comprueba que funciona correctamente.
#### Crear un servicio a partir de una imagen mediante la API de App Runner o AWS CLI
Para crear un servicio mediante la API de App Runner o AWS CLI, llama a la acción de la [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)API.
La creación del servicio comienza si la llamada devuelve una respuesta correcta y muestra un objeto de [servicio](https://docs.aws.amazon.com/apprunner/latest/api/API_Service.html)`"Status": "CREATING"`.
Para ver un ejemplo de llamada, consulta Cómo [crear un servicio de repositorio de imágenes de origen](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html#API_CreateService_Example_2) en la *referencia de la AWS App Runner API*