Comment déployer des applications

Cette section fournit des procédures de déploiement d'applications sans serveur à partir de la AWS Serverless Application Repository en utilisant le AWS Management Console ou l'AWS CLI.

Déploiement d'une nouvelle application (console)

Cette section vous montre comment déployer une nouvelle application à partir de AWS Serverless Application Repository en utilisant AWS Management Console. Pour obtenir des instructions sur le déploiement d'une nouvelle version d'une application existante, veuillez consulter Mise à jour des applications.

Exploration, recherche et déploiement d'applications

Recherchez, configurez et déployez une application dans AWS Serverless Application Repository à l'aide de la procédure suivante.

Pour rechercher et configurer une application dans AWS Serverless Application Repository

1. Ouvrez la page d'accueil publique AWS Serverless Application Repository, ou ouvrez la console AWS Lambda. Choisissez Créer une fonction, puis choisissez Parcourir le référentiel d'applications sans serveur.

2. Recherchez une application.

   Note

   Pour afficher les applications contenant des rôles IAM ou des stratégies de ressources personnalisés, cochez la case Show apps that create custom IAM roles or resource policies (Afficher les applications qui créent des rôles IAM ou des stratégies de ressources personnalisés). Pour plus d'informations sur les rôles IAM et les stratégies de ressources personnalisés, consultez Confirmation des capacités d'une application.

3. Choisissez une application pour afficher des détails tels que ses autorisations, ses fonctionnalités et le nombre de fois où elle a été déployée parAWS les clients.

   Le nombre de déploiements s'affiche pour laAWS région dans laquelle vous essayez de déployer l'application.

4. Sur la page des détails de l'application, consultez les autorisations et les ressources de l'application en affichant le modèle AWS SAM, la licence et le fichier Lisez-moi. Sur cette page, vous pouvez également rechercher le lien Source code URL (URL du code source) des applications publiquement partagées. Si l'application comprend des applications imbriquées, vous pouvez également afficher les détails de ces applications sur cette page.

5. Configurez l'application dans la section Application settings (Paramètres de l'application). Pour obtenir des instructions sur la configuration d'une application particulière, consultez le fichier Lisez-moi de l'application.

   Par exemple, la configuration requise peut inclure la spécification du nom d'une ressource à laquelle vous voulez que l'application accède. Une telle ressource peut être une table Amazon DynamoDB, un compartiment Amazon S3 ou une API Amazon API Gateway.

6. Choisissez Deploy (Déployer). Vous accédez ainsi à la page Statut du déploiement.

   Note

   Si l'application dispose de fonctionnalités nécessitant un accusé de réception, vous devez cocher la case J'accuse réception que cette application crée des rôles IAM personnalisés ou des stratégies de ressources avant de déployer l'application. Si vous ne le faites pas, une erreur se produit. Pour plus d'informations sur les rôles IAM et les stratégies de ressources personnalisés, consultez Confirmation des capacités d'une application.

7. Sur la page Deployment status (Statut du déploiement), vous pouvez consulter la progression de votre déploiement. En attendant la fin de votre déploiement, vous pouvez rechercher et parcourir d'autres applications, puis revenir à cette page via la console Lambda.

Une fois votre application déployée avec succès, vous pouvez consulter et gérer les ressources qui ont été créées à l'aideAWS des outils existants.

Déploiement d'une nouvelle application (AWS CLI)

Cette section vous montre comment déployer une nouvelle application à partir de l'AWS Serverless Application Repository en utilisant la AWS CLI. Pour obtenir des instructions sur le déploiement d'une nouvelle version d'une application existante, veuillez consulter Mise à jour des applications.

Recherche et confirmation des capacités d'une application (AWS CLI)

Pour confirmer les capacités d'une application à l'aide de l'AWS CLI, procédez comme suit :

1. Passez en revue les fonctionnalités de l'application.Utilisez laAWS CLI commande suivante pour vérifier les fonctionnalités d'une application :

   aws serverlessrepo get-application \
   --application-id application-arn

   La propriété de réponse requiredCapabilities contient la liste des capacités d'application que vous devez confirmer pour pouvoir déployer l'application. Vous pouvez également utiliser l'GetApplication API desAWS SDK pour obtenir ces données.

2. Créez le changeset.Vous devez fournir l'ensemble des fonctionnalités requises lorsque vous créez leAWS CloudFormation changeset. Par exemple, utilisez la commande de l'AWS CLI suivante pour déployer une application en confirmant ses capacités :

   aws serverlessrepo create-cloud-formation-change-set \
   --application-id application-arn \
   --stack-name unique-name-for-cloud-formation-stack \
   --capabilities list-of-capabilities

   L'ID de changeset est renvoyé lorsque cette commande est exécutée avec succès. Vous avez besoin de l'ID de changeset pour l'étape suivante. Vous pouvez également utiliser l'CreateCloudFormationChangeSet API desAWS SDK pour créer le changeset.

   Par exemple, laAWS CLI commande suivante reconnaît une application qui contient une AWS::IAM::Roleressource avec un nom personnalisé et une ou plusieurs applications imbriquées :

   aws serverlessrepo create-cloud-formation-change-set \
   --application-id application-arn \
   --stack-name unique-name-for-cloud-formation-stack \
   --capabilities CAPABILITY_NAMED_IAM CAPABILITY_AUTO_EXPAND

3. Exécutez le changeset.L'exécution du changeset effectue réellement le déploiement. Indiquez l'ID de changeset qui a été renvoyé lorsque vous avez créé le changeset à l'étape précédente.

   L'exemple de commande AWS CLI suivant exécute le changeset de l'application pour déployer cette dernière :

   aws cloudformation execute-change-set \
   --change-set-name changeset-id-arn

   Vous pouvez également utiliser l'ExecuteChangeSet API desAWS SDK pour exécuter le changeset.

Suppression des piles d'applications

Pour supprimer une application précédemment déployée à l'aide de l'AWS Serverless Application Repository, suivez la même procédure que pour la suppression d'une pile AWS CloudFormation :

• AWS Management Console: Pour supprimer une application à l'aide duAWS Management Console, consultez la section Supprimer une pile sur laAWS CloudFormation console dans le Guide deAWS CloudFormation l'utilisateur.

• AWS CLI: Pour supprimer une application à l'aide duAWS CLI, consultez la section Supprimer une pile dans le Guide deAWS CloudFormation l'utilisateur.