CodeDeploy exemples utilisant AWS CLI

Pour ajouter des balises aux instances locales

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 CodeDeploy

aws deploy add-tags-to-on-premises-instances \
    --instance-names AssetTag12010298EX AssetTag23121309EX \
    --tags Key=Name,Value=CodeDeployDemo-OnPrem

Cette commande ne produit aucun résultat.

Pour récupérer 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-name my-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 obtenir des 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-names WordPress_App MyOther_App

Sortie :

{
    "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 récupérer 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-name my-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 récupérer les cibles associées à un déploiement

L'batch-get-deployment-targetsexemple suivant 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 obtenir des informations sur les déploiements multiples

L'batch-get-deploymentsexemple suivant affiche des informations sur les multiples déploiements associés au AWS compte de l'utilisateur.

aws deploy batch-get-deployments --deployment-ids d-A1B2C3111 d-A1B2C3222

Sortie :

{
    "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 obtenir des informations sur une ou plusieurs instances locales

L'batch-get-on-premises-instancesexemple suivant permet d'obtenir des informations sur deux instances locales.

aws deploy batch-get-on-premises-instances --instance-names AssetTag12010298EX AssetTag23121309EX

Sortie :

{
    "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 commencer à réacheminer le trafic sans attendre l'expiration d'un délai d'attente spécifié.

L'continue-deploymentexemple suivant commence à rediriger le trafic depuis les instances de l'environnement d'origine qui sont prêtes à commencer à transférer le 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 aucun résultat.

Pour plus d’informations, consultez ContinueDeployment dans la Référence d’API AWS CodeDeploy .

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-name MyOther_App

Sortie :

{
    "applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}

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-name ThreeQuartersHealthy \
    --minimum-healthy-hosts type=FLEET_PERCENT,value=75

Sortie :

{
    "deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}

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-name WordPress_App \
    --auto-scaling-groups CodeDeployDemo-ASG \
    --deployment-config-name CodeDeployDefault.OneAtATime \
    --deployment-group-name WordPress_DG \
    --ec2-tag-filters Key=Name,Value=CodeDeployDemo,Type=KEY_AND_VALUE \
    --service-role-arn arn:aws:iam::123456789012:role/CodeDeployDemoRole

Sortie :

{
    "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}

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-name WordPress_App \
    --deployment-config-name CodeDeployDefault.OneAtATime \
    --deployment-group-name WordPress_DG \
    --description "My demo deployment" \
    --s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip

Sortie :

{
    "deploymentId": "d-A1B2C3111"
}

Exemple 2 : pour créer un CodeDeploy déploiement à l'aide de la plateforme de calcul Amazon ECS

L'create-deploymentexemple suivant utilise les deux fichiers suivants pour déployer un service Amazon ECS.

Contenu du create-deployment.json fichier :

{
    "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.yaml suivant 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-json file://create-deployment.json \
    --region us-east-1

Sortie :

{
    "deploymentId": "d-1234ABCDE"
}

Pour plus d’informations, consultez CreateDeployment dans la Référence d’API AWS CodeDeploy .

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-name WordPress_App

Cette commande ne produit aucun résultat.

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-name ThreeQuartersHealthy

Cette commande ne produit aucun résultat.

Pour supprimer un groupe de déploiement

L'delete-deployment-groupexemple suivant supprime un groupe de déploiement associé à l'application spécifiée.

aws deploy delete-deployment-group \
    --application-name WordPress_App \
    --deployment-group-name WordPress_DG

Sortie :

{
    "hooksNotCleanedUp": []
}

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-name my-github-account

Sortie :

{
    "tokenName": "my-github-account"
}

Pour plus d’informations, consultez DeleteGitHubAccountToken dans la Référence d’API AWS CodeDeploy .

Pour annuler l'enregistrement d'une instance locale

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-name AssetTag12010298EX

Cette commande ne produit aucun résultat.

Pour annuler l'enregistrement d'une instance locale

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-name AssetTag12010298EX \
    --no-delete-iam-user \
    --region us-west-2

Sortie :

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 obtenir des informations sur la révision d'une application

L'get-application-revisionexemple suivant affiche des informations sur une révision d'application associée à l'application spécifiée.

aws deploy get-application-revision \
    --application-name WordPress_App \
    --s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip

Sortie :

{
    "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 obtenir des 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-name WordPress_App

Sortie :

{
    "application": {
        "applicationName": "WordPress_App",
        "applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "createTime": 1407878168.078,
        "linkedToGitHub": false
    }
}

Pour obtenir des 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-name ThreeQuartersHealthy

Sortie :

{
    "deploymentConfigInfo": {
        "deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "minimumHealthyHosts": {
            "type": "FLEET_PERCENT",
            "value": 75
        },
        "createTime": 1411081164.379,
        "deploymentConfigName": "ThreeQuartersHealthy"
    }
}

Pour afficher les informations relatives à un groupe de déploiement

L'get-deployment-groupexemple suivant affiche des informations sur un groupe de déploiement associé à l'application spécifiée.

aws deploy get-deployment-group \
    --application-name WordPress_App \
    --deployment-group-name WordPress_DG

Sortie :

{
    "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 obtenir des informations sur une instance de déploiement

L'get-deployment-instanceexemple suivant affiche des informations sur une instance de déploiement associée au déploiement spécifié.

aws deploy get-deployment-instance --deployment-id d-QA4G4F9EX --instance-id i-902e9fEX

Sortie :

{
    "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 renvoyer des informations sur une cible de déploiement

L'get-deployment-targetexemple suivant 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 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-id d-A1B2C3123

Sortie :

{
    "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 obtenir des informations sur une instance locale

L'get-on-premises-instanceexemple suivant extrait des informations sur l'instance locale spécifiée.

aws deploy get-on-premises-instance --instance-name AssetTag12010298EX

Sortie :

{
    "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 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 \
    --region us-west-2 \
    --agent-installer s3://aws-codedeploy-us-west-2/latest/codedeploy-agent.msi

Sortie :

Creating the on-premises instance configuration file... DONE
Installing the AWS CodeDeploy Agent... DONE

Pour obtenir des informations sur les révisions des applications

L'list-application-revisionsexemple suivant affiche des informations sur toutes les révisions d'applications associées à l'application spécifiée.

aws deploy list-application-revisions \
    --application-name WordPress_App \
    --s-3-bucket amzn-s3-demo-bucket \
    --deployed exclude \
    --s-3-key-prefix WordPress_ \
    --sort-by lastUsedTime \
    --sort-order descending

Sortie :

{
    "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 obtenir des informations sur les applications

L'list-applicationsexemple suivant affiche des informations sur toutes les applications associées au AWS compte de l'utilisateur.

aws deploy list-applications

Sortie :

{
    "applications": [
        "WordPress_App",
        "MyOther_App"
    ]
}

Pour obtenir des 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-configs

Sortie :

{
    "deploymentConfigsList": [
        "ThreeQuartersHealthy",
        "CodeDeployDefault.AllAtOnce",
        "CodeDeployDefault.HalfAtATime",
        "CodeDeployDefault.OneAtATime"
    ]
}

Pour obtenir des informations sur les groupes de déploiement

L'list-deployment-groupsexemple suivant affiche des informations sur tous les groupes de déploiement associés à l'application spécifiée.

aws deploy list-deployment-groups --application-name WordPress_App

Sortie :

{
    "applicationName": "WordPress_App",
    "deploymentGroups": [
        "WordPress_DG",
        "WordPress_Beta_DG"
    ]
}

Pour obtenir des informations sur les instances de déploiement

L'list-deployment-instancesexemple suivant affiche des informations sur toutes les instances de déploiement associées au déploiement spécifié.

aws deploy list-deployment-instances \
    --deployment-id d-A1B2C3111 \
    --instance-status-filter Succeeded

Sortie :

{
    "instancesList": [
        "i-EXAMPLE11",
        "i-EXAMPLE22"
    ]
}

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 « ». InProgress

aws 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 obtenir des informations sur les déploiements

L'list-deploymentsexemple suivant 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-name WordPress_App \
    --create-time-range start=2014-08-19T00:00:00,end=2014-08-20T00:00:00 \
    --deployment-group-name WordPress_DG \
    --include-only-statuses Failed

Sortie :

{
    "deployments": [
        "d-EXAMPLE11",
        "d-EXAMPLE22",
        "d-EXAMPLE33"
    ]
}

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-names

Sortie :

{
    "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 obtenir des informations sur une ou plusieurs instances locales

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 CodeDeploy

aws deploy list-on-premises-instances \
    --registration-status Registered \
    --tag-filters Key=Name,Value=CodeDeployDemo-OnPrem,Type=KEY_AND_VALUE

Sortie :

{
    "instanceNames": [
        "AssetTag12010298EX"
    ]
}

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-arn arn:aws:codedeploy:us-west-2:111122223333:application:testApp

Sortie :

{
    "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 regrouper et déployer une révision d'application AWS CodeDeploy compatible sur Amazon S3

L'pushexemple suivant 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-name WordPress_App \
    --description "This is my deployment" \
    --ignore-hidden-files \
    --s3-location s3://amzn-s3-demo-bucket/WordPressApp.zip \
    --source /tmp/MyLocalDeploymentFolder/

Le résultat décrit comment utiliser la create-deployment commande pour créer un déploiement qui utilise la révision de l'application télé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 enregistrer les informations relatives à une révision d'application déjà télé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 CodeDeploy

aws deploy register-application-revision \
    --application-name WordPress_App \
    --description "Revised WordPress application" \
    --s3-location bucket=amzn-s3-demo-bucket,key=RevisedWordPressApp.zip,bundleType=zip,eTag=cecc9b8a08eac650a6e71fdb88EXAMPLE

Cette commande ne produit aucun résultat.

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-name AssetTag12010298EX \
    --iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser-OnPrem

Cette commande ne produit aucun résultat.

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-name AssetTag12010298EX \
    --iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployUser-OnPrem \
    --tags Key=Name,Value=CodeDeployDemo-OnPrem \
    --region us-west-2

Sortie :

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 supprimer des balises d'une ou de plusieurs instances locales

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-names AssetTag12010298EX AssetTag23121309EX \
    --tags Key=Name,Value=CodeDeployDemo-OnPrem

Cette commande ne produit aucun résultat.

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 étiqueter 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-arn  arn:aws:codedeploy:us-west-2:111122223333:application:testApp \
    --tags Key=Name,Value=testName Key=Type,Value=testType

En cas de succès, cette commande ne produit aucune sortie.

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 désinstaller une instance locale

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 uninstall

Cette commande ne produit aucun résultat.

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-arn  arn:aws:codedeploy:us-west-2:111122223333:application:testApp \
    --tag-keys Name Type

En cas de succès, cette commande ne produit aucune sortie.

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 modifier les détails d'une demande

L'update-applicationexemple suivant modifie le nom d'une application associée au AWS compte de l'utilisateur.

aws deploy update-application \
    --application-name WordPress_App \
    --new-application-name My_WordPress_App

Cette commande ne produit aucun résultat.

Pour modifier les informations relatives à un groupe de déploiement

L'update-deployment-groupexemple suivant modifie les paramètres d'un groupe de déploiement associé à l'application spécifiée.

aws deploy update-deployment-group \
    --application-name WordPress_App \
    --auto-scaling-groups My_CodeDeployDemo_ASG \
    --current-deployment-group-name WordPress_DG \
    --deployment-config-name CodeDeployDefault.AllAtOnce \
    --ec2-tag-filters Key=Name,Type=KEY_AND_VALUE,Value=My_CodeDeployDemo \
    --new-deployment-group-name My_WordPress_DepGroup \
    --service-role-arn arn:aws:iam::80398EXAMPLE:role/CodeDeployDemo-2

Cette commande ne produit aucun résultat.