Utilisation AWS App Runner avec AWS Toolkit for Visual Studio Code

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

Vous pouvez l'utiliser AWS App Runner pour créer et gérer des services basés sur une image source ou 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 compte. AWS

• 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 le prend en charge en GitHubtant que fournisseur de référentiel de code source.

Prérequis

Pour interagir avec App Runner à l'aide AWS Toolkit for Visual Studio Code de ce qui suit :

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

Configuration des autorisations IAM pour 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é AWS Identity and Access Management (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 avec la palette de commandes de VS Code.

Note

Le rôle AWSServiceRoleForAppRunnerlié au 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 à Amazon Elastic Container Registry (Amazon ECR) image push.

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 AWS Management Console 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 .

Obtention de sources de service pour 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 déployez à 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.

• Registre privé Amazon ECR : copiez l'URI d'un référentiel privé qui utilise la console Amazon ECR à l'adresse https://console.aws.amazon.com/ecr/repositories.

• Registre public Amazon ECR : copiez l'URI d'un référentiel public qui utilise la galerie publique Amazon ECR à l'adresse https://gallery.ecr.aws/.

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 pour cette AWS région.

• Cliquez avec le bouton droit de la souris sur un référentiel et choisissez Copy Repository URI (Copier l'URI du référentiel) pour copier le lien dans votre presse-papier.

Vous spécifiez l'URI du référentiel d'images lors de la configuration de votre instance de service avec 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, ce code doit être stocké dans un dépôt Git géré par un fournisseur de dépôt compatible. 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 sur GitHub), vous devez fournir à App Runner les informations de connexion.

Important

Pour créer des GitHub connexions, vous devez utiliser la console App Runner (https://console.aws.amazon.com/apprunner) pour créer une connexion liée GitHub à AWS. Vous pouvez sélectionner les connexions disponibles sur la page des GitHubconnexions lors de la configuration de votre instance de service avec 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 à votre code de se générer et de s'exécuter. AWS App Runner prend actuellement en charge les environnements d'exécution suivants :

• Exécution gérée par Python

• Exécution gérée par Node.js

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 Command Palette (Palette de commande) ou spécifier un fichier de configuration App Runner au format YAML. 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 Tarification d’AWS App Runner.

Rubriques

• Création de services App Runner
• Gestion des services App Runner