Création d'un service App Runner

AWS App Runner automatise la transition d'une image de conteneur ou d'un référentiel de code source vers un service Web en cours d'exécution qui évolue automatiquement. Vous pointez App Runner vers votre image ou votre code source, en ne spécifiant qu'un petit nombre de paramètres requis. App Runner crée votre application si nécessaire, fournit des ressources de calcul et déploie votre application pour qu'elle s'exécute sur celles-ci.

Lorsque vous créez un service, App Runner crée une ressource de service. Dans certains cas, il se peut que vous deviez fournir une ressource de connexion. Si vous utilisez la console App Runner, celle-ci crée implicitement la ressource de connexion. Pour plus d'informations sur les types de ressources App Runner, consultezRessources pour App Runner. Ces types de ressources ont des quotas associés à votre compte dans chacun d'entre eux Région AWS. Pour de plus amples informations, veuillez consulter Quotas de ressources App Runner.

Il existe de subtiles différences dans la procédure de création d'un service en fonction du type de source et du fournisseur. Cette rubrique décrit les différentes procédures de création de ces types de sources afin que vous puissiez suivre celle qui convient le mieux à votre situation. Pour démarrer une procédure de base à l'aide d'un exemple de code, consultezCommencer à utiliser App Runner.

Conditions préalables

Avant de créer votre service App Runner, veillez à effectuer les actions suivantes :

Effectuez les étapes de configuration décrites dansConfiguration pour App Runner.
Assurez-vous que la source de votre application est prête. Vous pouvez utiliser un référentiel de code dans GitHub Bitbucket ou une image de conteneur dans Amazon Elastic Container Registry (Amazon ECR) pour créer un service App Runner.

Créer un service

Cette section décrit le processus de création des deux types de services App Runner : sur la base du code source et sur la base d'une image de conteneur.

Note

Si vous créez un connecteur VPC de trafic sortant pour un service, le processus de démarrage du service qui suit subira une latence unique. Vous pouvez définir cette configuration pour un nouveau service lors de sa création, ou ultérieurement, à l'aide d'une mise à jour du service. Pour plus d'informations, consultez Latence unique le chapitre Réseau avec App Runner de ce guide.

Les sections suivantes montrent comment créer un service App Runner lorsque votre source est un référentiel de code dans GitHub Bitbucket. Lorsque vous utilisez un référentiel de code, App Runner doit se connecter à l'organisation ou au compte du fournisseur. Par conséquent, vous devez aider à établir cette connexion. Pour plus d'informations sur les connexions App Runner, consultezGestion des connexions App Runner.

Lorsque vous créez le service, App Runner crée une image Docker contenant le code de votre application et ses dépendances. Il lance ensuite un service qui exécute une instance de conteneur de cette image.

Création d'un service à partir de code à l'aide de la console App Runner

Pour créer un service App Runner à l'aide de la console

Configurez votre code source.
1. Ouvrez la console App Runner et, dans la liste des régions, sélectionnez votre Région AWS.
2. Si aucun service App Runner Compte AWS n'est encore disponible, la page d'accueil de la console s'affiche. Choisissez Créer un service App Runner.
  
  S'il Compte AWS dispose de services existants, la page Services contenant la liste de vos services s'affiche. Choisissez Créer un service.
3. Sur la page Source et déploiement, dans la section Source, pour Type de référentiel, choisissez Référentiel de code source.
4. Sélectionnez un type de fournisseur. Choisissez GitHub soit Bitbucket.
5. Sélectionnez ensuite un compte ou une organisation pour le fournisseur que vous avez déjà utilisé, ou choisissez Ajouter un nouveau. Ensuite, procédez à la fourniture des informations d'identification de votre référentiel de code et au choix du compte ou de l'organisation auxquels vous connecter.
6. Pour Repository, sélectionnez le référentiel qui contient le code de votre application.
7. Pour Branch, sélectionnez la branche que vous souhaitez déployer.
8. Pour Répertoire source, entrez le répertoire du référentiel source qui stocke le code de votre application et les fichiers de configuration.
  
  Note
  Les commandes build et start s'exécutent à partir du répertoire source que vous spécifiez. App Runner gère le chemin comme absolu à partir de la racine. Si vous ne spécifiez aucune valeur ici, le répertoire prend par défaut la racine du référentiel.
