Configuration d'un service App Runner

Lorsque vous créez un AWS App Runner service, 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 d'App RunnerAPI, de la console App Runner et d'un fichier de configuration App Runner.

Rubriques

• Configurez votre service à l'aide de l'App Runner API ou AWS CLI
• Configurez votre service à l'aide de la console App Runner
• Configurez votre service à l'aide d'un fichier de configuration App Runner
• Configuration de l'observabilité pour votre service
• Configuration des paramètres de service à l'aide de ressources partageables
• Configuration des bilans de santé pour votre service

Configurez votre service à l'aide de l'App Runner API ou AWS CLI

APIdé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 limitations pertinents.

• UpdateServiceaction — 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 SourceConfigurationInstanceConfiguration, et. Cependant, dansSourceConfiguration, 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'autreImageRepository.

    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'CreateServiceaction. Ils ne peuvent pas être modifiés une fois qu'ils ont été créés. L'UpdateServiceaction n'inclut pas ces paramètres.

  • APIvs. fichier — Vous pouvez définir le ConfigurationSource paramètre du CodeConfigurationtype (utilisé pour les référentiels de code source dans le cadre deSourceConfiguration) surRepository. Dans ce cas, App Runner ignore les paramètres de configuration et lit ces paramètres à partir d'un fichier de configuration de votre référentiel. CodeConfigurationValues Si vous définissez cette ConfigurationSource optionAPI, App Runner obtient tous les paramètres de configuration de l'APIappel et ignore le fichier de configuration, même s'il en existe un.

• TagResourceaction — 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.

• UntagResourceaction — Peut être appelée après la création de votre service pour supprimer des balises du service.

Note

Si vous créez un VPC connecteur de 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 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 App Runner API pour appliquer les mises à jour de configuration. Les règles de mise à jour API imposées, 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, 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, puis dans la liste des régions, sélectionnez votre Région AWS.

2. 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.

   

3. 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.

4. Pour mettre à jour les paramètres de n'importe quelle catégorie, choisissez Modifier.

5. Sur la page de modification de la configuration, apportez les modifications souhaitées, puis choisissez Enregistrer les modifications.

Note

Si vous créez un VPC connecteur de 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 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 duAPI. Pour de plus amples informations, veuillez consulter Configuration des options du service App Runner à l'aide d'un fichier de configuration.

Note

Si vous créez un VPC connecteur de 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 chapitre de ce guide consacré à la mise en réseau avec App Runner.