# Utilisation d'AWS Toolkit pour JetBrains avec AWS App Runner [AWS App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/what-is-apprunner.html) qui offre un moyen rapide, simple et économique de déployer directement, à partir du code source ou d'une image de conteneur, une application web évolutive et sécurisée dans le cloud AWS. Vous n'avez pas besoin de vous former à de nouvelles technologies, de décider du service de calcul à utiliser ou de savoir comment approvisionner et configurer des ressources AWS. Vous pouvez 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 prend en charge [GitHub](https://github.com/) comme fournisseur de référentiel de code source : ## Prérequis Cette section suppose que vous avez déjà un compte AWS et la dernière version d'AWS Toolkit for JetBrains qui inclut 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 la source de votre service, comme l'URI de l'image du conteneur ou la connexion au référentiel GitHub. Vous avez besoin de ces informations lors de la création de votre service App Runner. ### Configuration des autorisations IAM pour App Runner La façon la plus simple d'accorder les autorisations requises pour App Runner est d'attacher une politique gérée AWS existante à l'entité IAM concernée, plus précisément 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 utiliser la boîte de dialogue **Créer un service App Runner** pour créer ce rôle IAM. **Note** Le rôle lié au service **AWSServiceRoleForAppRunner** permet à AWS App Runner d'effectuer les tâches suivantes : Envoyer (push) les journaux aux groupes de journaux Amazon CloudWatch Logs. Créer des règles Amazon CloudWatch Events pour s'abonner au push de l'image 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 AWS App Runner dans la AWS Management Console ou en utilisant des opérations d'API qui sont appelées par AWS Toolkit for JetBrains, 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 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'images AWS 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). Vous spécifiez l'URI du référentiel d'images lorsque vous entrez les détails de votre source dans la boîte de dialogue **Créer un service App Runner**. 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 puisse être déployé dans un service AWS App Runner, ce code doit être stocké dans un référentiel Git maintenu par un fournisseur de référentiel pris en charge. App Runner prend en charge un seul fournisseur de référentiel de code source : [GitHub](https://github.com/). Pour plus d'informations sur la configuration d'un référentiel GitHub, consultez la [documentation de démarrage](https://docs.github.com/en/github/getting-started-with-github) sur GitHub. Pour déployer votre code source vers un service App Runner à partir d'un référentiel GitHub, App Runner établit une connexion à GitHub. Si votre référentiel est privé (c'est-à-dire qu'il n'est pas accessible au public sur GitHub), vous devez fournir à App Runner les détails de connexion. **Important** Pour créer des connexions GitHub, vous devez utiliser la console App Runner ([https://console.aws.amazon.com/apprunner](https://console.aws.amazon.com/apprunner)) pour créer une connexion qui relie GitHub à AWS. Vous pouvez sélectionner les connexions disponibles sur la page des **connexions GitHub** lorsque vous utilisez la boîte de dialogue **Créer un service App Runner** pour spécifier les détails de votre référentiel de code source. 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 + Exécution gérée par Node.js En utilisant la boîte de dialogue **Créer un service App Runner** disponible dans AWS Toolkit for JetBrains, vous fournissez des informations sur la façon dont le service App Runner compile et démarre votre service. Vous pouvez saisir les informations directement dans l'interface ou spécifier un [fichier de configuration App Runner au format YAML](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 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 Pricing](https://aws.amazon.com/apprunner/pricing/) (Tarification CTlong). **Topics** + [Prérequis](#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)