Configurez vos déploiements.
1. Dans la section Paramètres de déploiement, choisissez Manuel ou Automatique.
  
  Pour plus d'informations sur les méthodes de déploiement, consultezMéthodes de déploiement.
2. Choisissez Suivant.
Configurez la version de l'application.
1. Sur la page Configurer la compilation, pour Fichier de configuration, choisissez Configurer tous les paramètres ici si votre référentiel ne contient pas de fichier de configuration App Runner, ou Utiliser un fichier de configuration si c'est le cas.
  
  Note
  Un fichier de configuration App Runner est un moyen de conserver votre configuration de build dans le cadre de la source de votre application. Lorsque vous en fournissez une, App Runner lit certaines valeurs du fichier et ne vous permet pas de les définir dans la console.
2. Fournissez les paramètres de génération suivants :
  - Runtime : choisissez un environnement d'exécution géré spécifique pour votre application.
  - Commande de génération : entrez une commande qui génère votre application à partir de son code source. Il peut s'agir d'un outil spécifique à un langage ou d'un script fourni avec votre code.
  - Commande de démarrage — Entrez la commande qui démarre votre service Web.
  - Port : entrez le port IP écouté par votre service Web.
3. Choisissez Suivant.
Configurez votre service.
1. Sur la page Configurer le service, dans la section Paramètres du service, entrez un nom de service.
  
  Note
  Tous les autres paramètres de service sont facultatifs ou ont des valeurs par défaut fournies par la console.
2. Vous pouvez éventuellement modifier ou ajouter d'autres paramètres pour répondre aux exigences de votre application.
3. Choisissez Suivant.
Sur la page Réviser et créer, vérifiez tous les détails que vous avez saisis, puis choisissez Créer et déployer.

Résultat : Si le service est créé avec succès, la console affiche le tableau de bord du service avec un aperçu des services du nouveau service.
Vérifiez que votre service fonctionne.
1. Sur la page du tableau de bord du service, attendez que l'état du service soit en cours d'exécution.
2. Choisissez la valeur de domaine par défaut. Il s'agit de l'URL du site Web de votre service.
3. Utilisez votre site Web et vérifiez qu'il fonctionne correctement.

Création d'un service à partir de code à l'aide de l'API App Runner ou AWS CLI

Pour créer un service à l'aide de l'API App Runner AWS CLI, appelez l'action CreateService API. Pour plus d'informations et pour voir un exemple, consultez CreateService. Si c'est la première fois que vous créez un service en utilisant une organisation ou un compte spécifique pour un référentiel de code source (GitHub ou Bitbucket), commencez par appeler CreateConnection. Cela établit une connexion entre App Runner et l'organisation ou le compte du fournisseur du référentiel. Pour plus d'informations sur les connexions App Runner, consultezGestion des connexions App Runner.

Si l'appel renvoie une réponse réussie avec un objet Service affiché"Status": "CREATING", votre service commence à être créé.

Pour un exemple d'appel, voir Créer un service de référentiel de code source dans la référence de l'AWS App Runner API

Les sections suivantes montrent comment créer un service App Runner lorsque votre source est une image de conteneur stockée dans Amazon ECR. Amazon ECR est un Service AWS. Par conséquent, pour créer un service basé sur une image Amazon ECR, vous devez attribuer à App Runner un rôle d'accès contenant les autorisations d'action Amazon ECR nécessaires.

Note

