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.
Étape 4 : Déployez votre application Hello World
Vous devez maintenant déployer l'exemple de révision de l'application Hello World que vous avez chargé sur Amazon S3. Vous utilisez la console AWS CLI ou la CodeDeploy console pour déployer la révision et suivre la progression du déploiement. Une fois que la révision d'application est déployée avec succès, vous vérifiez les résultats.
Rubriques
Déployez la révision de votre application avec CodeDeploy
Vous pouvez déployer votre application à l'aide de la console CLI ou de la console.
Rubriques
Pour déployer la révision de votre application (CLI)
-
Tout d'abord, le déploiement a besoin d'un groupe de déploiement. Toutefois, avant de créer le groupe de déploiement, vous avez besoin d'un rôle de serviceARN. Un rôle de service est un IAM rôle qui autorise un service à agir en votre nom. Dans ce cas, le rôle de service donne CodeDeploy l'autorisation d'accéder à vos EC2 instances Amazon pour développer (lire) leurs balises d'EC2instance Amazon.
Vous devriez avoir déjà suivi les instructions de la rubrique Création d'un rôle de service (CLI) pour créer un rôle de service. Pour connaître le rôle ARN de service, voirObtenez l'ARN du rôle de service (CLI) .
-
Maintenant que vous disposez duARN, appelez la create-deployment-group commande pour créer un groupe de déploiement nommé
HelloWorld_DepGroup
, associé à l'application nomméeHelloWorld_App
, à l'aide de la balise d'EC2instance AmazonCodeDeployDemo
et du nom de la configuration de déploiementCodeDeployDefault.OneAtATime
, avec le rôle de service ARN :aws deploy create-deployment-group --application-name HelloWorld_App --deployment-group-name HelloWorld_DepGroup --deployment-config-name CodeDeployDefault.OneAtATime --ec2-tag-filters Key=Name,Value=CodeDeployDemo,Type=KEY_AND_VALUE --service-role-arn
serviceRoleARN
Note
La create-deployment-groupcommande permet de créer des déclencheurs qui entraînent l'envoi de SNS notifications Amazon aux abonnés du topic concernant des événements spécifiques liés aux déploiements et aux instances. La commande prend également en charge des options permettant d'annuler automatiquement les déploiements et de configurer des alarmes pour arrêter les déploiements lorsque les seuils de surveillance des CloudWatch alarmes d'Amazon sont atteints. Les commandes associées à ces actions ne sont pas incluses dans ce didacticiel.
-
Avant de créer un déploiement, l' CodeDeploy agent doit être installé sur les instances de votre groupe de déploiement. Vous pouvez installer l'agent à partir de la ligne de commande AWS Systems Manager avec la commande suivante :
aws ssm create-association --name AWS-ConfigureAWSPackage --targets Key=tag:Name,Values=CodeDeployDemo --parameters action=Install,name=AWSCodeDeployAgent --schedule-expression "cron(0 2 ? * SUN *)"
Cette commande crée une association dans Systems Manager State Manager qui installera l' CodeDeploy agent puis tentera de le mettre à jour à 2h00 tous les dimanches matins. Pour plus d'informations sur l' CodeDeploy agent, consultez la section Utilisation de l' CodeDeploy agent. Pour plus d'informations sur Systems Manager, consultez What is AWS Systems Manager.
-
Maintenant, appelez la commande create-deployment pour créer un déploiement associé à l'application nommée
HelloWorld_App
, à la configuration de déploiement nomméeCodeDeployDefault.OneAtATime
et au groupe de déploiement nomméHelloWorld_DepGroup
, en utilisant la révision d'application nomméeHelloWorld_App.zip
dans le compartiment nomméamzn-s3-demo-bucket
:aws deploy create-deployment --application-name HelloWorld_App --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name HelloWorld_DepGroup --s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,key=HelloWorld_App.zip
Pour déployer votre révision d'application (console)
-
Avant d'utiliser la CodeDeploy console pour déployer la révision de votre application, vous devez disposer d'un rôle de serviceARN. Un rôle de service est un IAM rôle qui autorise un service à agir en votre nom. Dans ce cas, le rôle de service donne CodeDeploy l'autorisation d'accéder à vos EC2 instances Amazon pour développer (lire) leurs balises d'EC2instance Amazon.
Vous devriez avoir déjà suivi les instructions de la rubrique Création d'un rôle de service (console) pour créer un rôle de service. Pour connaître le rôle ARN de service, voirObtenir l'ARN du rôle de service (console) .
-
Maintenant que vous disposez duARN, vous pouvez utiliser la CodeDeploy console pour déployer la révision de votre application.
Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/codedeploy.
Note
Connectez-vous avec le même utilisateur que celui que vous avez configuréCommencer avec CodeDeploy.
Dans le volet de navigation, développez Deploy, puis choisissez Applications.
-
Choisissez HelloWorld_App.
-
Dans l'onglet Groupes de déploiement, choisissez Créer un groupe de déploiement.
-
Dans Nom du groupe de déploiement, saisissez
HelloWorld_DepGroup
. -
Dans Rôle de service, choisissez le nom du rôle de service.
-
Dans Type de déploiement, choisissez Sur place.
-
Dans Configuration de l'environnement, sélectionnez Amazon EC2 instances.
-
Dans la configuration de l'agent avec AWS Systems Manager, conservez les valeurs par défaut.
-
Dans Clé, entrez
Name
. -
Dans Value (Valeur), entrez
CodeDeployDemo
. -
Dans Configuration du déploiement, choisissez CodeDeployDefault. OneAtATime.
-
Dans Équilibreur de charge, désactivez Activer l'équilibrage de charge.
-
Choisissez Créer un groupe de déploiement.
-
Choisissez Créer un déploiement.
-
Dans le groupe de déploiement, choisissez HelloWorld_ DepGroup
-
Dans Type de révision, choisissez Mon application est stockée dans Amazon S3, puis dans Emplacement de la révision, entrez l'emplacement de l'exemple de révision de l'application Hello World que vous avez précédemment chargé sur Amazon S3. Pour obtenir cet emplacement :
Ouvrez la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/
. -
Dans la liste des buckets, choisissez amzn-s3-demo-bucket (ou le nom du bucket dans lequel vous avez chargé la révision de votre application).
-
Dans la liste des objets, choisissez HelloWorld_App.zip.
-
Dans l’onglet Overview (Présentation), choisissez Copy path (Copier le chemin).
-
Retournez à la CodeDeploy console, puis dans Emplacement des révisions, collez la valeur du champ Lien.
-
Pour Revision file type (Type de fichier de révision), choisissez .zip.
-
(Facultatif) Entrez un commentaire dans Deployment description) Description du déploiement.
-
Choisissez Créer un déploiement. Des informations sur votre déploiement nouvellement créé s'affichent dans la page Deployments.
Surveillez et résolvez les problèmes liés à votre déploiement
Utilisez la console AWS CLI ou la console pour surveiller et résoudre les problèmes liés à votre déploiement.
Rubriques
Pour surveiller et résoudre les problèmes liés à votre déploiement () CLI
-
Obtenez l'ID du déploiement en appelant la commande list-deployments sur l'application nommée
HelloWorld_App
et le groupe de déploiement nomméHelloWorld_DepGroup
:aws deploy list-deployments --application-name HelloWorld_App --deployment-group-name HelloWorld_DepGroup --query "deployments" --output text
-
Appelez la commande get-deployment avec l'ID du déploiement :
aws deploy get-deployment --deployment-id
deploymentID
--query "deploymentInfo.status" --output text -
La commande renvoie l'état général du déploiement. En cas de réussite, la valeur est
Succeeded
.Si l'état général est le cas
Failed
, vous pouvez appeler des commandes telles que list-deployment-instanceset get-deployment-instancepour résoudre les problèmes. Pour plus d'options de dépannage, consultez la page Analyse des fichiers journaux pour enquêter sur des échecs de déploiement sur les instances.
Pour surveiller et dépanner votre déploiement (console)
Sur la page Déploiements de la CodeDeploy console, vous pouvez surveiller l'état de votre déploiement dans la colonne État.
Pour obtenir plus d'informations sur votre déploiement, notamment si la valeur de la colonne Étata une valeur différente de Succeeded :
-
Dans la table Déploiements, choisissez votre ID de déploiement. Une fois qu'un déploiement a échoué, un message décrivant la raison de l'échec s'affiche sur la page des détails du déploiement.
-
. Des informations supplémentaires sur les instances du déploiement sont affichées. Après l'échec d'un déploiement, vous pourrez peut-être déterminer sur quelles EC2 instances Amazon et à quelle étape le déploiement a échoué.
-
Si vous souhaitez effectuer davantage d'opérations de dépannage, vous pouvez utiliser une technique telle que celle exposée dans la rubrique View Instance Details. Vous pouvez également analyser les fichiers journaux de déploiement sur une EC2 instance Amazon. Pour de plus amples informations, veuillez consulter Analyse des fichiers journaux pour enquêter sur des échecs de déploiement sur les instances.
Vérifiez votre déploiement
Une fois que votre déploiement a réussi, vérifiez que votre installation fonctionne. Utilisez l'DNSadresse publique de l'EC2instance Amazon pour afficher la page Web dans un navigateur Web. (Pour obtenir la DNS valeur publique, dans la EC2 console Amazon, choisissez l'EC2instance Amazon, puis dans l'onglet Description, recherchez la valeur dans Public DNS.)
Par exemple, si l'DNSadresse publique de votre EC2 instance Amazon estec2-01-234-567-890.compute-1.amazonaws.com
, vous devez utiliser ce qui suit URL :
http://ec2-01-234-567-890.compute-1.amazonaws.com
En cas de succès, vous devez voir une page Web « Hello, World! ».