D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
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.
**Topics**
+ [Actions](#actions)
## Actions
### `add-tags-to-on-premises-instances`
L'exemple de code suivant montre comment utiliser`add-tags-to-on-premises-instances`.
**AWS CLI**
**Pour ajouter des balises à des instances sur site**
L'`add-tags-to-on-premises-instances`exemple 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 aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [AddTagsToOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/add-tags-to-on-premises-instances.html)à la section *Référence des AWS CLI commandes*.
### `batch-get-application-revisions`
L'exemple de code suivant montre comment utiliser`batch-get-application-revisions`.
**AWS CLI**
**Pour extraire des informations sur les révisions des applications**
L'`batch-get-application-revisions`exemple 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](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetApplicationRevisions.html) dans la *Référence d’API AWS CodeDeploy *.
+ Pour plus de détails sur l'API, reportez-vous [BatchGetApplicationRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-application-revisions.html)à la section *Référence des AWS CLI commandes*.
### `batch-get-applications`
L'exemple de code suivant montre comment utiliser`batch-get-applications`.
**AWS CLI**
**Pour obtenir les informations sur plusieurs applications**
L'`batch-get-applications`exemple 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 plus de détails sur l'API, reportez-vous [BatchGetApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-applications.html)à la section *Référence des AWS CLI commandes*.
### `batch-get-deployment-groups`
L'exemple de code suivant montre comment utiliser`batch-get-deployment-groups`.
**AWS CLI**
**Pour extraire des informations sur un ou plusieurs groupes de déploiement**
L'`batch-get-deployment-groups`exemple 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](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetDeploymentGroups.html) dans la *Référence d’API AWS CodeDeploy *.
+ Pour plus de détails sur l'API, reportez-vous [BatchGetDeploymentGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployment-groups.html)à la section *Référence des AWS CLI commandes*.
### `batch-get-deployment-targets`
L'exemple de code suivant montre comment utiliser`batch-get-deployment-targets`.
**AWS CLI**
**Pour extraire les cibles associées à un déploiement**
L’exemple `batch-get-deployment-targets` 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](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetDeploymentTargets.html) dans la *Référence d’API AWS CodeDeploy *.
+ Pour plus de détails sur l'API, reportez-vous [BatchGetDeploymentTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployment-targets.html)à la section *Référence des AWS CLI commandes*.
### `batch-get-deployments`
L'exemple de code suivant montre comment utiliser`batch-get-deployments`.
**AWS CLI**
**Pour obtenir des informations sur plusieurs déploiements**
L'`batch-get-deployments`exemple suivant affiche des informations sur plusieurs 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 plus de détails sur l'API, reportez-vous [BatchGetDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployments.html)à la section *Référence des AWS CLI commandes*.
### `batch-get-on-premises-instances`
L'exemple de code suivant montre comment utiliser`batch-get-on-premises-instances`.
**AWS CLI**
**Pour obtenir des informations sur une ou plusieurs instances sur site**
L’exemple `batch-get-on-premises-instances` suivant obtient des informations sur deux instances sur site.
```
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 plus de détails sur l'API, reportez-vous [BatchGetOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-on-premises-instances.html)à la section *Référence des AWS CLI commandes*.
### `continue-deployment`
L'exemple de code suivant montre comment utiliser`continue-deployment`.
**AWS CLI**
**Pour commencer à rediriger du trafic sans attendre que le délai d’attente spécifié soit écoulé**
L’exemple `continue-deployment` suivant 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](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ContinueDeployment.html) dans la *Référence d’API AWS CodeDeploy *.
+ Pour plus de détails sur l'API, reportez-vous [ContinueDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/continue-deployment.html)à la section *Référence des AWS CLI commandes*.
### `create-application`
L'exemple de code suivant montre comment utiliser`create-application`.
**AWS CLI**
**Pour créer une application**
L'`create-application`exemple 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 plus de détails sur l'API, reportez-vous [CreateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-application.html)à la section *Référence des AWS CLI commandes*.
### `create-deployment-config`
L'exemple de code suivant montre comment utiliser`create-deployment-config`.
**AWS CLI**
**Pour créer une configuration de déploiement personnalisée**
L'`create-deployment-config`exemple 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 plus de détails sur l'API, reportez-vous [CreateDeploymentConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment-config.html)à la section *Référence des AWS CLI commandes*.
### `create-deployment-group`
L'exemple de code suivant montre comment utiliser`create-deployment-group`.
**AWS CLI**
**Pour créer un groupe de déploiement**
L'`create-deployment-group`exemple 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"
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment-group.html)à la section *Référence des AWS CLI commandes*.
### `create-deployment`
L'exemple de code suivant montre comment utiliser`create-deployment`.
**AWS CLI**
**Exemple 1 : pour créer un CodeDeploy déploiement à l'aide de la plateforme de calcul EC2/on-premises**
L'`create-deployment`exemple 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’exemple `create-deployment` suivant 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.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](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html) dans la *Référence d’API AWS CodeDeploy *.
+ Pour plus de détails sur l'API, reportez-vous [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment.html)à la section *Référence des AWS CLI commandes*.
### `delete-application`
L'exemple de code suivant montre comment utiliser`delete-application`.
**AWS CLI**
**Pour supprimer une application**
L'`delete-application`exemple 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 aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeleteApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-application.html)à la section *Référence des AWS CLI commandes*.
### `delete-deployment-config`
L'exemple de code suivant montre comment utiliser`delete-deployment-config`.
**AWS CLI**
**Pour supprimer une configuration de déploiement**
L'`delete-deployment-config`exemple 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 aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeleteDeploymentConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-deployment-config.html)à la section *Référence des AWS CLI commandes*.
### `delete-deployment-group`
L'exemple de code suivant montre comment utiliser`delete-deployment-group`.
**AWS CLI**
**Pour supprimer un groupe de déploiement**
L’exemple `delete-deployment-group` 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 plus de détails sur l'API, reportez-vous [DeleteDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-deployment-group.html)à la section *Référence des AWS CLI commandes*.
### `delete-git-hub-account-token`
L'exemple de code suivant montre comment utiliser`delete-git-hub-account-token`.
**AWS CLI**
**Pour supprimer une connexion à un GitHub compte**
L'`delete-git-hub-account-token`exemple 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](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_DeleteGitHubAccountToken.html) dans la *Référence d’API AWS CodeDeploy *.
+ Pour plus de détails sur l'API, reportez-vous [DeleteGitHubAccountToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-git-hub-account-token.html)à la section *Référence des AWS CLI commandes*.
### `deregister-on-premises-instance`
L'exemple de code suivant montre comment utiliser`deregister-on-premises-instance`.
**AWS CLI**
**Pour annuler l’inscription d’une instance sur site**
L'`deregister-on-premises-instance`exemple 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 aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeregisterOnPremisesInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/deregister-on-premises-instance.html)à la section *Référence des AWS CLI commandes*.
### `deregister`
L'exemple de code suivant montre comment utiliser`deregister`.
**AWS CLI**
**Pour annuler l’inscription d’une instance sur site**
L'`deregister`exemple 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 plus de détails sur l’API, consultez [Deregister](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/deregister.html) dans la *Référence des commandes de l’AWS CLI *.
### `get-application-revision`
L'exemple de code suivant montre comment utiliser`get-application-revision`.
**AWS CLI**
**Pour obtenir des informations sur la révision d’une application**
L’exemple `get-application-revision` 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 plus de détails sur l'API, reportez-vous [GetApplicationRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-application-revision.html)à la section *Référence des AWS CLI commandes*.
### `get-application`
L'exemple de code suivant montre comment utiliser`get-application`.
**AWS CLI**
**Pour obtenir les informations sur une application**
L'`get-application`exemple 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 plus de détails sur l'API, reportez-vous [GetApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-application.html)à la section *Référence des AWS CLI commandes*.
### `get-deployment-config`
L'exemple de code suivant montre comment utiliser`get-deployment-config`.
**AWS CLI**
**Pour obtenir les informations sur une configuration de déploiement**
L'`get-deployment-config`exemple 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 plus de détails sur l'API, reportez-vous [GetDeploymentConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-config.html)à la section *Référence des AWS CLI commandes*.
### `get-deployment-group`
L'exemple de code suivant montre comment utiliser`get-deployment-group`.
**AWS CLI**
**Pour afficher les informations sur un groupe de déploiement**
L’exemple `get-deployment-group` 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 plus de détails sur l'API, reportez-vous [GetDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-group.html)à la section *Référence des AWS CLI commandes*.
### `get-deployment-instance`
L'exemple de code suivant montre comment utiliser`get-deployment-instance`.
**AWS CLI**
**Pour obtenir les informations sur une instance de déploiement**
L’exemple `get-deployment-instance` 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 plus de détails sur l'API, reportez-vous [GetDeploymentInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-instance.html)à la section *Référence des AWS CLI commandes*.
### `get-deployment-target`
L'exemple de code suivant montre comment utiliser`get-deployment-target`.
**AWS CLI**
**Pour renvoyer des informations sur une cible de déploiement**
L’exemple `get-deployment-target` 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](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetDeploymentTarget.html) dans la *Référence d’API AWS CodeDeploy *.
+ Pour plus de détails sur l'API, reportez-vous [GetDeploymentTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-target.html)à la section *Référence des AWS CLI commandes*.
### `get-deployment`
L'exemple de code suivant montre comment utiliser`get-deployment`.
**AWS CLI**
**Pour obtenir des informations sur un déploiement**
L'`get-deployment`exemple 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 plus de détails sur l'API, reportez-vous [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment.html)à la section *Référence des AWS CLI commandes*.
### `get-on-premises-instance`
L'exemple de code suivant montre comment utiliser`get-on-premises-instance`.
**AWS CLI**
**Pour obtenir les informations sur une instance sur site**
L’exemple `get-on-premises-instance` suivant extrait des informations sur l’instance sur site 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 plus de détails sur l'API, reportez-vous [GetOnPremisesInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-on-premises-instance.html)à la section *Référence des AWS CLI commandes*.
### `install`
L'exemple de code suivant montre comment utiliser`install`.
**AWS CLI**
**Pour installer une instance sur site**
L'`install`exemple 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 plus de détails sur l’API, consultez [Install](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/install.html) dans la *Référence des commandes de l’AWS CLI *.
### `list-application-revisions`
L'exemple de code suivant montre comment utiliser`list-application-revisions`.
**AWS CLI**
**Pour obtenir des informations sur les révisions d’une application**
L’exemple `list-application-revisions` suivant affiche des informations sur toutes les révisions d’application 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 plus de détails sur l'API, reportez-vous [ListApplicationRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-application-revisions.html)à la section *Référence des AWS CLI commandes*.
### `list-applications`
L'exemple de code suivant montre comment utiliser`list-applications`.
**AWS CLI**
**Pour obtenir des informations sur des applications**
L'`list-applications`exemple 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 plus de détails sur l'API, reportez-vous [ListApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-applications.html)à la section *Référence des AWS CLI commandes*.
### `list-deployment-configs`
L'exemple de code suivant montre comment utiliser`list-deployment-configs`.
**AWS CLI**
**Pour obtenir les informations sur les configurations de déploiement**
L'`list-deployment-configs`exemple 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 plus de détails sur l'API, reportez-vous [ListDeploymentConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-configs.html)à la section *Référence des AWS CLI commandes*.
### `list-deployment-groups`
L'exemple de code suivant montre comment utiliser`list-deployment-groups`.
**AWS CLI**
**Pour obtenir des informations sur les groupes de déploiement**
L’exemple `list-deployment-groups` 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 plus de détails sur l'API, reportez-vous [ListDeploymentGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-groups.html)à la section *Référence des AWS CLI commandes*.
### `list-deployment-instances`
L'exemple de code suivant montre comment utiliser`list-deployment-instances`.
**AWS CLI**
**Pour obtenir des informations sur des instances de déploiement**
L’exemple `list-deployment-instances` 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 plus de détails sur l'API, reportez-vous [ListDeploymentInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-instances.html)à la section *Référence des AWS CLI commandes*.
### `list-deployment-targets`
L'exemple de code suivant montre comment utiliser`list-deployment-targets`.
**AWS CLI**
**Pour récupérer la liste IDs des cibles associées à un déploiement**
L'`list-deployment-targets`exemple 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](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListDeploymentTargets.html) dans la *Référence d’API AWS CodeDeploy *.
+ Pour plus de détails sur l'API, reportez-vous [ListDeploymentTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-targets.html)à la section *Référence des AWS CLI commandes*.
### `list-deployments`
L'exemple de code suivant montre comment utiliser`list-deployments`.
**AWS CLI**
**Pour obtenir des informations sur des déploiements**
L’exemple `list-deployments` 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 plus de détails sur l'API, reportez-vous [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployments.html)à la section *Référence des AWS CLI commandes*.
### `list-git-hub-account-token-names`
L'exemple de code suivant montre comment utiliser`list-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-names`exemple 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](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListGitHubAccountTokenNames.html) dans la *Référence d’API AWS CodeDeploy *.
+ Pour plus de détails sur l'API, reportez-vous [ListGitHubAccountTokenNames](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-git-hub-account-token-names.html)à la section *Référence des AWS CLI commandes*.
### `list-on-premises-instances`
L'exemple de code suivant montre comment utiliser`list-on-premises-instances`.
**AWS CLI**
**Pour obtenir des informations sur une ou plusieurs instances sur site**
L'`list-on-premises-instances`exemple 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 plus de détails sur l'API, reportez-vous [ListOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-on-premises-instances.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
L'exemple de code suivant montre comment utiliser`list-tags-for-resource`.
**AWS CLI**
**Pour répertorier les balises d’une ressource (application)**
L'`list-tags-for-resource`exemple 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](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html) le *Guide de l'AWS CodeDeploy utilisateur*.
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `push`
L'exemple de code suivant montre comment utiliser`push`.
**AWS CLI**
**Pour regrouper et déployer une révision d'application AWS CodeDeploy compatible sur Amazon S3**
L’exemple `push` 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/
```
La sortie décrit comment utiliser la commande `create-deployment` pour 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-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/push.html) dans la *Référence des commandes de l’AWS CLI *.
### `register-application-revision`
L'exemple de code suivant montre comment utiliser`register-application-revision`.
**AWS CLI**
**Pour enregistrer des informations sur une révision d’application déjà chargée**
L'`register-application-revision`exemple 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 aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [RegisterApplicationRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register-application-revision.html)à la section *Référence des AWS CLI commandes*.
### `register-on-premises-instance`
L'exemple de code suivant montre comment utiliser`register-on-premises-instance`.
**AWS CLI**
**Pour enregistrer une instance sur site**
L'`register-on-premises-instance`exemple 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 aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [RegisterOnPremisesInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register-on-premises-instance.html)à la section *Référence des AWS CLI commandes*.
### `register`
L'exemple de code suivant montre comment utiliser`register`.
**AWS CLI**
**Pour enregistrer une instance sur site**
L'`register`exemple 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 plus de détails sur l’API, consultez [Register](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register.html) dans la *Référence des commandes de l’AWS CLI *.
### `remove-tags-from-on-premises-instances`
L'exemple de code suivant montre comment utiliser`remove-tags-from-on-premises-instances`.
**AWS CLI**
**Pour supprimer des balises d’une ou plusieurs instances sur site**
L'`remove-tags-from-on-premises-instances`exemple 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 aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [RemoveTagsFromOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/remove-tags-from-on-premises-instances.html)à la section *Référence des AWS CLI commandes*.
### `stop-deployment`
L'exemple de code suivant montre comment utiliser`stop-deployment`.
**AWS CLI**
**Pour tenter d’arrêter un déploiement**
L'`stop-deployment`exemple 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/stop-deployment.html)à la section *Référence des AWS CLI commandes*.
### `tag-resource`
L'exemple de code suivant montre comment utiliser`tag-resource`.
**AWS CLI**
**Pour étiqueter une ressource (application)**
L'`tag-resource`exemple 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
```
Cette 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](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html) le *Guide de l'AWS CodeDeploy utilisateur*.
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/tag-resource.html)à la section *Référence des AWS CLI commandes*.
### `uninstall`
L'exemple de code suivant montre comment utiliser`uninstall`.
**AWS CLI**
**Pour désinstaller une instance sur site**
L'`uninstall`exemple 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 aucune sortie.
+ Pour plus de détails sur l’API, consultez [Uninstall](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/uninstall.html) dans la *Référence des commandes de l’AWS CLI *.
### `untag-resource`
L'exemple de code suivant montre comment utiliser`untag-resource`.
**AWS CLI**
**Pour supprimer des balises d’une ressource (application)**
L'`untag-resource`exemple 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
```
Cette 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](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html) le *Guide de l'AWS CodeDeploy utilisateur*.
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/untag-resource.html)à la section *Référence des AWS CLI commandes*.
### `update-application`
L'exemple de code suivant montre comment utiliser`update-application`.
**AWS CLI**
**Pour modifier les informations d’une application**
L'`update-application`exemple 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 aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [UpdateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/update-application.html)à la section *Référence des AWS CLI commandes*.
### `update-deployment-group`
L'exemple de code suivant montre comment utiliser`update-deployment-group`.
**AWS CLI**
**Pour modifier les informations d’un groupe de déploiement**
L’exemple `update-deployment-group` 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 aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [UpdateDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/update-deployment-group.html)à la section *Référence des AWS CLI commandes*.