Les images stockées dans Amazon ECR Public sont accessibles au public. Ainsi, si votre image est stockée dans Amazon ECR Public, aucun rôle d'accès n'est requis.

Lors de la création de votre service, App Runner lance un service qui exécute une instance de conteneur de l'image que vous fournissez. Il n'y a pas de phase de construction dans ce cas.

Pour de plus amples informations, veuillez consulter Service App Runner basé sur une image source.

Création d'un service à partir d'une image à l'aide de la console App Runner

Pour créer un service App Runner à l'aide de la console

Configurez votre code source.
1. Ouvrez la console App Runner et, dans la liste des régions, sélectionnez votre Région AWS.
2. Si aucun service App Runner Compte AWS n'est encore disponible, la page d'accueil de la console s'affiche. Choisissez Créer un service App Runner.
  
  S'il Compte AWS dispose de services existants, la page Services contenant la liste de vos services s'affiche. Choisissez Créer un service.
3. Sur la page Source et déploiement, dans la section Source, pour Type de référentiel, choisissez Container registry.
4. Pour Fournisseur, choisissez le fournisseur sur lequel votre image est stockée :
  - Amazon ECR : image privée stockée dans Amazon ECR.
  - Amazon ECR Public : image lisible par le public qui est stockée dans Amazon ECR Public.
5. Pour l'URI de l'image du conteneur, choisissez Parcourir.
6. Dans la boîte de dialogue Sélectionner une image de conteneur Amazon ECR, pour Référentiel d'images, sélectionnez le référentiel qui contient votre image.
7. Pour Balise d'image, sélectionnez la balise d'image spécifique que vous souhaitez déployer (par exemple, la plus récente), puis choisissez Continuer.
Configurez vos déploiements.
1. Dans la section Paramètres de déploiement, choisissez Manuel ou Automatique.
  
  Note
  App Runner ne prend pas en charge le déploiement automatique des images publiques Amazon ECR et des images d'un référentiel Amazon ECR appartenant à un AWS compte différent de celui dans lequel se trouve votre service.
  
  Pour plus d'informations sur les méthodes de déploiement, consultezMéthodes de déploiement.
2. [Fournisseur Amazon ECR] Pour le rôle d'accès ECR, choisissez un rôle de service existant dans votre compte ou choisissez d'en créer un nouveau. Si vous utilisez le déploiement manuel, vous pouvez également choisir d'utiliser le rôle d'utilisateur IAM au moment du déploiement.
3. Choisissez Suivant.
Configurez votre service.
1. Sur la page Configurer le service, dans la section Paramètres du service, entrez un nom de service et le port IP que votre site Web de service écoute.
  
  Note
  Tous les autres paramètres de service sont facultatifs ou ont des valeurs par défaut fournies par la console.
2. (Facultatif) Modifiez ou ajoutez d'autres paramètres en fonction des besoins de votre application.
3. Choisissez Suivant.
Sur la page Réviser et créer, vérifiez tous les détails que vous avez saisis, puis choisissez Créer et déployer.

Résultat : Si le service est créé avec succès, la console affiche le tableau de bord du service, avec un aperçu du nouveau service.
Vérifiez que votre service fonctionne.
1. Sur la page du tableau de bord du service, attendez que l'état du service soit en cours d'exécution.
2. Choisissez la valeur de domaine par défaut. Il s'agit de l'URL du site Web de votre service.
3. Utilisez votre site Web et vérifiez qu'il fonctionne correctement.

Création d'un service à partir d'une image à l'aide de l'API App Runner ou AWS CLI

Pour créer un service à l'aide de l'API App Runner AWS CLI, appelez l'action CreateService API.

La création de votre service commence si l'appel renvoie une réponse réussie avec un objet Service affiché"Status": "CREATING".

Pour un exemple d'appel, voir Créer un service de référentiel d'images source dans la référence de l'AWS App Runner API

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Gestion de votre service

Reconstruire le service qui a échoué