Création de services App Runner - AWS Boîte à outils pour VS Code

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.

Création de services App Runner

Vous pouvez créer un service App Runner dans Toolkit for VS Code en utilisant l'AWS explorateur et la palette de commandes de VS Code. Une fois que vous avez choisi de créer un service dans une AWS région spécifique, les étapes numérotées fournies par la palette de commandes vous guident tout au long du processus de configuration de l'instance de service sur laquelle votre application s'exécute.

Avant de créer un service App Runner, assurez-vous que vous avez rempli les prérequis. Cela inclut la fourniture des autorisations IAM pertinentes et la confirmation du référentiel source spécifique que vous souhaitez déployer.

Pour créer un service App Runner

  1. Ouvrez AWS l'Explorateur, s'il n'est pas déjà ouvert.

  2. Cliquez avec le bouton droit de la souris sur le nœud App Runner et choisissez Create Service (Créer un service).

    La palette de commandes s'affiche.

  3. Pour Select a source code location type (Sélectionner un type d'emplacement de code source), choisissez ECR ou Repository (Référentiel).

    Si vous choisissez ECR, vous spécifiez une image de conteneur dans un référentiel maintenu par Amazon Elastic Container Registry. Si vous choisissez Repository (Référentiel), vous spécifiez un référentiel de code source maintenu par un fournisseur de référentiel pris en charge. Actuellement, App Runner le prend en charge en GitHubtant que fournisseur de référentiel de code source.

  1. Pour Select or enter an image repository (Sélectionner ou entrer un référentiel d'images), choisissez ou saisissez l'URL du référentiel d'images qui est maintenu par votre registre privé Amazon ECR ou la galerie publique Amazon ECR.

    Note

    Si vous spécifiez un référentiel de la galerie publique Amazon ECR, assurez-vous que les déploiements automatiques sont désactivés car App Runner ne prend pas en charge les déploiements automatiques pour une image dans un référentiel public ECR.

    Les déploiements automatiques sont désactivés par défaut, ce qui est indiqué lorsque l'icône de l'en-tête de la palette de commandes est traversée par une ligne diagonale. Si vous choisissez d'activer les déploiements automatiques, un message vous informe que cette option peut entraîner des coûts supplémentaires.

  2. Si l'étape de la palette de commandes indique qu'aucune balise n'a été trouvée, vous devez revenir en arrière pour sélectionner un référentiel contenant une image de conteneur balisée.

  3. Si vous utilisez un registre privé Amazon ECR, vous devez disposer du rôle d'accès ECR, AppRunnerECR AccessRole, qui permet à App Runner d'accéder aux images Amazon Elastic Container Registry (Amazon ECR) de votre compte. Cliquez sur l'icône « + » dans l'en-tête de la palette de commandes pour créer automatiquement ce rôle. (Un rôle d'accès n'est pas nécessaire si votre image est stockée dans Amazon ECR public, où les images sont accessibles au public.)

  4. Pour Port, saisissez le port IP utilisé par le service (Port 8000, par exemple).

  5. Pour Configure environment variables (Configurer les variables d'environnement), vous pouvez spécifier un fichier qui contient des variables d'environnement utilisées pour personnaliser le comportement de votre instance de service. Vous pouvez également ignorer cette étape.

  6. Pour Name your service (Nommer votre service), saisissez un nom unique sans espaces et appuyez sur Entrée.

  7. Pour Select instance configuration (Sélectionner la configuration de l'instance), choisissez une combinaison d'unités CPU et de mémoire en Go pour votre instance de service.

    Lorsque votre service est en cours de création, son statut passe de Creating (Création) à Running (Exécution).

  8. Une fois que votre service commence à s'exécuter, cliquez dessus du bouton droit de la souris et choisissez Copy Service URL (Copier l'URL du service).

  9. Pour accéder à votre application déployée, collez l'URL copiée dans la barre d'adresse de votre navigateur Web.

  1. Pour Sélectionner une connexion, choisissez une connexion liée GitHub à AWS. Les connexions disponibles pour la sélection sont répertoriées sur la page GitHub des connexions de la console App Runner.

  2. Pour Sélectionner un GitHub référentiel distant, choisissez ou entrez une URL pour le référentiel distant.

    Les référentiels distants déjà configurés avec la gestion du contrôle de source (SCM) de Visual Studio Code peuvent être sélectionnés. Vous pouvez également coller un lien vers le référentiel s'il n'est pas répertorié.

  3. Pour Select a branch (Sélectionner une branche), choisissez la branche Git de votre code source que vous souhaitez déployer.

  4. Pour Choose configuration source (Choisir la source de la configuration), indiquez comment vous souhaitez définir votre configuration d'exécution.

    Si vous choisissez Use configuration file (Utiliser le fichier de configuration), votre instance de service est configurée par les paramètres qui sont définis par le fichier de configuration apprunner.yaml. Ce fichier se trouve dans le répertoire racine du référentiel de votre application.

    Si vous choisissez Configurer tous les paramètres ici, utilisez la palette de commandes pour spécifier les éléments suivants :

    • Runtime (Exécution) : choisissez Python 3 ou Nodejs 12.

    • Build command (Commande de création) : saisissez la commande permettant de créer votre application dans l'environnement d'exécution de votre instance de service.

    • Start command (Commande de démarrage) : saisissez la commande permettant de démarrer votre application dans l'environnement d'exécution de votre instance de service.

  5. Pour Port, saisissez le port IP utilisé par le service (Port 8000, par exemple).

  6. Pour Configure environment variables (Configurer les variables d'environnement), vous pouvez spécifier un fichier qui contient des variables d'environnement utilisées pour personnaliser le comportement de votre instance de service. Vous pouvez également ignorer cette étape.

  7. Pour Name your service (Nommer votre service), saisissez un nom unique sans espaces et appuyez sur Entrée.

  8. Pour Select instance configuration (Sélectionner la configuration de l'instance), choisissez une combinaison d'unités CPU et de mémoire en Go pour votre instance de service.

    Lorsque votre service est en cours de création, son statut passe de Creating (Création) à Running (Exécution).

  9. Une fois que votre service commence à s'exécuter, cliquez dessus du bouton droit de la souris et choisissez Copy Service URL (Copier l'URL du service).

  10. Pour accéder à votre application déployée, collez l'URL copiée dans la barre d'adresse de votre navigateur Web.

Note

Si votre tentative de création d'un service App Runner échoue, le service affiche le statut Create failed (Création échouée) dans AWS Explorer. Pour des conseils de dépannage, consultez Lorsque la création du service échoue dans le Guide du développeur App Runner.