View a markdown version of this page

Utilisation AWS App Runner avec AWS Toolkit for Visual Studio Code - AWS BOÎTE À OUTILS POUR VS CODE
Conditions préalablesTarification

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.

Utilisation AWS App Runner avec AWS Toolkit for Visual Studio Code

AWS App Runnerfournit un moyen rapide, simple et rentable de déployer à partir du code source ou d'une image de conteneur directement vers une application Web évolutive et sécurisée dans le AWS cloud. Pour l'utiliser, vous n'avez pas besoin d'apprendre de nouvelles technologies, de choisir le service de calcul à utiliser ou de savoir comment provisionner et configurer les AWS ressources.

Vous pouvez l'utiliser AWS App Runner pour créer et gérer des services en fonction d'une image source ou d'un code source. Si vous utilisez une image source, vous pouvez choisir une image de conteneur publique ou privée qui est stockée dans un référentiel d'images. App Runner prend en charge les fournisseurs de référentiels d'images suivants :

  • Amazon Elastic Container Registry (Amazon ECR) : stocke les images privées dans votre AWS compte.

  • Amazon Elastic Container Registry Public (Amazon ECR Public) : stocke les images qui peuvent être lues publiquement.

Si vous choisissez l'option de code source, vous pouvez déployer à partir d'un référentiel de code source maintenu par un fournisseur de référentiel pris en charge. Actuellement, App Runner est compatible en GitHub tant que fournisseur de référentiel de code source.

Conditions préalables

Pour interagir avec App Runner à l'aide des éléments AWS Toolkit for Visual Studio Code suivants, vous devez :

  • Un AWS compte

  • Une version de AWS Toolkit for Visual Studio Code ces fonctionnalités AWS App Runner

En plus de ces exigences de base, assurez-vous que tous les utilisateurs IAM concernés ont l'autorisation d'interagir avec le service App Runner. Vous devez également obtenir des informations spécifiques sur votre source de service, telles que l'URI de l'image du conteneur ou la connexion au GitHub référentiel. Vous avez besoin de ces informations lors de la création de votre service App Runner.

Le moyen le plus simple d'accorder les autorisations requises pour App Runner consiste à associer une politique AWS gérée existante à l'entité Gestion des identités et des accès AWS (IAM) concernée, en particulier à un utilisateur ou à un groupe. App Runner fournit deux politiques gérées que vous pouvez attacher à vos utilisateurs IAM :

  • AWSAppRunnerFullAccess : permet aux utilisateurs d'effectuer toutes les actions d'App Runner.

  • AWSAppRunnerReadOnlyAccess : permet aux utilisateurs de répertorier et d'afficher les détails des ressources d'App Runner.

En outre, si vous choisissez un référentiel privé dans Amazon Elastic Container Registry (Amazon ECR) comme source de service, vous devez créer le rôle d'accès suivant pour votre service App Runner :

  • AWSAppRunnerServicePolicyForECRAccess : permet à App Runner d'accéder aux images Amazon Elastic Container Registry (Amazon ECR) dans votre compte.

Vous pouvez créer ce rôle automatiquement lors de la configuration de votre instance de service à l'aide de la palette de commandes de VS Code.

Note

Le rôle AWSServiceRoleForAppRunner lié à un service permet d' AWS App Runner effectuer les tâches suivantes :

  • Transférez les journaux vers les groupes de CloudWatch journaux Amazon Logs.

  • Créez des règles Amazon CloudWatch Events pour vous abonner à la transmission d'images Amazon Elastic Container Registry (Amazon ECR).

Vous n’avez pas besoin de créer manuellement un rôle lié au service . Lorsque vous créez un rôle AWS App Runner dans Console de gestion AWS ou à l'aide d'opérations d'API appelées par AWS Toolkit for Visual Studio Code, AWS App Runner crée ce rôle lié à un service pour vous.

Pour plus d'informations, consultez Gestion des identités et des accès pour App Runner dans le Guide du développeur AWS App Runner .

Vous pouvez utiliser AWS App Runner pour déployer des services à partir d'une image source ou d'un code source.

Source image

Si vous effectuez un déploiement à partir d'une image source, vous pouvez obtenir un lien vers le référentiel de cette image à partir d'un registre d' AWS images privé ou public.

Note

Vous pouvez également obtenir l'URI d'un référentiel Amazon ECR privé directement depuis AWS Explorer dans Toolkit for VS Code :

  • Ouvrez AWS Explorer et développez le nœud ECR pour afficher la liste des référentiels de cette AWS région.

  • Right-click un référentiel et choisissez Copier l'URI du référentiel pour copier le lien dans votre presse-papiers.

Vous spécifiez l'URI du référentiel d'images lors de la configuration de votre instance de service à l'aide de la palette de commandes de VS Code

Pour plus d'informations, consultez Service App Runner basé sur une image source dans le Guide du développeur AWS App Runner .

Source code

Pour que votre code source soit déployé sur un AWS App Runner service, il doit être stocké dans un dépôt Git géré par un fournisseur de référentiel pris en charge. App Runner prend en charge un fournisseur de référentiel de code source : GitHub.

Pour plus d'informations sur la configuration d'un GitHub référentiel, consultez la documentation de démarrage sur GitHub.

Pour déployer votre code source sur un service App Runner à partir d'un GitHub référentiel, App Runner établit une connexion à GitHub. Si votre dépôt est privé (c'est-à-dire qu'il n'est pas accessible au public le GitHub), vous devez fournir les informations de connexion à App Runner.

Important

Pour créer GitHub des connexions, vous devez utiliser la console App Runner (https://console.aws.amazon.com/apprunner) pour créer une connexion GitHub vers AWS. Vous pouvez sélectionner les connexions disponibles sur la page des GitHub connexions lors de la configuration de votre instance de service à l'aide de la palette de commandes de VS Code.

Pour plus d'informations, consultez Gestion des connexions App Runner dans le Guide du développeur AWS App Runner .

L'instance de service App Runner fournit un environnement d'exécution géré qui permet de créer et d'exécuter votre code. AWS App Runner prend actuellement en charge les environnements d'exécution suivants :

  • Exécution gérée par Python

  • Node.js exécution gérée

Dans le cadre de la configuration de votre service, vous fournissez des informations sur la façon dont le service App Runner crée et démarre votre service. Vous pouvez saisir ces informations à l'aide de la palette de commandes ou spécifier un fichier de configuration YAML-formatted App Runner. Les valeurs de ce fichier indiquent à App Runner comment créer et démarrer votre service et fournissent le contexte d'exécution. Cela inclut les paramètres réseau et les variables d'environnement pertinents. Le fichier de configuration a pour nom apprunner.yaml. Il est automatiquement ajouté au répertoire racine du référentiel de votre application.

Tarification

Les ressources de calcul et de mémoire utilisées par votre application vous sont facturées. De plus, si vous automatisez vos déploiements, vous payez également des frais mensuels fixes pour chaque application, qui couvrent tous les déploiements automatisés pour ce mois. Si vous optez pour un déploiement à partir du code source, vous payez en outre des frais de création correspondant au temps nécessaire à App Runner pour créer un conteneur à partir de votre code source.

Pour plus d’informations, consultez AWS App Runner Tarification.

Rubriques