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.
CodeDeploy exemples utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with CodeDeploy.
Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
Rubriques
Actions
L'exemple de code suivant montre comment utiliseradd-tags-to-on-premises-instances.
- AWS CLI
-
Pour ajouter des balises à des instances sur site
L'
add-tags-to-on-premises-instancesexemple suivant associe AWS CodeDeploy la même balise d'instance locale à deux instances locales. Il n'enregistre pas les instances locales auprès de. AWS CodeDeployaws deploy add-tags-to-on-premises-instances \ --instance-namesAssetTag12010298EXAssetTag23121309EX\ --tagsKey=Name,Value=CodeDeployDemo-OnPremCette commande ne produit aucune sortie.
-
Pour plus de détails sur l'API, reportez-vous AddTagsToOnPremisesInstances
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserbatch-get-application-revisions.
- AWS CLI
-
Pour extraire des informations sur les révisions des applications
L'
batch-get-application-revisionsexemple suivant récupère les informations relatives à la révision spécifiée stockée dans un GitHub référentiel.aws deploy batch-get-application-revisions \ --application-namemy-codedeploy-application\ --revisions "[{\"gitHubLocation\": {\"commitId\": \"fa85936EXAMPLEa31736c051f10d77297EXAMPLE\",\"repository\": \"my-github-token/my-repository\"},\"revisionType\": \"GitHub\"}]"Sortie :
{ "revisions": [ { "genericRevisionInfo": { "description": "Application revision registered by Deployment ID: d-A1B2C3111", "lastUsedTime": 1556912355.884, "registerTime": 1556912355.884, "firstUsedTime": 1556912355.884, "deploymentGroups": [] }, "revisionLocation": { "revisionType": "GitHub", "gitHubLocation": { "commitId": "fa85936EXAMPLEa31736c051f10d77297EXAMPLE", "repository": "my-github-token/my-repository" } } } ], "applicationName": "my-codedeploy-application", "errorMessage": "" }Pour plus d’informations, consultez BatchGetApplicationRevisions dans la Référence d’API AWS CodeDeploy .
-
Pour plus de détails sur l'API, reportez-vous BatchGetApplicationRevisions
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserbatch-get-applications.
- AWS CLI
-
Pour obtenir les informations sur plusieurs applications
L'
batch-get-applicationsexemple suivant affiche des informations sur plusieurs applications associées au AWS compte de l'utilisateur.aws deploy batch-get-applications --application-namesWordPress_AppMyOther_AppSortie :
{ "applicationsInfo": [ { "applicationName": "WordPress_App", "applicationId": "d9dd6993-f171-44fa-a811-211e4EXAMPLE", "createTime": 1407878168.078, "linkedToGitHub": false }, { "applicationName": "MyOther_App", "applicationId": "8ca57519-31da-42b2-9194-8bb16EXAMPLE", "createTime": 1407453571.63, "linkedToGitHub": false } ] }-
Pour plus de détails sur l'API, reportez-vous BatchGetApplications
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserbatch-get-deployment-groups.
- AWS CLI
-
Pour extraire des informations sur un ou plusieurs groupes de déploiement
L'
batch-get-deployment-groupsexemple suivant extrait des informations sur deux des groupes de déploiement associés à l' CodeDeploy application spécifiée.aws deploy batch-get-deployment-groups \ --application-namemy-codedeploy-application\ --deployment-group-names "[\"my-deployment-group-1\",\"my-deployment-group-2\"]"Sortie :
{ "deploymentGroupsInfo": [ { "deploymentStyle": { "deploymentOption": "WITHOUT_TRAFFIC_CONTROL", "deploymentType": "IN_PLACE" }, "autoRollbackConfiguration": { "enabled": false }, "onPremisesTagSet": { "onPremisesTagSetList": [] }, "serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeployServiceRole", "lastAttemptedDeployment": { "endTime": 1556912366.415, "status": "Failed", "createTime": 1556912355.884, "deploymentId": "d-A1B2C3111" }, "autoScalingGroups": [], "deploymentGroupName": "my-deployment-group-1", "ec2TagSet": { "ec2TagSetList": [ [ { "Type": "KEY_AND_VALUE", "Value": "my-EC2-instance", "Key": "Name" } ] ] }, "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111example", "triggerConfigurations": [], "applicationName": "my-codedeploy-application", "computePlatform": "Server", "deploymentConfigName": "CodeDeployDefault.AllAtOnce" }, { "deploymentStyle": { "deploymentOption": "WITHOUT_TRAFFIC_CONTROL", "deploymentType": "IN_PLACE" }, "autoRollbackConfiguration": { "enabled": false }, "onPremisesTagSet": { "onPremisesTagSetList": [] }, "serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeployServiceRole", "autoScalingGroups": [], "deploymentGroupName": "my-deployment-group-2", "ec2TagSet": { "ec2TagSetList": [ [ { "Type": "KEY_AND_VALUE", "Value": "my-EC2-instance", "Key": "Name" } ] ] }, "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-22222example", "triggerConfigurations": [], "applicationName": "my-codedeploy-application", "computePlatform": "Server", "deploymentConfigName": "CodeDeployDefault.AllAtOnce" } ], "errorMessage": "" }Pour plus d’informations, consultez BatchGetDeploymentGroups dans la Référence d’API AWS CodeDeploy .
-
Pour plus de détails sur l'API, reportez-vous BatchGetDeploymentGroups
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserbatch-get-deployment-targets.
- AWS CLI
-
Pour extraire les cibles associées à un déploiement
L’exemple
batch-get-deployment-targetssuivant renvoie des informations sur l’une des cibles associées au déploiement spécifié.aws deploy batch-get-deployment-targets \ --deployment-id"d-1A2B3C4D5"\ --target-ids"i-01a2b3c4d5e6f1111"Sortie :
{ "deploymentTargets": [ { "deploymentTargetType": "InstanceTarget", "instanceTarget": { "lifecycleEvents": [ { "startTime": 1556918592.162, "lifecycleEventName": "ApplicationStop", "status": "Succeeded", "endTime": 1556918592.247, "diagnostics": { "scriptName": "", "errorCode": "Success", "logTail": "", "message": "Succeeded" } }, { "startTime": 1556918593.193, "lifecycleEventName": "DownloadBundle", "status": "Succeeded", "endTime": 1556918593.981, "diagnostics": { "scriptName": "", "errorCode": "Success", "logTail": "", "message": "Succeeded" } }, { "startTime": 1556918594.805, "lifecycleEventName": "BeforeInstall", "status": "Succeeded", "endTime": 1556918681.807, "diagnostics": { "scriptName": "", "errorCode": "Success", "logTail": "", "message": "Succeeded" } } ], "targetArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-01a2b3c4d5e6f1111", "deploymentId": "d-1A2B3C4D5", "lastUpdatedAt": 1556918687.504, "targetId": "i-01a2b3c4d5e6f1111", "status": "Succeeded" } } ] }Pour plus d’informations, consultez BatchGetDeploymentTargets dans la Référence d’API AWS CodeDeploy .
-
Pour plus de détails sur l'API, reportez-vous BatchGetDeploymentTargets
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserbatch-get-deployments.
- AWS CLI
-
Pour obtenir des informations sur plusieurs déploiements
L'
batch-get-deploymentsexemple suivant affiche des informations sur plusieurs déploiements associés au AWS compte de l'utilisateur.aws deploy batch-get-deployments --deployment-idsd-A1B2C3111d-A1B2C3222Sortie :
{ "deploymentsInfo": [ { "applicationName": "WordPress_App", "status": "Failed", "deploymentOverview": { "Failed": 0, "InProgress": 0, "Skipped": 0, "Succeeded": 1, "Pending": 0 }, "deploymentConfigName": "CodeDeployDefault.OneAtATime", "creator": "user", "deploymentGroupName": "WordPress_DG", "revision": { "revisionType": "S3", "s3Location": { "bundleType": "zip", "version": "uTecLusEXAMPLEFXtfUcyfV8bEXAMPLE", "bucket": "amzn-s3-demo-bucket", "key": "WordPressApp.zip" } }, "deploymentId": "d-A1B2C3111", "createTime": 1408480721.9, "completeTime": 1408480741.822 }, { "applicationName": "MyOther_App", "status": "Failed", "deploymentOverview": { "Failed": 1, "InProgress": 0, "Skipped": 0, "Succeeded": 0, "Pending": 0 }, "deploymentConfigName": "CodeDeployDefault.OneAtATime", "creator": "user", "errorInformation": { "message": "Deployment failed: Constraint default violated: No hosts succeeded.", "code": "HEALTH_CONSTRAINTS" }, "deploymentGroupName": "MyOther_DG", "revision": { "revisionType": "S3", "s3Location": { "bundleType": "zip", "eTag": "\"dd56cfdEXAMPLE8e768f9d77fEXAMPLE\"", "bucket": "amzn-s3-demo-bucket", "key": "MyOtherApp.zip" } }, "deploymentId": "d-A1B2C3222", "createTime": 1409764576.589, "completeTime": 1409764596.101 } ] }-
Pour plus de détails sur l'API, reportez-vous BatchGetDeployments
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserbatch-get-on-premises-instances.
- AWS CLI
-
Pour obtenir des informations sur une ou plusieurs instances sur site
L’exemple
batch-get-on-premises-instancessuivant obtient des informations sur deux instances sur site.aws deploy batch-get-on-premises-instances --instance-namesAssetTag12010298EXAssetTag23121309EXSortie :
{ "instanceInfos": [ { "iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag12010298EX", "tags": [ { "Value": "CodeDeployDemo-OnPrem", "Key": "Name" } ], "instanceName": "AssetTag12010298EX", "registerTime": 1425579465.228, "instanceArn": "arn:aws:codedeploy:us-west-2:123456789012:instance/AssetTag12010298EX_4IwLNI2Alh" }, { "iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag23121309EX", "tags": [ { "Value": "CodeDeployDemo-OnPrem", "Key": "Name" } ], "instanceName": "AssetTag23121309EX", "registerTime": 1425595585.988, "instanceArn": "arn:aws:codedeploy:us-west-2:80398EXAMPLE:instance/AssetTag23121309EX_PomUy64Was" } ] }-
Pour plus de détails sur l'API, reportez-vous BatchGetOnPremisesInstances
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercontinue-deployment.
- AWS CLI
-
Pour commencer à rediriger du trafic sans attendre que le délai d’attente spécifié soit écoulé
L’exemple
continue-deploymentsuivant commence à rediriger le trafic des instances de l’environnement d’origine qui sont prêtes à commencer le transfert de leur trafic vers les instances de l’environnement de remplacement.aws deploy continue-deployment \ --deployment-id"d-A1B2C3111"\ --deployment-wait-type"READY_WAIT"Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez ContinueDeployment dans la Référence d’API AWS CodeDeploy .
-
Pour plus de détails sur l'API, reportez-vous ContinueDeployment
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-application.
- AWS CLI
-
Pour créer une application
L'
create-applicationexemple suivant crée une application et l'associe au AWS compte de l'utilisateur.aws deploy create-application --application-nameMyOther_AppSortie :
{ "applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" }-
Pour plus de détails sur l'API, reportez-vous CreateApplication
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-deployment-config.
- AWS CLI
-
Pour créer une configuration de déploiement personnalisée
L'
create-deployment-configexemple suivant crée une configuration de déploiement personnalisée et l'associe au AWS compte de l'utilisateur.aws deploy create-deployment-config \ --deployment-config-nameThreeQuartersHealthy\ --minimum-healthy-hoststype=FLEET_PERCENT,value=75Sortie :
{ "deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" }-
Pour plus de détails sur l'API, reportez-vous CreateDeploymentConfig
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-deployment-group.
- AWS CLI
-
Pour créer un groupe de déploiement
L'
create-deployment-groupexemple suivant crée un groupe de déploiement et l'associe à l'application spécifiée et au AWS compte de l'utilisateur.aws deploy create-deployment-group \ --application-nameWordPress_App\ --auto-scaling-groupsCodeDeployDemo-ASG\ --deployment-config-nameCodeDeployDefault.OneAtATime\ --deployment-group-nameWordPress_DG\ --ec2-tag-filtersKey=Name,Value=CodeDeployDemo,Type=KEY_AND_VALUE\ --service-role-arnarn:aws:iam::123456789012:role/CodeDeployDemoRoleSortie :
{ "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" }-
Pour plus de détails sur l'API, reportez-vous CreateDeploymentGroup
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-deployment.
- AWS CLI
-
Exemple 1 : pour créer un CodeDeploy déploiement à l'aide de la plateforme de EC2 calcul /on-premises
L'
create-deploymentexemple suivant crée un déploiement et l'associe au AWS compte de l'utilisateur.aws deploy create-deployment \ --application-nameWordPress_App\ --deployment-config-nameCodeDeployDefault.OneAtATime\ --deployment-group-nameWordPress_DG\ --description"My demo deployment"\ --s3-locationbucket=amzn-s3-demo-bucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zipSortie :
{ "deploymentId": "d-A1B2C3111" }Exemple 2 : pour créer un CodeDeploy déploiement à l'aide de la plateforme de calcul Amazon ECS
L’exemple
create-deploymentsuivant utilise les deux fichiers suivants pour déployer un service Amazon ECS.Contenu du fichier
create-deployment.json:{ "applicationName": "ecs-deployment", "deploymentGroupName": "ecs-deployment-dg", "revision": { "revisionType": "S3", "s3Location": { "bucket": "ecs-deployment-bucket", "key": "appspec.yaml", "bundleType": "YAML" } } }Ce fichier extrait à son tour le fichier
appspec.yamlsuivant dans un compartiment S3 appeléecs-deployment-bucket.version: 0.0 Resources: - TargetService: Type: AWS::ECS::Service Properties: TaskDefinition: "arn:aws:ecs:region:123456789012:task-definition/ecs-task-def:2" LoadBalancerInfo: ContainerName: "sample-app" ContainerPort: 80 PlatformVersion: "LATEST"Commande :
aws deploy create-deployment \ --cli-input-jsonfile://create-deployment.json\ --regionus-east-1Sortie :
{ "deploymentId": "d-1234ABCDE" }Pour plus d’informations, consultez CreateDeployment dans la Référence d’API AWS CodeDeploy .
-
Pour plus de détails sur l'API, reportez-vous CreateDeployment
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-application.
- AWS CLI
-
Pour supprimer une application
L'
delete-applicationexemple suivant supprime l'application spécifiée associée au AWS compte de l'utilisateur.aws deploy delete-application --application-nameWordPress_AppCette commande ne produit aucune sortie.
-
Pour plus de détails sur l'API, reportez-vous DeleteApplication
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-deployment-config.
- AWS CLI
-
Pour supprimer une configuration de déploiement
L'
delete-deployment-configexemple suivant supprime une configuration de déploiement personnalisée associée au AWS compte de l'utilisateur.aws deploy delete-deployment-config --deployment-config-nameThreeQuartersHealthyCette commande ne produit aucune sortie.
-
Pour plus de détails sur l'API, reportez-vous DeleteDeploymentConfig
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-deployment-group.
- AWS CLI
-
Pour supprimer un groupe de déploiement
L’exemple
delete-deployment-groupsuivant supprime un groupe de déploiement associé à l’application spécifiée.aws deploy delete-deployment-group \ --application-nameWordPress_App\ --deployment-group-nameWordPress_DGSortie :
{ "hooksNotCleanedUp": [] }-
Pour plus de détails sur l'API, reportez-vous DeleteDeploymentGroup
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-git-hub-account-token.
- AWS CLI
-
Pour supprimer une connexion à un GitHub compte
L'
delete-git-hub-account-tokenexemple suivant supprime la connexion du GitHub compte spécifié.aws deploy delete-git-hub-account-token --token-namemy-github-accountSortie :
{ "tokenName": "my-github-account" }Pour plus d’informations, consultez DeleteGitHubAccountToken dans la Référence d’API AWS CodeDeploy .
-
Pour plus de détails sur l'API, reportez-vous DeleteGitHubAccountToken
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserderegister-on-premises-instance.
- AWS CLI
-
Pour annuler l’inscription d’une instance sur site
L'
deregister-on-premises-instanceexemple suivant annule l'enregistrement d'une instance locale auprès de l'instance AWS CodeDeploy, mais il ne supprime pas l'utilisateur IAM associé à l'instance, et il ne dissocie pas les balises de l'instance sur site de AWS CodeDeploy l'instance. Il ne désinstalle pas non plus l' AWS CodeDeploy agent de l'instance ni ne supprime le fichier de configuration local de l'instance.aws deploy deregister-on-premises-instance --instance-nameAssetTag12010298EXCette commande ne produit aucune sortie.
-
Pour plus de détails sur l'API, reportez-vous DeregisterOnPremisesInstance
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserderegister.
- AWS CLI
-
Pour annuler l’inscription d’une instance sur site
L'
deregisterexemple suivant annule l'enregistrement d'une instance locale avec. AWS CodeDeploy Il ne supprime pas l’utilisateur IAM associé à l’instance. Il dissocie AWS CodeDeploy les balises locales de l'instance. Il ne désinstalle pas l' AWS CodeDeploy agent de l'instance et ne supprime pas le fichier de configuration local de l'instance.aws deploy deregister \ --instance-nameAssetTag12010298EX\ --no-delete-iam-user \ --regionus-west-2Sortie :
Retrieving on-premises instance information... DONE IamUserArn: arn:aws:iam::80398EXAMPLE:user/AWS/CodeDeploy/AssetTag12010298EX Tags: Key=Name,Value=CodeDeployDemo-OnPrem Removing tags from the on-premises instance... DONE Deregistering the on-premises instance... DONE Run the following command on the on-premises instance to uninstall the codedeploy-agent: aws deploy uninstall-
Pour plus de détails sur l’API, consultez Deregister
dans la Référence des commandes de l’AWS CLI .
-
L'exemple de code suivant montre comment utiliserget-application-revision.
- AWS CLI
-
Pour obtenir des informations sur la révision d’une application
L’exemple
get-application-revisionsuivant affiche des informations sur une révision d’application associée à l’application spécifiée.aws deploy get-application-revision \ --application-nameWordPress_App\ --s3-locationbucket=amzn-s3-demo-bucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zipSortie :
{ "applicationName": "WordPress_App", "revisionInfo": { "description": "Application revision registered by Deployment ID: d-A1B2C3111", "registerTime": 1411076520.009, "deploymentGroups": "WordPress_DG", "lastUsedTime": 1411076520.009, "firstUsedTime": 1411076520.009 }, "revision": { "revisionType": "S3", "s3Location": { "bundleType": "zip", "eTag": "dd56cfdEXAMPLE8e768f9d77fEXAMPLE", "bucket": "amzn-s3-demo-bucket", "key": "WordPressApp.zip" } } }-
Pour plus de détails sur l'API, reportez-vous GetApplicationRevision
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-application.
- AWS CLI
-
Pour obtenir les informations sur une application
L'
get-applicationexemple suivant affiche des informations sur une application associée au AWS compte de l'utilisateur.aws deploy get-application --application-nameWordPress_AppSortie :
{ "application": { "applicationName": "WordPress_App", "applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "createTime": 1407878168.078, "linkedToGitHub": false } }-
Pour plus de détails sur l'API, reportez-vous GetApplication
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-deployment-config.
- AWS CLI
-
Pour obtenir les informations sur une configuration de déploiement
L'
get-deployment-configexemple suivant affiche des informations sur une configuration de déploiement associée au AWS compte de l'utilisateur.aws deploy get-deployment-config --deployment-config-nameThreeQuartersHealthySortie :
{ "deploymentConfigInfo": { "deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "minimumHealthyHosts": { "type": "FLEET_PERCENT", "value": 75 }, "createTime": 1411081164.379, "deploymentConfigName": "ThreeQuartersHealthy" } }-
Pour plus de détails sur l'API, reportez-vous GetDeploymentConfig
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-deployment-group.
- AWS CLI
-
Pour afficher les informations sur un groupe de déploiement
L’exemple
get-deployment-groupsuivant affiche des informations sur un groupe de déploiement associé à l’application spécifiée.aws deploy get-deployment-group \ --application-nameWordPress_App\ --deployment-group-nameWordPress_DGSortie :
{ "deploymentGroupInfo": { "applicationName": "WordPress_App", "autoScalingGroups": [ "CodeDeployDemo-ASG" ], "deploymentConfigName": "CodeDeployDefault.OneAtATime", "ec2TagFilters": [ { "Type": "KEY_AND_VALUE", "Value": "CodeDeployDemo", "Key": "Name" } ], "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeployDemoRole", "deploymentGroupName": "WordPress_DG" } }-
Pour plus de détails sur l'API, reportez-vous GetDeploymentGroup
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-deployment-instance.
- AWS CLI
-
Pour obtenir les informations sur une instance de déploiement
L’exemple
get-deployment-instancesuivant affiche des informations sur une instance de déploiement associée au déploiement spécifié.aws deploy get-deployment-instance --deployment-idd-QA4G4F9EX--instance-idi-902e9fEXSortie :
{ "instanceSummary": { "instanceId": "arn:aws:ec2:us-east-1:80398EXAMPLE:instance/i-902e9fEX", "lifecycleEvents": [ { "status": "Succeeded", "endTime": 1408480726.569, "startTime": 1408480726.437, "lifecycleEventName": "ApplicationStop" }, { "status": "Succeeded", "endTime": 1408480728.016, "startTime": 1408480727.665, "lifecycleEventName": "DownloadBundle" }, { "status": "Succeeded", "endTime": 1408480729.744, "startTime": 1408480729.125, "lifecycleEventName": "BeforeInstall" }, { "status": "Succeeded", "endTime": 1408480730.979, "startTime": 1408480730.844, "lifecycleEventName": "Install" }, { "status": "Failed", "endTime": 1408480732.603, "startTime": 1408480732.1, "lifecycleEventName": "AfterInstall" }, { "status": "Skipped", "endTime": 1408480732.606, "lifecycleEventName": "ApplicationStart" }, { "status": "Skipped", "endTime": 1408480732.606, "lifecycleEventName": "ValidateService" } ], "deploymentId": "d-QA4G4F9EX", "lastUpdatedAt": 1408480733.152, "status": "Failed" } }-
Pour plus de détails sur l'API, reportez-vous GetDeploymentInstance
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-deployment-target.
- AWS CLI
-
Pour renvoyer des informations sur une cible de déploiement
L’exemple
get-deployment-targetsuivant renvoie des informations sur une cible de déploiement associée au déploiement spécifié.aws deploy get-deployment-target \ --deployment-id"d-A1B2C3111"\ --target-id"i-a1b2c3d4e5f611111"Sortie :
{ "deploymentTarget": { "deploymentTargetType": "InstanceTarget", "instanceTarget": { "lastUpdatedAt": 1556918687.504, "targetId": "i-a1b2c3d4e5f611111", "targetArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-a1b2c3d4e5f611111", "status": "Succeeded", "lifecycleEvents": [ { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "ApplicationStop", "startTime": 1556918592.162, "endTime": 1556918592.247 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "DownloadBundle", "startTime": 1556918593.193, "endTime": 1556918593.981 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "BeforeInstall", "startTime": 1556918594.805, "endTime": 1556918681.807 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "Install", "startTime": 1556918682.696, "endTime": 1556918683.005 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "AfterInstall", "startTime": 1556918684.135, "endTime": 1556918684.216 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "ApplicationStart", "startTime": 1556918685.211, "endTime": 1556918685.295 }, { "status": "Succeeded", "diagnostics": { "errorCode": "Success", "message": "Succeeded", "logTail": "", "scriptName": "" }, "lifecycleEventName": "ValidateService", "startTime": 1556918686.65, "endTime": 1556918686.747 } ], "deploymentId": "d-A1B2C3111" } } }Pour plus d’informations, consultez GetDeploymentTarget dans la Référence d’API AWS CodeDeploy .
-
Pour plus de détails sur l'API, reportez-vous GetDeploymentTarget
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-deployment.
- AWS CLI
-
Pour obtenir des informations sur un déploiement
L'
get-deploymentexemple suivant affiche des informations sur un déploiement associé au AWS compte de l'utilisateur.aws deploy get-deployment --deployment-idd-A1B2C3123Sortie :
{ "deploymentInfo": { "applicationName": "WordPress_App", "status": "Succeeded", "deploymentOverview": { "Failed": 0, "InProgress": 0, "Skipped": 0, "Succeeded": 1, "Pending": 0 }, "deploymentConfigName": "CodeDeployDefault.OneAtATime", "creator": "user", "description": "My WordPress app deployment", "revision": { "revisionType": "S3", "s3Location": { "bundleType": "zip", "eTag": "\"dd56cfdEXAMPLE8e768f9d77fEXAMPLE\"", "bucket": "amzn-s3-demo-bucket", "key": "WordPressApp.zip" } }, "deploymentId": "d-A1B2C3123", "deploymentGroupName": "WordPress_DG", "createTime": 1409764576.589, "completeTime": 1409764596.101, "ignoreApplicationStopFailures": false } }-
Pour plus de détails sur l'API, reportez-vous GetDeployment
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-on-premises-instance.
- AWS CLI
-
Pour obtenir les informations sur une instance sur site
L’exemple
get-on-premises-instancesuivant extrait des informations sur l’instance sur site spécifiée.aws deploy get-on-premises-instance --instance-nameAssetTag12010298EXSortie :
{ "instanceInfo": { "iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag12010298EX", "tags": [ { "Value": "CodeDeployDemo-OnPrem", "Key": "Name" } ], "instanceName": "AssetTag12010298EX", "registerTime": 1425579465.228, "instanceArn": "arn:aws:codedeploy:us-east-1:123456789012:instance/AssetTag12010298EX_4IwLNI2Alh" } }-
Pour plus de détails sur l'API, reportez-vous GetOnPremisesInstance
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserinstall.
- AWS CLI
-
Pour installer une instance sur site
L'
installexemple suivant copie le fichier de configuration sur site de l'emplacement spécifié sur l'instance vers l'emplacement sur l'instance où l' AWS CodeDeploy agent s'attend à le trouver. Il installe également l' AWS CodeDeploy agent sur l'instance. Il ne crée aucun utilisateur IAM, n'enregistre pas l'instance locale avec AWS CodeDeploy elle et n'associe aucune balise d'instance locale à AWS CodeDeploy l'instance.aws deploy install \ --override-config \ --config-file C:\temp\codedeploy.onpremises.yml \ --regionus-west-2\ --agent-installers3://aws-codedeploy-us-west-2/latest/codedeploy-agent.msiSortie :
Creating the on-premises instance configuration file... DONE Installing the AWS CodeDeploy Agent... DONE-
Pour plus de détails sur l’API, consultez Install
dans la Référence des commandes de l’AWS CLI .
-
L'exemple de code suivant montre comment utiliserlist-application-revisions.
- AWS CLI
-
Pour obtenir des informations sur les révisions d’une application
L’exemple
list-application-revisionssuivant affiche des informations sur toutes les révisions d’application associées à l’application spécifiée.aws deploy list-application-revisions \ --application-nameWordPress_App\ --s-3-bucketamzn-s3-demo-bucket\ --deployedexclude\ --s-3-key-prefixWordPress_\ --sort-bylastUsedTime\ --sort-orderdescendingSortie :
{ "revisions": [ { "revisionType": "S3", "s3Location": { "version": "uTecLusvCB_JqHFXtfUcyfV8bEXAMPLE", "bucket": "amzn-s3-demo-bucket", "key": "WordPress_App.zip", "bundleType": "zip" } }, { "revisionType": "S3", "s3Location": { "version": "tMk.UxgDpMEVb7V187ZM6wVAWEXAMPLE", "bucket": "amzn-s3-demo-bucket", "key": "WordPress_App_2-0.zip", "bundleType": "zip" } } ] }-
Pour plus de détails sur l'API, reportez-vous ListApplicationRevisions
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-applications.
- AWS CLI
-
Pour obtenir des informations sur des applications
L'
list-applicationsexemple suivant affiche des informations sur toutes les applications associées au AWS compte de l'utilisateur.aws deploy list-applicationsSortie :
{ "applications": [ "WordPress_App", "MyOther_App" ] }-
Pour plus de détails sur l'API, reportez-vous ListApplications
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-deployment-configs.
- AWS CLI
-
Pour obtenir les informations sur les configurations de déploiement
L'
list-deployment-configsexemple suivant affiche des informations sur toutes les configurations de déploiement associées au AWS compte de l'utilisateur.aws deploy list-deployment-configsSortie :
{ "deploymentConfigsList": [ "ThreeQuartersHealthy", "CodeDeployDefault.AllAtOnce", "CodeDeployDefault.HalfAtATime", "CodeDeployDefault.OneAtATime" ] }-
Pour plus de détails sur l'API, reportez-vous ListDeploymentConfigs
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-deployment-groups.
- AWS CLI
-
Pour obtenir des informations sur les groupes de déploiement
L’exemple
list-deployment-groupssuivant affiche des informations sur tous les groupes de déploiement associés à l’application spécifiée.aws deploy list-deployment-groups --application-nameWordPress_AppSortie :
{ "applicationName": "WordPress_App", "deploymentGroups": [ "WordPress_DG", "WordPress_Beta_DG" ] }-
Pour plus de détails sur l'API, reportez-vous ListDeploymentGroups
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-deployment-instances.
- AWS CLI
-
Pour obtenir des informations sur des instances de déploiement
L’exemple
list-deployment-instancessuivant affiche des informations sur toutes les instances de déploiement associées au déploiement spécifié.aws deploy list-deployment-instances \ --deployment-idd-A1B2C3111\ --instance-status-filterSucceededSortie :
{ "instancesList": [ "i-EXAMPLE11", "i-EXAMPLE22" ] }-
Pour plus de détails sur l'API, reportez-vous ListDeploymentInstances
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-deployment-targets.
- AWS CLI
-
Pour récupérer la liste IDs des cibles associées à un déploiement
L'
list-deployment-targetsexemple suivant extrait une liste de cibles IDs associées à des déploiements dont le statut est « Échec » ou « ». InProgressaws deploy list-deployment-targets \ --deployment-id"d-A1B2C3111"\ --target-filters "{\"TargetStatus\":[\"Failed\",\"InProgress\"]}"Sortie :
{ "targetIds": [ "i-0f1558aaf90e5f1f9" ] }Pour plus d’informations, consultez ListDeploymentTargets dans la Référence d’API AWS CodeDeploy .
-
Pour plus de détails sur l'API, reportez-vous ListDeploymentTargets
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-deployments.
- AWS CLI
-
Pour obtenir des informations sur des déploiements
L’exemple
list-deploymentssuivant affiche des informations sur tous les déploiements associés à l’application et au groupe de déploiement spécifiés.aws deploy list-deployments \ --application-nameWordPress_App\ --create-time-rangestart=2014-08-19T00:00:00,end=2014-08-20T00:00:00\ --deployment-group-nameWordPress_DG\ --include-only-statusesFailedSortie :
{ "deployments": [ "d-EXAMPLE11", "d-EXAMPLE22", "d-EXAMPLE33" ] }-
Pour plus de détails sur l'API, reportez-vous ListDeployments
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-git-hub-account-token-names.
- AWS CLI
-
Pour répertorie les noms des connexions enregistrées aux GitHub comptes
L'
list-git-hub-account-token-namesexemple suivant répertorie les noms des connexions enregistrées aux GitHub comptes de l' AWS utilisateur actuel.aws deploy list-git-hub-account-token-namesSortie :
{ "tokenNameList": [ "my-first-token", "my-second-token", "my-third-token" ] }Pour plus d’informations, consultez ListGitHubAccountTokenNames dans la Référence d’API AWS CodeDeploy .
-
Pour plus de détails sur l'API, reportez-vous ListGitHubAccountTokenNames
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-on-premises-instances.
- AWS CLI
-
Pour obtenir des informations sur une ou plusieurs instances sur site
L'
list-on-premises-instancesexemple suivant extrait une liste des noms d'instances locales disponibles pour les instances enregistrées dans l'instance AWS CodeDeploy et auxquelles est également associée la balise d'instance locale spécifiée. AWS CodeDeployaws deploy list-on-premises-instances \ --registration-statusRegistered\ --tag-filtersKey=Name,Value=CodeDeployDemo-OnPrem,Type=KEY_AND_VALUESortie :
{ "instanceNames": [ "AssetTag12010298EX" ] }-
Pour plus de détails sur l'API, reportez-vous ListOnPremisesInstances
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-tags-for-resource.
- AWS CLI
-
Pour répertorier les balises d’une ressource (application)
L'
list-tags-for-resourceexemple suivant répertorie les balises appliquées à une application nommée TestApp in CodeDeploy.aws deploy list-tags-for-resource \ --resource-arnarn:aws:codedeploy:us-west-2:111122223333:application:testAppSortie :
{ "Tags": [ { "Key": "Type", "Value": "testType" }, { "Key": "Name", "Value": "testName" } ] }Pour plus d'informations, consultez la section Marquage des instances pour les groupes de déploiement CodeDeploy dans le Guide de l'AWS CodeDeploy utilisateur.
-
Pour plus de détails sur l'API, reportez-vous ListTagsForResource
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserpush.
- AWS CLI
-
Pour regrouper et déployer une révision d'application AWS CodeDeploy compatible sur Amazon S3
L’exemple
pushsuivant regroupe et déploie une révision d’application sur Amazon S3, puis associe la révision de l’application à l’application spécifiée.aws deploy push \ --application-nameWordPress_App\ --description"This is my deployment"\ --ignore-hidden-files \ --s3-locations3://amzn-s3-demo-bucket/WordPressApp.zip\ --source/tmp/MyLocalDeploymentFolder/La sortie décrit comment utiliser la commande
create-deploymentpour créer un déploiement qui utilise la révision de l’application chargée.To deploy with this revision, run: aws deploy create-deployment --application-name WordPress_App --deployment-config-name <deployment-config-name> --deployment-group-name <deployment-group-name> --s3-location bucket=amzn-s3-demo-bucket,key=WordPressApp.zip,bundleType=zip,eTag="cecc9b8EXAMPLE50a6e71fdb88EXAMPLE",version=LFsJAUdEXAMPLEfvKtvi79L8EXAMPLE-
Pour plus de détails sur l’API, consultez Push
dans la Référence des commandes de l’AWS CLI .
-
L'exemple de code suivant montre comment utiliserregister-application-revision.
- AWS CLI
-
Pour enregistrer des informations sur une révision d’application déjà chargée
L'
register-application-revisionexemple suivant enregistre des informations sur une révision d'application déjà chargée et stockée dans Amazon S3 avec. AWS CodeDeployaws deploy register-application-revision \ --application-nameWordPress_App\ --description"Revised WordPress application"\ --s3-locationbucket=amzn-s3-demo-bucket,key=RevisedWordPressApp.zip,bundleType=zip,eTag=cecc9b8a08eac650a6e71fdb88EXAMPLECette commande ne produit aucune sortie.
-
Pour plus de détails sur l'API, reportez-vous RegisterApplicationRevision
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserregister-on-premises-instance.
- AWS CLI
-
Pour enregistrer une instance sur site
L'
register-on-premises-instanceexemple suivant enregistre une instance locale auprès AWS CodeDeploy de. Il ne crée pas l'utilisateur IAM spécifié et n'associe dans AWS CodeDeploy aucune instance locale des balises à l'instance enregistrée.aws deploy register-on-premises-instance \ --instance-nameAssetTag12010298EX\ --iam-user-arnarn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser-OnPremCette commande ne produit aucune sortie.
-
Pour plus de détails sur l'API, reportez-vous RegisterOnPremisesInstance
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserregister.
- AWS CLI
-
Pour enregistrer une instance sur site
L'
registerexemple suivant enregistre une instance locale auprès de l'instance enregistrée AWS CodeDeploy, AWS CodeDeploy l'associe à la balise d'instance locale spécifiée et crée un fichier de configuration local qui peut être copié sur l'instance. Il ne crée pas l'utilisateur IAM et n'installe pas l' AWS CodeDeploy agent sur l'instance.aws deploy register \ --instance-nameAssetTag12010298EX\ --iam-user-arnarn:aws:iam::80398EXAMPLE:user/CodeDeployUser-OnPrem\ --tagsKey=Name,Value=CodeDeployDemo-OnPrem\ --regionus-west-2Sortie :
Registering the on-premises instance... DONE Adding tags to the on-premises instance... DONE Copy the on-premises configuration file named codedeploy.onpremises.yml to the on-premises instance, and run the following command on the on-premises instance to install and configure the AWS CodeDeploy Agent: aws deploy install --config-file codedeploy.onpremises.yml-
Pour plus de détails sur l’API, consultez Register
dans la Référence des commandes de l’AWS CLI .
-
L'exemple de code suivant montre comment utiliserremove-tags-from-on-premises-instances.
- AWS CLI
-
Pour supprimer des balises d’une ou plusieurs instances sur site
L'
remove-tags-from-on-premises-instancesexemple suivant dissocie les balises locales spécifiées AWS CodeDeploy des instances locales. Il ne désenregistre pas les instances locales dans l'instance AWS CodeDeploy, ne désinstalle pas l' AWS CodeDeploy agent de l'instance, ne supprime pas le fichier de configuration sur site des instances, ni ne supprime les utilisateurs IAM associés aux instances.aws deploy remove-tags-from-on-premises-instances \ --instance-namesAssetTag12010298EXAssetTag23121309EX\ --tagsKey=Name,Value=CodeDeployDemo-OnPremCette commande ne produit aucune sortie.
-
Pour plus de détails sur l'API, reportez-vous RemoveTagsFromOnPremisesInstances
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserstop-deployment.
- AWS CLI
-
Pour tenter d’arrêter un déploiement
L'
stop-deploymentexemple suivant tente d'arrêter un déploiement en cours associé au AWS compte de l'utilisateur.aws deploy stop-deployment --deployment-id d-A1B2C3111
Sortie :
{ "status": "Succeeded", "statusMessage": "No more commands will be scheduled for execution in the deployment instances" }-
Pour plus de détails sur l'API, reportez-vous StopDeployment
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisertag-resource.
- AWS CLI
-
Pour baliser une ressource (application)
L'
tag-resourceexemple suivant ajoute deux balises avec les clés Name et Type, et les valeurs TestName et TestType à une application nommée TestApp in. CodeDeploy :aws deploy tag-resource \ --resource-arnarn:aws:codedeploy:us-west-2:111122223333:application:testApp\ --tagsKey=Name,Value=testNameKey=Type,Value=testTypeCette commande ne produit aucune sortie si elle réussit.
Pour plus d'informations, consultez la section Marquage des instances pour les groupes de déploiement CodeDeploy dans le Guide de l'AWS CodeDeploy utilisateur.
-
Pour plus de détails sur l'API, reportez-vous TagResource
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliseruninstall.
- AWS CLI
-
Pour désinstaller une instance sur site
L'
uninstallexemple suivant désinstalle l' AWS CodeDeploy agent de l'instance locale et supprime le fichier de configuration local de l'instance. Il ne désenregistre pas l'instance dans l'instance AWS CodeDeploy, ne dissocie aucune balise d'instance locale AWS CodeDeploy de l'instance, ni ne supprime l'utilisateur IAM associé à l'instance.aws deploy uninstallCette commande ne produit aucune sortie.
-
Pour plus de détails sur l’API, consultez Uninstall
dans la Référence des commandes de l’AWS CLI .
-
L'exemple de code suivant montre comment utiliseruntag-resource.
- AWS CLI
-
Pour supprimer des balises d’une ressource (application)
L'
untag-resourceexemple suivant supprime deux balises avec les clés Name et Type d'une application nommée TestApp in CodeDeploy.aws deploy untag-resource \ --resource-arnarn:aws:codedeploy:us-west-2:111122223333:application:testApp\ --tag-keysNameTypeCette commande ne produit aucune sortie si elle réussit.
Pour plus d'informations, consultez la section Marquage des instances pour les groupes de déploiement CodeDeploy dans le Guide de l'AWS CodeDeploy utilisateur.
-
Pour plus de détails sur l'API, reportez-vous UntagResource
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-application.
- AWS CLI
-
Pour modifier les informations d’une application
L'
update-applicationexemple suivant modifie le nom d'une application associée au AWS compte de l'utilisateur.aws deploy update-application \ --application-nameWordPress_App\ --new-application-nameMy_WordPress_AppCette commande ne produit aucune sortie.
-
Pour plus de détails sur l'API, reportez-vous UpdateApplication
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-deployment-group.
- AWS CLI
-
Pour modifier les informations d’un groupe de déploiement
L’exemple
update-deployment-groupsuivant modifie les paramètres d’un groupe de déploiement associé à l’application spécifiée.aws deploy update-deployment-group \ --application-nameWordPress_App\ --auto-scaling-groupsMy_CodeDeployDemo_ASG\ --current-deployment-group-nameWordPress_DG\ --deployment-config-nameCodeDeployDefault.AllAtOnce\ --ec2-tag-filtersKey=Name,Type=KEY_AND_VALUE,Value=My_CodeDeployDemo\ --new-deployment-group-nameMy_WordPress_DepGroup\ --service-role-arnarn:aws:iam::80398EXAMPLE:role/CodeDeployDemo-2Cette commande ne produit aucune sortie.
-
Pour plus de détails sur l'API, reportez-vous UpdateDeploymentGroup
à la section Référence des AWS CLI commandes.
-