

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
<a name="using-apprunner"></a>

[AWS App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/what-is-apprunner.html)fournit 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 ](https://github.com/) tant que fournisseur de référentiel de code source.

## Conditions préalables
<a name="apprunner-prereqs"></a>

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.

### Configuration des autorisations IAM pour App Runner
<a name="app-runner-permissions"></a>

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](https://docs.aws.amazon.com/apprunner/latest/dg/security-iam.html) dans le *Guide du développeur AWS App Runner *.

### Obtention de sources de service pour App Runner
<a name="app-runner-sources"></a>

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. 
+ 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 ](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/ ](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 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](https://docs.aws.amazon.com/apprunner/latest/dg/service-source-image.html) 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](https://github.com/).

Pour plus d'informations sur la configuration d'un GitHub référentiel, consultez la documentation de [ démarrage ](https://docs.github.com/en/github/getting-started-with-github) 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](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](https://docs.aws.amazon.com/apprunner/latest/dg/manage-connections.html) 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](https://docs.aws.amazon.com/apprunner/latest/dg/config-file.html). 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
<a name="app-runner-pricing"></a>

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](https://aws.amazon.com/apprunner/pricing/).

**Topics**
+ [Conditions préalables](#apprunner-prereqs)
+ [Tarification](#app-runner-pricing)
+ [Création de services App Runner](creating-service-apprunner.md)
+ [Gestion des services App Runner](managing-service-apprunner.md)