AWS App Runner ne sera plus ouvert aux nouveaux clients à compter du 30 avril 2026. Si vous souhaitez utiliser App Runner, inscrivez-vous avant cette date. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez [AWS App Runner la section Modification de la disponibilité](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Configuration d'un service App Runner
Lorsque vous [créez un AWS App Runner service](manage-create.md), vous définissez différentes valeurs de configuration. Vous pouvez modifier certains de ces paramètres de configuration après avoir créé le service. Les autres paramètres ne peuvent être appliqués que lors de la création du service et ne peuvent pas être modifiés par la suite. Cette rubrique décrit la configuration de votre service à l'aide de l'API App Runner, de la console App Runner et d'un fichier de configuration App Runner.
**Topics**
+ [Configurez votre service à l'aide de l'API App Runner ou AWS CLI](#manage-configure.api)
+ [Configurez votre service à l'aide de la console App Runner](#manage-configure.console)
+ [Configurez votre service à l'aide d'un fichier de configuration App Runner](#manage-configure.file)
+ [Configuration de l'observabilité pour votre service](manage-configure-observability.md)
+ [Configuration des paramètres de service à l'aide de ressources partageables](manage-configure-resources.md)
+ [Configuration des bilans de santé pour votre service](manage-configure-healthcheck.md)
## Configurez votre service à l'aide de l'API App Runner ou AWS CLI
L'API définit les paramètres qui peuvent être modifiés après la création du service. La liste suivante décrit les actions, les types et les limites pertinents.
+ [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)action — Peut être appelée après la création pour mettre à jour certains paramètres de configuration.
+ *Peut être mis à jour* — Vous pouvez mettre à jour les paramètres dans les `HealthCheckConfiguration` paramètres `SourceConfiguration``InstanceConfiguration`, et. Cependant, dans`SourceConfiguration`, vous ne pouvez pas changer le type de source du code à l'image ou inversement. Vous devez fournir le même paramètre de référentiel que celui que vous avez indiqué lors de la création du service. C'est l'un `CodeRepository` ou l'autre`ImageRepository`.
Vous pouvez également mettre à jour les ressources ARNs de configuration distinctes suivantes associées au service :
+ `AutoScalingConfigurationArn`
+ `VpcConnectorArn`
+ *Impossible de mettre à jour* : vous ne pouvez pas modifier les `EncryptionConfiguration` paramètres `ServiceName` et disponibles dans l'[CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)action. Ils ne peuvent pas être modifiés une fois qu'ils ont été créés. L'[UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)action n'inclut pas ces paramètres.
+ *API ou fichier* : vous pouvez définir le `ConfigurationSource` paramètre du [CodeConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfiguration.html)type (utilisé pour les référentiels de code source dans le cadre de`SourceConfiguration`) sur`Repository`. Dans ce cas, App Runner ignore les paramètres de configuration et lit ces paramètres à partir d'un [fichier de configuration](config-file.md) de votre référentiel. `CodeConfigurationValues` Si vous définissez cette `ConfigurationSource` option`API`, App Runner obtient tous les paramètres de configuration depuis l'appel d'API et ignore le fichier de configuration, même s'il en existe un.
+ [TagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_TagResource.html)action — Peut être appelée après la création de votre service pour ajouter des balises au service ou mettre à jour les valeurs des balises existantes.
+ [UntagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_UntagResource.html)action — Peut être appelée après la création de votre service pour supprimer des balises du service.
**Note**
Si vous créez un connecteur VPC pour le trafic sortant pour un service, le processus de démarrage du service qui suit connaîtra une latence unique. Vous pouvez définir cette configuration pour un nouveau service lorsque vous le créez, ou ultérieurement, avec une mise à jour du service. Pour plus d'informations, consultez le [Latence unique](network-vpc.md#network-vpc.VPC-connector.latency) chapitre de ce guide consacré à la mise en *réseau avec App Runner*.
## Configurez votre service à l'aide de la console App Runner
La console utilise l'API App Runner pour appliquer les mises à jour de configuration. Les règles de mise à jour imposées par l'API, telles que définies dans la section précédente, déterminent ce que vous pouvez configurer à l'aide de la console. Certains paramètres qui étaient disponibles lors de la création du service ne peuvent pas être modifiés ultérieurement. En outre, si vous décidez d'utiliser un [fichier de configuration](config-file.md), les paramètres supplémentaires sont masqués dans la console et App Runner les lit à partir du fichier.
**Pour configurer votre service**
1. Ouvrez la [console App Runner](https://console.aws.amazon.com/apprunner), puis dans la liste des **régions**, sélectionnez votre Région AWS.
1. Dans le volet de navigation, choisissez **Services**, puis choisissez votre service App Runner.
La console affiche le tableau de bord des services avec une vue d'**ensemble des services**.
![\[Page du tableau de bord du service App Runner affichant la liste des activités\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/console-dashboard.png)
1. Sur la page du tableau de bord du service, choisissez l'onglet **Configuration**.
Résultat : La console affiche les paramètres de configuration actuels de votre service dans plusieurs sections : **Source et déploiement**, **Configuration du build** et **Configuration du service**.
1. Pour mettre à jour les paramètres de n'importe quelle catégorie, choisissez **Modifier**.
1. Sur la page de modification de la configuration, apportez les modifications souhaitées, puis choisissez **Enregistrer les modifications**.
**Note**
Si vous créez un connecteur VPC pour le trafic sortant pour un service, le processus de démarrage du service qui suit connaîtra une latence unique. Vous pouvez définir cette configuration pour un nouveau service lorsque vous le créez, ou ultérieurement, avec une mise à jour du service. Pour plus d'informations, consultez le [Latence unique](network-vpc.md#network-vpc.VPC-connector.latency) chapitre de ce guide consacré à la mise en *réseau avec App Runner*.
## Configurez votre service à l'aide d'un fichier de configuration App Runner
Lorsque vous créez ou mettez à jour un service App Runner, vous pouvez demander à App Runner de lire certains paramètres de configuration à partir d'un fichier de configuration que vous fournissez dans le cadre de votre référentiel source. Ce faisant, vous pouvez gérer les paramètres liés à votre code source sous contrôle de source, ainsi que le code lui-même. Le fichier de configuration fournit également certains paramètres avancés que vous ne pouvez pas définir à l'aide de la console ou de l'API. Pour de plus amples informations, veuillez consulter [Configuration des options du service App Runner à l'aide d'un fichier de configuration](config-file.md).
**Note**
Si vous créez un connecteur VPC pour le trafic sortant pour un service, le processus de démarrage du service qui suit connaîtra une latence unique. Vous pouvez définir cette configuration pour un nouveau service lorsque vous le créez, ou ultérieurement, avec une mise à jour du service. Pour plus d'informations, consultez le [Latence unique](network-vpc.md#network-vpc.VPC-connector.latency) chapitre de ce guide consacré à la mise en *réseau avec App Runner*.
# Configuration de l'observabilité pour votre service
AWS App Runner s'intègre à plusieurs AWS services afin de vous fournir une suite complète d'outils d'observabilité pour votre service App Runner. Pour de plus amples informations, veuillez consulter [Observabilité pour votre service App Runner](monitor.md).
App Runner permet d'activer certaines fonctionnalités d'observabilité et de configurer leur comportement à l'aide d'une ressource partageable appelée. *ObservabilityConfiguration* Vous pouvez fournir une ressource de configuration d'observabilité lorsque vous créez ou mettez à jour un service. La console App Runner en crée un pour vous lorsque vous créez un nouveau service App Runner. La fourniture d'une configuration d'observabilité est facultative. Si vous n'en fournissez pas, App Runner fournit une configuration d'observabilité par défaut.
Vous pouvez partager une configuration d'observabilité unique entre plusieurs services App Runner afin de vous assurer qu'ils ont le même comportement d'observabilité. Pour de plus amples informations, veuillez consulter [Configuration des paramètres de service à l'aide de ressources partageables](manage-configure-resources.md).
Vous pouvez configurer les fonctionnalités d'observabilité suivantes à l'aide des configurations d'observabilité :
+ *Configuration du suivi* : paramètres de suivi des demandes traitées par votre application et des appels en aval qu'elle effectue. Pour plus d’informations sur le suivi, consultez [Suivi de votre application App Runner avec X-Ray](monitor-xray.md).
## Gérez l'observabilité
Gérez l'observabilité de vos services App Runner à l'aide de l'une des méthodes suivantes :
------
#### [ App Runner console ]
Lorsque vous [créez un service](manage-create.md) à l'aide de la console App Runner ou que vous [mettez à jour sa configuration ultérieurement](manage-configure.md), vous pouvez configurer les fonctionnalités d'observabilité de votre service. Consultez la section de configuration de l'**observabilité** sur la page de la console.
![\[Page de configuration de la console App Runner affichant les options d'observabilité\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/manage-configure-observability.png)
------
#### [ App Runner API or AWS CLI ]
Lorsque vous appelez les actions [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)ou [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)l'API App Runner, vous pouvez utiliser l'objet `ObservabilityConfiguration` paramètre pour activer les fonctionnalités d'observabilité et spécifier une ressource de configuration d'observabilité pour votre service.
Utilisez les actions d'API App Runner suivantes pour gérer vos ressources de configuration d'observabilité.
+ [CreateObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateObservabilityConfiguration.html)— Crée une nouvelle configuration d'observabilité ou une révision d'une configuration existante.
+ [ListObservabilityConfigurations](https://docs.aws.amazon.com/apprunner/latest/api/API_ListObservabilityConfigurations.html)— Renvoie la liste des configurations d'observabilité qui vous sont associées Compte AWS, avec des informations récapitulatives.
+ [DescribeObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DescribeObservabilityConfiguration.html)— Renvoie une description complète d'une configuration d'observabilité.
+ [DeleteObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DeleteObservabilityConfiguration.html)— Supprime une configuration d'observabilité. Vous pouvez supprimer une révision spécifique ou la dernière révision active. Vous devrez peut-être supprimer des configurations d'observabilité inutiles si vous atteignez le quota de configuration d'observabilité pour votre. Compte AWS
------
# Configuration des paramètres de service à l'aide de ressources partageables
Pour certaines fonctionnalités, il est judicieux de partager la configuration entre les AWS App Runner services. Par exemple, vous souhaiterez peut-être qu'un ensemble de services présente le même comportement de mise à l'échelle automatique. Vous pouvez également avoir besoin de paramètres d'observabilité identiques pour tous vos services. App Runner vous permet de partager des paramètres en utilisant des ressources partageables distinctes. Vous créez une ressource qui définit un ensemble de paramètres de configuration pour une fonctionnalité, puis vous fournissez le nom de ressource Amazon (ARN) de cette ressource de configuration à un ou plusieurs services App Runner.
App Runner implémente des ressources de configuration partageables pour les fonctionnalités suivantes :
+ [Auto scaling](manage-autoscaling.md) (Mise à l'échelle automatique)
+ [Observabilité](manage-configure-observability.md)
+ [Accès VPC](network-vpc.md)
La page du document correspondant à chacune de ces fonctionnalités fournit des informations sur les paramètres disponibles et les procédures de gestion.
Les fonctionnalités utilisant des ressources de configuration distinctes partagent certaines caractéristiques et considérations de conception.
+ **Révisions** — Certaines ressources de configuration peuvent comporter des révisions. Le dimensionnement automatique et l'observabilité sont des exemples de deux ressources de configuration qui utilisent des révisions. Dans ces cas, chaque configuration possède un *nom* et une *révision* numérique. Plusieurs révisions d'une configuration ont le même nom et des numéros de révision différents. Vous pouvez utiliser différents noms de configuration pour différents scénarios. Pour chaque nom, vous pouvez ajouter plusieurs révisions afin d'affiner les paramètres d'un scénario spécifique.
La première configuration que vous créez avec un nom reçoit le numéro de révision 1. Les configurations suivantes portant le même nom reçoivent des numéros de révision consécutifs (en commençant par 2). Vous pouvez associer votre service App Runner à une révision de configuration spécifique ou à la dernière révision de configuration.
+ **Partagé** : vous pouvez partager une seule ressource de configuration entre plusieurs services App Runner. Cela est utile si vous souhaitez conserver des configurations identiques sur l'ensemble de ces services. En particulier, si vos ressources prennent en charge les révisions, vous pouvez configurer plusieurs services pour utiliser la dernière révision d'une configuration. Vous pouvez le faire en spécifiant uniquement le nom de la configuration, mais pas de révision. Tous les services que vous avez configurés de cette manière reçoivent des mises à jour de configuration lorsque vous mettez à jour le service. Pour plus d'informations sur les modifications de configuration, consultez[Configuration d'un service App Runner](manage-configure.md).
+ **Gestion des ressources** : vous pouvez utiliser App Runner pour créer et supprimer des configurations. Vous ne pouvez pas mettre à jour directement une configuration. En revanche, pour les ressources qui prennent en charge les révisions, vous pouvez créer une nouvelle révision d'un nom de configuration existant afin de mettre à jour efficacement la configuration.
**Note**
Pour le dimensionnement automatique, vous pouvez créer des configurations et de *multiples* révisions à l'aide de la console App Runner et de l'API App Runner. La console App Runner et l'API App Runner peuvent également supprimer des configurations et des révisions. Pour en savoir plus, consultez [Gestion du dimensionnement automatique d'App Runner](manage-autoscaling.md).
Pour les autres types de configuration, tels que les configurations d'observabilité, vous ne pouvez créer une configuration avec une *seule* révision qu'avec la console App Runner. Pour créer d'autres révisions et supprimer des configurations, vous devez utiliser l'API App Runner.
+ **Quota de ressources** : il existe des quotas définis pour le nombre de noms de configuration uniques et de révisions que vous pouvez avoir pour vos ressources de configuration dans chacun d'eux Région AWS. Si vous atteignez ces quotas, vous devez supprimer un nom de configuration ou au moins certaines de ses révisions avant de pouvoir en créer d'autres. Pour les révisions des configurations de dimensionnement automatique, vous pouvez utiliser la console App Runner ou l'API App Runner pour les supprimer. Pour en savoir plus, consultez [Gestion du dimensionnement automatique d'App Runner](manage-autoscaling.md). Vous devez utiliser l'API App Runner pour supprimer d'autres ressources. Pour plus d’informations sur les quotas, consultez [Quotas de ressources App Runner](architecture.md#architecture.quotas).
+ **Aucun coût de ressource** : la création d'une ressource de configuration n'entraîne aucun coût supplémentaire. La fonctionnalité elle-même peut vous être facturée (par exemple, le AWS X-Ray coût normal vous est facturé lorsque vous activez le suivi X-Ray), mais pas pour la ressource de configuration App Runner qui configure la fonctionnalité pour votre service App Runner.
# Configuration des bilans de santé pour votre service
AWS App Runner surveille l'état de votre service en effectuant des bilans de santé. Le protocole de contrôle de santé par défaut est TCP. App Runner envoie un ping au domaine attribué à votre service. Vous pouvez également définir le protocole de contrôle de santé sur HTTP. App Runner envoie des requêtes HTTP de vérification de l'état à votre application Web.
Vous pouvez configurer quelques paramètres relatifs aux bilans de santé. Le tableau suivant décrit les paramètres du bilan de santé et leurs valeurs par défaut.
| **Réglage** | **Description** | **Par défaut** |
| --- | --- | --- |
| Protocole | Le protocole IP utilisé par App Runner pour effectuer des surveillances de l'état pour votre service. Si vous définissez le protocole sur`TCP`, App Runner envoie un ping au domaine par défaut attribué à votre service sur le port que votre application écoute. Si vous définissez le protocole sur`HTTP`, App Runner envoie les demandes de contrôle de santé au chemin configuré. | `TCP` |
| Chemin | URL à laquelle App Runner envoie les demandes de contrôle de santé HTTP. Applicable uniquement aux vérifications HTTP. | `/` |
| Interval | L'intervalle, en secondes, entre les surveillances de l'état. | `5` |
| Timeout | Le temps d'attente, en secondes, d'une réponse de surveillance de l'état avant de décider qu'elle a échoué. | `2` |
| Seuil sain | Nombre de contrôles consécutifs qui doivent réussir avant qu'App Runner ne décide que le service est sain. | `1` |
| Seuil malsain | Le nombre de contrôles consécutifs qui doivent échouer avant qu'App Runner ne décide que le service n'est pas sain. | `5` |
## Configurer la surveillance de l'état
Configurez les contrôles de santé de votre service App Runner à l'aide de l'une des méthodes suivantes :
------
#### [ App Runner console ]
Lorsque vous créez votre service App Runner à l'aide de la console App Runner, ou lorsque vous mettez à jour sa configuration ultérieurement, vous pouvez configurer les paramètres de contrôle de santé. Pour les procédures complètes relatives à la console, reportez-vous [Création d'un service App Runner](manage-create.md) aux sections et[Configuration d'un service App Runner](manage-configure.md). Dans les deux cas, consultez la section de configuration du **Health check** sur la page de la console.
![\[Page de configuration de la console App Runner affichant les options de vérification de l'état\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/console-health-check.png)
------
#### [ App Runner API or AWS CLI ]
Lorsque vous appelez les actions de l'[UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)API [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)or, vous pouvez utiliser le `HealthCheckConfiguration` paramètre pour spécifier les paramètres de contrôle de santé.
Pour plus d'informations sur la structure du paramètre, reportez-vous [HealthCheckConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_HealthCheckConfiguration.html)à la *référence de l'AWS App Runner API*.
------