Comment déployerApplications - AWS Serverless Application Repository

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.

Comment déployerApplications

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 informations, comme ses autorisations, ses capacités et le nombre de fois où elle a été déployée parAWSclients.

    Le nombre de déploiements est affiché pour leAWSRé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. Cette 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 que votre déploiement se termine, vous pouvez rechercher d'autres applications et revenir sur cette page via la console Lambda.

Une fois que votre application a été déployée avec succès, vous pouvez vérifier et gérer les ressources créées à l'aide desAWSOutils.

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. Examinez les capacités de l'application. Utilisez leAWS CLIpour examiner les capacité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'API GetApplicationdans leAWSSDK pour obtenir ces données.

  2. Créez le jeu de modifications. Vous devez fournir l'ensemble desCapacitéslorsque vous créez leAWS CloudFormationChangeset 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'API CreateCloudFormationChangeSetdans leAWSSDK pour créer le jeu de modifications.

    Par exemple, la commande AWS CLI suivante permet de reconnaître une application contenant une ressource AWS::IAM::Role 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'API ExecuteChangeSetdans leAWSSDK 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 :