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. # Configuración de un servicio de App Runner Al [crear un AWS App Runner servicio](manage-create.md), se establecen varios valores de configuración. Puede cambiar algunos de estos valores de configuración después de crear el servicio. Otros ajustes solo se pueden aplicar al crear el servicio y no se pueden cambiar posteriormente. En este tema se describe la configuración del servicio mediante la API de App Runner, la consola de App Runner y un archivo de configuración de App Runner. **Topics** + [Configure su servicio mediante la API de App Runner o AWS CLI](#manage-configure.api) + [Configure su servicio mediante la consola de App Runner](#manage-configure.console) + [Configure su servicio mediante un archivo de configuración de App Runner](#manage-configure.file) + [Configuración de la observabilidad para su servicio](manage-configure-observability.md) + [Configurar los ajustes del servicio mediante recursos que se pueden compartir](manage-configure-resources.md) + [Configurar las comprobaciones de estado de tu servicio](manage-configure-healthcheck.md) ## Configure su servicio mediante la API de App Runner o AWS CLI La API define qué ajustes se pueden cambiar después de la creación del servicio. En la siguiente lista se describen las acciones, los tipos y las limitaciones relevantes. + [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)acción: se puede ejecutar después de la creación para actualizar algunos valores de configuración. + *Se puede actualizar*: puede actualizar la configuración de los `HealthCheckConfiguration` parámetros `SourceConfiguration``InstanceConfiguration`, y. Sin embargo`SourceConfiguration`, en, no puedes cambiar el tipo de fuente de código a imagen o viceversa. Debes proporcionar el mismo parámetro de repositorio que proporcionaste cuando creaste el servicio. Es una u otra. `CodeRepository` `ImageRepository` También puede actualizar los siguientes recursos ARNs de configuración independientes asociados al servicio: + `AutoScalingConfigurationArn` + `VpcConnectorArn` + *No se puede actualizar*: no se pueden cambiar `ServiceName` los `EncryptionConfiguration` parámetros que están disponibles en la [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)acción. No se pueden cambiar una vez creados. La [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)acción no incluye estos parámetros. + *API o archivo*: puedes establecer el `ConfigurationSource` parámetro del [CodeConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfiguration.html)tipo (que se utiliza para los repositorios de código fuente como parte de él`SourceConfiguration`) en. `Repository` En este caso, App Runner ignora las opciones de `CodeConfigurationValues` configuración y las lee de un [archivo de configuración](config-file.md) del repositorio. Si lo `ConfigurationSource` estableces`API`, App Runner obtiene todos los ajustes de configuración de la llamada a la API e ignora el archivo de configuración, incluso si existe alguno. + [TagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_TagResource.html)acción: se puede llamar después de crear el servicio para añadir etiquetas al servicio o actualizar los valores de las etiquetas existentes. + [UntagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_UntagResource.html)acción: se puede llamar después de crear el servicio para eliminar las etiquetas del servicio. **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. ## Configure su servicio mediante la consola de App Runner La consola usa la API de App Runner para aplicar las actualizaciones de configuración. Las reglas de actualización que impone la API, tal como se definieron en la sección anterior, determinan lo que se puede configurar con la consola. Algunos ajustes que estaban disponibles durante la creación del servicio no están disponibles para modificarlos más adelante. Además, si decides usar un [archivo de configuración](config-file.md), los ajustes adicionales se ocultarán en la consola y App Runner los leerá del archivo. **Para configurar el servicio** 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. 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**. ![\[Página del panel de control del servicio de App Runner que muestra la lista de actividades\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/console-dashboard.png) 1. En la página del panel de servicios, seleccione la pestaña **Configuración**. Resultado: la consola muestra los ajustes de configuración actuales del servicio en varias secciones: **Origen e implementación**, **Configuración de compilación** y **Configuración del servicio**. 1. Para actualizar los ajustes de cualquier categoría, seleccione **Editar**. 1. En la página de edición de la configuración, realice los cambios que desee y, a continuación, seleccione **Guardar cambios**. **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. ## Configure su servicio mediante un archivo de configuración de App Runner Al crear o actualizar un servicio de App Runner, puede indicarle a App Runner que lea algunos ajustes de configuración de un archivo de configuración que proporcione como parte de su repositorio de origen. De este modo, puede administrar los ajustes relacionados con su código fuente bajo el control de código fuente, junto con el propio código. El archivo de configuración también proporciona algunos ajustes avanzados que no se pueden configurar mediante la consola o la API. Para obtener más información, consulte [Configuración de las opciones de servicio de App Runner mediante un archivo de configuración](config-file.md). **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. # Configuración de la observabilidad para su servicio AWS App Runner se integra con varios AWS servicios para proporcionarte un amplio conjunto de herramientas de observabilidad para tu servicio App Runner. Para obtener más información, consulte [Observabilidad de tu servicio App Runner](monitor.md). App Runner permite habilitar algunas funciones de observabilidad y configurar su comportamiento mediante un recurso compartible llamado. *ObservabilityConfiguration* Puedes proporcionar un recurso de configuración de observabilidad al crear o actualizar un servicio. La consola de App Runner crea uno para ti cuando creas un nuevo servicio de App Runner. Proporcionar una configuración de observabilidad es opcional. Si no la proporcionas, App Runner proporciona una configuración de observabilidad predeterminada. Puedes compartir una única configuración de observabilidad en varios servicios de App Runner para asegurarte de que tengan el mismo comportamiento de observabilidad. Para obtener más información, consulte [Configurar los ajustes del servicio mediante recursos que se pueden compartir](manage-configure-resources.md). Puedes configurar las siguientes funciones de observabilidad mediante configuraciones de observabilidad: + *Configuración de rastreo*: ajustes para rastrear las solicitudes que atiende su aplicación y las llamadas posteriores que realiza. Para obtener más información sobre el seguimiento, consulte [Rastreo de su aplicación App Runner con X-Ray](monitor-xray.md). ## Gestione la observabilidad Administra la observabilidad de tus servicios de App Runner mediante uno de los siguientes métodos: ------ #### [ App Runner console ] Al [crear un servicio](manage-create.md) mediante la consola de App Runner o al [actualizar su configuración más adelante](manage-configure.md), puede configurar las funciones de observabilidad de su servicio. Busca la sección de configuración de **observabilidad** en la página de la consola. ![\[Página de configuración de la consola de App Runner que muestra las opciones de observabilidad\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/manage-configure-observability.png) ------ #### [ App Runner API or AWS CLI ] Cuando llamas a las acciones de la API [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)o a la API de [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)App Runner, puedes usar el objeto de `ObservabilityConfiguration` parámetro para habilitar las funciones de observabilidad y especificar un recurso de configuración de observabilidad para tu servicio. Usa las siguientes acciones de la API de App Runner para administrar tus recursos de configuración de observabilidad. + [CreateObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateObservabilityConfiguration.html)— Crea una nueva configuración de observabilidad o una revisión de una existente. + [ListObservabilityConfigurations](https://docs.aws.amazon.com/apprunner/latest/api/API_ListObservabilityConfigurations.html)— Devuelve una lista de las configuraciones de observabilidad asociadas a la suya Cuenta de AWS, con información resumida. + [DescribeObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DescribeObservabilityConfiguration.html)— Devuelve una descripción completa de una configuración de observabilidad. + [DeleteObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DeleteObservabilityConfiguration.html)— Elimina una configuración de observabilidad. Puede eliminar una revisión específica o la última revisión activa. Es posible que tengas que eliminar las configuraciones de observabilidad innecesarias si alcanzas la cuota de configuración de observabilidad correspondiente a tu. Cuenta de AWS ------ # Configurar los ajustes del servicio mediante recursos que se pueden compartir En el caso de algunas funciones, tiene sentido compartir la configuración entre AWS App Runner los servicios. Por ejemplo, es posible que desee que un conjunto de servicios tenga el mismo comportamiento de escalado automático. O puede que desee una configuración de observabilidad idéntica para todos sus servicios. App Runner te permite compartir la configuración mediante el uso de recursos compartibles independientes. Se crea un recurso que define un conjunto de ajustes de configuración para una función y, a continuación, se proporciona el nombre de recurso de Amazon (ARN) de este recurso de configuración a uno o más servicios de App Runner. App Runner implementa recursos de configuración que se pueden compartir para las siguientes funciones: + [Escalado automático](manage-autoscaling.md) + [Observabilidad](manage-configure-observability.md) + [Acceso mediante VPC](network-vpc.md) La página del documento de cada una de estas funciones proporciona información sobre la configuración disponible y los procedimientos de administración. Las funciones que utilizan recursos de configuración independientes comparten algunas características y consideraciones de diseño. + **Revisiones**: algunos recursos de configuración pueden tener revisiones. El escalado automático y la observabilidad son ejemplos de dos recursos de configuración que utilizan revisiones. En estos casos, cada configuración tiene un *nombre* y una *revisión* numérica. Varias revisiones de una configuración tienen el mismo nombre y números de revisión diferentes. Puede usar diferentes nombres de configuración para diferentes escenarios. Para cada nombre, puede añadir varias revisiones para ajustar la configuración de un escenario específico. La primera configuración que cree con un nombre recibe el número de revisión 1. Las configuraciones posteriores con el mismo nombre obtienen números de revisión consecutivos (empezando por 2). Puedes asociar tu servicio App Runner a una revisión de configuración específica o a la última revisión de la configuración. + **Compartido**: puedes compartir un único recurso de configuración entre varios servicios de App Runner. Esto resulta útil si desea mantener configuraciones idénticas en todos estos servicios. En concreto, si sus recursos admiten revisiones, puede configurar varios servicios para usar la última revisión de una configuración. Para ello, especifique solo el nombre de la configuración, pero no una revisión. Todos los servicios que haya configurado de esta manera reciben actualizaciones de configuración al actualizar el servicio. Para obtener más información sobre los cambios de configuración, consulte[Configuración de un servicio de App Runner](manage-configure.md). + **Administración de recursos**: puede usar App Runner para crear y eliminar configuraciones. No puedes actualizar una configuración directamente. En su lugar, en el caso de los recursos que admiten revisiones, puede crear una nueva revisión del nombre de una configuración existente para actualizar la configuración de manera efectiva. **nota** Para el escalado automático, puedes crear configuraciones y *múltiples* revisiones tanto con la consola de App Runner como con la API de App Runner. Tanto la consola de App Runner como la API de App Runner también pueden eliminar configuraciones y revisiones. Para obtener más información, consulte [Administrar el escalado automático de App Runner](manage-autoscaling.md). Para otros tipos de configuración, como las configuraciones de observabilidad, solo puedes crear una configuración con una *única* revisión con la consola de App Runner. Para crear más revisiones y eliminar configuraciones, debes usar la API de App Runner. + **Cuota de recursos**: hay cuotas establecidas para la cantidad de nombres y revisiones de configuración únicos que puede tener para sus recursos de configuración en cada uno Región de AWS. Si alcanza estas cuotas, debe eliminar el nombre de una configuración o al menos algunas de sus revisiones antes de poder crear más. Para las revisiones de las configuraciones de escalado automático, puedes usar la consola de App Runner o la API de App Runner para eliminarlas. Para obtener más información, consulte [Administrar el escalado automático de App Runner](manage-autoscaling.md). Debe usar la API de App Runner para eliminar otros recursos. Para obtener más información sobre las cuotas, consulte [Cuotas de recursos de App Runner](architecture.md#architecture.quotas). + **Sin coste de recursos**: no se incurre en costes adicionales por crear un recurso de configuración. Es posible que incurra en costos por la función en sí (por ejemplo, se le cobra el AWS X-Ray costo normal al activar el rastreo de rayos X), pero no por el recurso de configuración de App Runner que configura la función para su servicio de App Runner. # Configurar las comprobaciones de estado de tu servicio AWS App Runner supervisa el estado de su servicio mediante la realización de comprobaciones de estado. El protocolo de comprobación de estado predeterminado es TCP. App Runner hace ping al dominio asignado a tu servicio. También puedes configurar el protocolo de verificación de estado en HTTP. App Runner envía las solicitudes HTTP de verificación de estado a tu aplicación web. Puede configurar algunos ajustes relacionados con las comprobaciones de estado. En la siguiente tabla se describen los ajustes de las comprobaciones de estado y sus valores predeterminados. | **Opción** | **Descripción** | **Predeterminado** | | --- | --- | --- | | Protocolo | El protocolo IP que App Runner utiliza para realizar las comprobaciones de estado de su servicio. Si configuras el protocolo en`TCP`, App Runner hace ping al dominio predeterminado asignado a tu servicio en el puerto que escucha tu aplicación. Si configuras el protocolo en`HTTP`, App Runner envía las solicitudes de comprobación de estado a la ruta configurada. | `TCP` | | Ruta | La URL a la que App Runner envía las solicitudes de comprobación de estado HTTP. Aplicable solo a las comprobaciones HTTP. | `/` | | Interval | El intervalo de tiempo, en segundos, que transcurre entre las comprobaciones de estado. | `5` | | Timeout (Tiempo de espera) | El tiempo, en segundos, para esperar una respuesta de comprobación de estado antes de decidir que ha fallado. | `2` | | Umbral saludable | El número de comprobaciones consecutivas que deben tener éxito antes de que App Runner decida que el servicio es saludable. | `1` | | Umbral poco saludable | El número de comprobaciones consecutivas que deben fallar antes de que App Runner decida que el servicio no es saludable. | `5` | ## Configurar comprobaciones de estado Configura las comprobaciones de estado de tu servicio de App Runner mediante uno de los siguientes métodos: ------ #### [ App Runner console ] Al crear el servicio de App Runner mediante la consola de App Runner o al actualizar su configuración más adelante, puede configurar los ajustes de comprobación de estado. Para ver todos los procedimientos de la consola, consulte [Creación de un servicio App Runner](manage-create.md) y[Configuración de un servicio de App Runner](manage-configure.md). En ambos casos, busque la sección de configuración de **Health Check** en la página de la consola. ![\[Página de configuración de la consola de App Runner que muestra las opciones de comprobación de estado\]](http://docs.aws.amazon.com/es_es/apprunner/latest/dg/images/console-health-check.png) ------ #### [ App Runner API or AWS CLI ] Cuando llamas a las acciones [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)o a las de la [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)API, puedes usar el `HealthCheckConfiguration` parámetro para especificar la configuración de las comprobaciones de estado. Para obtener información sobre la estructura del parámetro, consulta [HealthCheckConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_HealthCheckConfiguration.html)la *referencia de la AWS App Runner API*. ------