# Ejemplos de CodeDeploy que utilizan la AWS CLI
En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar situaciones comunes usando la AWS Command Line Interface con CodeDeploy.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `add-tags-to-on-premises-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-tags-to-on-premises-instances`.
**AWS CLI**
**Adición de etiquetas a instancias en las instalaciones**
En el siguiente ejemplo de `add-tags-to-on-premises-instances`, en AWS CodeDeploy se asocia la misma etiqueta de instancia en las instalaciones a dos instancias en las instalaciones. No se registran las instancias en las instalaciones con AWS CodeDeploy.
```
aws deploy add-tags-to-on-premises-instances \
--instance-names AssetTag12010298EX AssetTag23121309EX \
--tags Key=Name,Value=CodeDeployDemo-OnPrem
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [AddTagsToOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/add-tags-to-on-premises-instances.html) en la *Referencia de comandos de la AWS CLI*.
### `batch-get-application-revisions`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-application-revisions`.
**AWS CLI**
**Obtención de información sobre las revisiones de la aplicación**
En el siguiente ejemplo de `batch-get-application-revisions`, se obtiene información acerca de la revisión especificada almacenada en un repositorio de GitHub.
```
aws deploy batch-get-application-revisions \
--application-name my-codedeploy-application \
--revisions "[{\"gitHubLocation\": {\"commitId\": \"fa85936EXAMPLEa31736c051f10d77297EXAMPLE\",\"repository\": \"my-github-token/my-repository\"},\"revisionType\": \"GitHub\"}]"
```
Salida:
```
{
"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": ""
}
```
Para obtener más información, consulte [BatchGetApplicationRevisions](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetApplicationRevisions.html) en la *Referencia de la API de AWS CodeDeploy*.
+ Para obtener información sobre la API, consulte [BatchGetApplicationRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-application-revisions.html) en la *Referencia de comandos de la AWS CLI*.
### `batch-get-applications`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-applications`.
**AWS CLI**
**Obtención de información sobre varias aplicaciones**
En el siguiente ejemplo de `batch-get-applications`, se muestra información sobre varias aplicaciones asociadas a la cuenta de AWS del usuario.
```
aws deploy batch-get-applications --application-names WordPress_App MyOther_App
```
Salida:
```
{
"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
}
]
}
```
+ Para obtener información sobre la API, consulte [BatchGetApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-applications.html) en la *Referencia de comandos de la AWS CLI*.
### `batch-get-deployment-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-deployment-groups`.
**AWS CLI**
**Obtención de información sobre uno o varios grupos de implementación**
En el siguiente ejemplo de `batch-get-deployment-groups`, se obtiene información sobre dos de los grupos de implementación que están asociados a la aplicación CodeDeploy especificada.
```
aws deploy batch-get-deployment-groups \
--application-name my-codedeploy-application \
--deployment-group-names "[\"my-deployment-group-1\",\"my-deployment-group-2\"]"
```
Salida:
```
{
"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": ""
}
```
Para obtener más información, consulte [BatchGetDeploymentGroups](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetDeploymentGroups.html) en la *Referencia de la API de AWS CodeDeploy*.
+ Para obtener información sobre la API, consulte [BatchGetDeploymentGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployment-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `batch-get-deployment-targets`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-deployment-targets`.
**AWS CLI**
**Obtención de los objetivos asociados a una implementación**
En el siguiente ejemplo de `batch-get-deployment-targets`, se obtiene información sobre uno de los objetivos asociados a la implementación especificada.
```
aws deploy batch-get-deployment-targets \
--deployment-id "d-1A2B3C4D5" \
--target-ids "i-01a2b3c4d5e6f1111"
```
Salida:
```
{
"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"
}
}
]
}
```
Para obtener más información, consulte [BatchGetDeploymentTargets](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_BatchGetDeploymentTargets.html) en la *Referencia de la API de AWS CodeDeploy*.
+ Para obtener información sobre la API, consulte [BatchGetDeploymentTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployment-targets.html) en la *Referencia de comandos de la AWS CLI*.
### `batch-get-deployments`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-deployments`.
**AWS CLI**
**Obtención de información sobre varias implementaciones**
En el siguiente ejemplo de `batch-get-deployments`, se muestra información sobre varias implementaciones asociadas a la cuenta de AWS del usuario.
```
aws deploy batch-get-deployments --deployment-ids d-A1B2C3111 d-A1B2C3222
```
Salida:
```
{
"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
}
]
}
```
+ Para obtener información sobre la API, consulte [BatchGetDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-deployments.html) en la *Referencia de comandos de la AWS CLI*.
### `batch-get-on-premises-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-on-premises-instances`.
**AWS CLI**
**Obtención de información acerca de una o varias instancias en las instalaciones**
En el siguiente ejemplo de `batch-get-on-premises-instances`, se obtiene información acerca de dos instancias en las instalaciones.
```
aws deploy batch-get-on-premises-instances --instance-names AssetTag12010298EX AssetTag23121309EX
```
Salida:
```
{
"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"
}
]
}
```
+ Para obtener información sobre la API, consulte [BatchGetOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/batch-get-on-premises-instances.html) en la *Referencia de comandos de la AWS CLI*.
### `continue-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `continue-deployment`.
**AWS CLI**
**Inicio del enrutamiento del tráfico sin tener que esperar a que transcurra un tiempo de espera especificado**
En el siguiente ejemplo de `continue-deployment`, se comienza a enrutar el tráfico de las instancias en el entorno original que están listas para empezar a transferir el tráfico a instancias en el entorno de sustitución.
```
aws deploy continue-deployment \
--deployment-id "d-A1B2C3111" \
--deployment-wait-type "READY_WAIT"
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [ContinueDeployment](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ContinueDeployment.html) en la *Referencia de la API de AWS CodeDeploy*.
+ Para obtener detalles sobre la API, consulte [ContinueDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/continue-deployment.html) en la *Referencia de comandos de la AWS CLI*.
### `create-application`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-application`.
**AWS CLI**
**Para crear una aplicación**
En el siguiente ejemplo de `create-application`, se crea una aplicación y se asocia a la cuenta de AWS del usuario.
```
aws deploy create-application --application-name MyOther_App
```
Salida:
```
{
"applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
```
+ Para obtener información sobre la API, consulte [CreateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-application.html) en la *Referencia de comandos de la AWS CLI*.
### `create-deployment-config`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-deployment-config`.
**AWS CLI**
**Creación de una configuración de implementación personalizada**
En el siguiente ejemplo de `create-deployment-config`, se crea una configuración de implementación personalizada y se asocia a la cuenta de AWS del usuario.
```
aws deploy create-deployment-config \
--deployment-config-name ThreeQuartersHealthy \
--minimum-healthy-hosts type=FLEET_PERCENT,value=75
```
Salida:
```
{
"deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
```
+ Para obtener información sobre la API, consulte [CreateDeploymentConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment-config.html) en la *Referencia de comandos de la AWS CLI*.
### `create-deployment-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-deployment-group`.
**AWS CLI**
**Creación de un grupo de implementación**
En el siguiente ejemplo de `create-deployment-group`, se crea un grupo de implementación y se asocia a la aplicación especificada de la cuenta de AWS del usuario.
```
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
```
Salida:
```
{
"deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
```
+ Para obtener información sobre la API, consulte [CreateDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-deployment`.
**AWS CLI**
**Ejemplo 1: cómo crear una implementación de CodeDeploy con la plataforma de informática de EC2/en las instalaciones**
En el siguiente ejemplo de `create-deployment`, se crea una implementación y se asocia a la cuenta de AWS del usuario.
```
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
```
Salida:
```
{
"deploymentId": "d-A1B2C3111"
}
```
**Ejemplo 2: cómo crear una implementación de CodeDeploy con la plataforma de informática de Amazon EC**
En el siguiente ejemplo de `create-deployment`, se utilizan los dos archivos siguientes para implementar un servicio de Amazon ECS.
Contenido del archivo `create-deployment.json`:
```
{
"applicationName": "ecs-deployment",
"deploymentGroupName": "ecs-deployment-dg",
"revision": {
"revisionType": "S3",
"s3Location": {
"bucket": "ecs-deployment-bucket",
"key": "appspec.yaml",
"bundleType": "YAML"
}
}
}
```
Ese archivo, a su vez, obtiene el siguiente archivo `appspec.yaml` de un bucket de S3 denominado `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"
```
Comando:
```
aws deploy create-deployment \
--cli-input-json file://create-deployment.json \
--region us-east-1
```
Salida:
```
{
"deploymentId": "d-1234ABCDE"
}
```
Para obtener más información, consulte [CreateDeployment](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html) en la *Referencia de la API de AWS CodeDeploy*.
+ Para obtener información sobre la API, consulte [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/create-deployment.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-application`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-application`.
**AWS CLI**
**Para eliminar una aplicación de**
En el siguiente `delete-application` ejemplo, se elimina la aplicación especificada que está asociada a la cuenta de AWS del usuario.
```
aws deploy delete-application --application-name WordPress_App
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [DeleteApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-application.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-deployment-config`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-deployment-config`.
**AWS CLI**
**Eliminación de una configuración de implementación**
En el siguiente ejemplo de `delete-deployment-config`, se elimina una configuración de implementación personalizada que está asociada a la cuenta de AWS del usuario.
```
aws deploy delete-deployment-config --deployment-config-name ThreeQuartersHealthy
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [DeleteDeploymentConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-deployment-config.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-deployment-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-deployment-group`.
**AWS CLI**
**Eliminación de un grupo de implementación**
En el siguiente ejemplo de `delete-deployment-group`, se elimina un grupo de implementación que está asociado a la aplicación especificada.
```
aws deploy delete-deployment-group \
--application-name WordPress_App \
--deployment-group-name WordPress_DG
```
Salida:
```
{
"hooksNotCleanedUp": []
}
```
+ Para obtener información sobre la API, consulte [DeleteDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-deployment-group.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-git-hub-account-token`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-git-hub-account-token`.
**AWS CLI**
**Eliminación de una conexión de cuenta de GitHub**
En el siguiente ejemplo de `delete-git-hub-account-token`, se elimina la conexión de la cuenta de GitHub especificada.
```
aws deploy delete-git-hub-account-token --token-name my-github-account
```
Salida:
```
{
"tokenName": "my-github-account"
}
```
Para obtener más información, consulte [DeleteGitHubAccountToken](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_DeleteGitHubAccountToken.html) en la *Referencia de la API de AWS CodeDeploy*.
+ Para obtener información sobre la API, consulte [DeleteGitHubAccountToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/delete-git-hub-account-token.html) en la *Referencia de comandos de la AWS CLI*.
### `deregister-on-premises-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `deregister-on-premises-instance`.
**AWS CLI**
**Anulación del registro de una instancia en las instalaciones**
En el siguiente ejemplo de `deregister-on-premises-instance`, se anula el registro de una instancia en las instalaciones con AWS CodeDeploy, pero no se elimina el usuario de IAM asociado a la instancia ni se desasocian de la instancia en AWS CodeDeploy las etiquetas de la instancia en las instalaciones. Tampoco se desinstala el agente de AWS CodeDeploy de la instancia ni se elimina el archivo de configuración en las instalaciones de la instancia.
```
aws deploy deregister-on-premises-instance --instance-name AssetTag12010298EX
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [DeregisterOnPremisesInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/deregister-on-premises-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `deregister`
En el siguiente ejemplo de código, se muestra cómo utilizar `deregister`.
**AWS CLI**
**Anulación del registro de una instancia en las instalaciones**
En el siguiente ejemplo de `deregister`, se anula el registro de la instancia en las instalaciones con AWS CodeDeploy. No se elimina el usuario de IAM que está asociado a la instancia. En AWS CodeDeploy, se desasocian de la instancia las etiquetas en las instalaciones. No se desinstala el agente de AWS CodeDeploy de la instancia ni se elimina el archivo de configuración en las instalaciones de la instancia.
```
aws deploy deregister \
--instance-name AssetTag12010298EX \
--no-delete-iam-user \
--region us-west-2
```
Salida:
```
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
```
+ Para obtener información sobre la API, consulte [Deregister](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/deregister.html) en la *Referencia de comandos de la AWS CLI*.
### `get-application-revision`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-application-revision`.
**AWS CLI**
**Obtención de información sobre una revisión de la aplicación**
En el siguiente ejemplo de `get-application-revision`, se muestra información sobre una revisión de la aplicación asociada a la aplicación especificada.
```
aws deploy get-application-revision \
--application-name WordPress_App \
--s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip
```
Salida:
```
{
"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"
}
}
}
```
+ Para obtener información sobre la API, consulte [GetApplicationRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-application-revision.html) en la *Referencia de comandos de la AWS CLI*.
### `get-application`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-application`.
**AWS CLI**
**Obtención de información sobre una aplicación**
En el siguiente ejemplo de `get-application`, se muestra información sobre una aplicación que está asociada a la cuenta de AWS del usuario.
```
aws deploy get-application --application-name WordPress_App
```
Salida:
```
{
"application": {
"applicationName": "WordPress_App",
"applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"createTime": 1407878168.078,
"linkedToGitHub": false
}
}
```
+ Para obtener más información sobre la API, consulte [GetApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-application.html) en la *Referencia de comandos de la AWS CLI*.
### `get-deployment-config`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-deployment-config`.
**AWS CLI**
**Obtención de información acerca de una configuración de implementación**
En el siguiente ejemplo de `get-deployment-config`, se muestra información sobre una configuración de implementación que está asociada a la cuenta de AWS del usuario.
```
aws deploy get-deployment-config --deployment-config-name ThreeQuartersHealthy
```
Salida:
```
{
"deploymentConfigInfo": {
"deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"minimumHealthyHosts": {
"type": "FLEET_PERCENT",
"value": 75
},
"createTime": 1411081164.379,
"deploymentConfigName": "ThreeQuartersHealthy"
}
}
```
+ Para obtener información sobre la API, consulte [GetDeploymentConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-config.html) en la *Referencia de comandos de la AWS CLI*.
### `get-deployment-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-deployment-group`.
**AWS CLI**
**Visualización de información acerca de un grupo de implementación**
En el siguiente ejemplo de `get-deployment-group`, se muestra información sobre un grupo de implementación que está asociado a la aplicación especificada.
```
aws deploy get-deployment-group \
--application-name WordPress_App \
--deployment-group-name WordPress_DG
```
Salida:
```
{
"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"
}
}
```
+ Para obtener información sobre la API, consulte [GetDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-group.html) en la *Referencia de comandos de la AWS CLI*.
### `get-deployment-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-deployment-instance`.
**AWS CLI**
**Obtención de información acerca de una instancia de implementación**
En el siguiente ejemplo de `get-deployment-instance`, se muestra información sobre una instancia de implementación que está asociada a la implementación especificada.
```
aws deploy get-deployment-instance --deployment-id d-QA4G4F9EX --instance-id i-902e9fEX
```
Salida:
```
{
"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"
}
}
```
+ Para obtener información sobre la API, consulte [GetDeploymentInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `get-deployment-target`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-deployment-target`.
**AWS CLI**
**Obtención de información sobre un destino de implementación**
En el siguiente ejemplo de `get-deployment-target`, se obtiene información sobre un destino de implementación que está asociado a la implementación especificada.
```
aws deploy get-deployment-target \
--deployment-id "d-A1B2C3111" \
--target-id "i-a1b2c3d4e5f611111"
```
Salida:
```
{
"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"
}
}
}
```
Para obtener más información, consulte [GetDeploymentTarget](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetDeploymentTarget.html) en la *Referencia de la API de AWS CodeDeploy*.
+ Para obtener información sobre la API, consulte [GetDeploymentTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment-target.html) en la *Referencia de comandos de la AWS CLI*.
### `get-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-deployment`.
**AWS CLI**
**Para obtener información acerca de una implementación**
En el siguiente ejemplo de `get-deployment`, se muestra información sobre una implementación que está asociada a la cuenta de AWS del usuario.
```
aws deploy get-deployment --deployment-id d-A1B2C3123
```
Salida:
```
{
"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
}
}
```
+ Para obtener información sobre la API, consulte [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-deployment.html) en la *Referencia de comandos de la AWS CLI*.
### `get-on-premises-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-on-premises-instance`.
**AWS CLI**
**Obtención de información sobre una instancia en las instalaciones**
En el siguiente ejemplo de `get-on-premises-instance`, se obtiene información sobre la instancia en las instalaciones especificada.
```
aws deploy get-on-premises-instance --instance-name AssetTag12010298EX
```
Salida:
```
{
"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"
}
}
```
+ Para obtener información sobre la API, consulte [GetOnPremisesInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/get-on-premises-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `install`
En el siguiente ejemplo de código, se muestra cómo utilizar `install`.
**AWS CLI**
**Instalación de una instancia en las instalaciones**
En el siguiente ejemplo de `install`, se copia el archivo de configuración en las instalaciones desde la ubicación especificada en la instancia a la ubicación donde el agente de AWS CodeDeploy espera encontrarlo. También se instala y ejecuta el agente de AWS CodeDeploy en la instancia. No se crea ningún usuario de IAM, ni se registra la instancia en las instalaciones con AWS CodeDeploy, ni tampoco se asocia ninguna etiqueta de instancia en las instalaciones en AWS CodeDeploy para la instancia.
```
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
```
Salida:
```
Creating the on-premises instance configuration file... DONE
Installing the AWS CodeDeploy Agent... DONE
```
+ Para obtener información sobre la API, consulte [Install](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/install.html) en la *Referencia de comandos de la AWS CLI*.
### `list-application-revisions`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-application-revisions`.
**AWS CLI**
**Obtención de información sobre las revisiones de la aplicación**
En el siguiente ejemplo de `list-application-revisions`, se muestra información sobre todas las revisiones de la aplicación que están asociadas a la aplicación especificada.
```
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
```
Salida:
```
{
"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"
}
}
]
}
```
+ Para obtener información sobre la API, consulte [ListApplicationRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-application-revisions.html) en la *Referencia de comandos de la AWS CLI*.
### `list-applications`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-applications`.
**AWS CLI**
**Obtención de información sobre las aplicaciones**
En el siguiente ejemplo de `list-applications`, se muestra información sobre todas las aplicaciones asociadas a la cuenta de AWS del usuario.
```
aws deploy list-applications
```
Salida:
```
{
"applications": [
"WordPress_App",
"MyOther_App"
]
}
```
+ Para obtener más información sobre la API, consulte [ListApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-applications.html) en la *Referencia de comandos de la AWS CLI*.
### `list-deployment-configs`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-deployment-configs`.
**AWS CLI**
**Obtención de información acerca de las configuraciones de implementación**
En el siguiente ejemplo de `list-deployment-configs`, se muestra información sobre todas las configuraciones de implementación que están asociadas a la cuenta de AWS del usuario.
```
aws deploy list-deployment-configs
```
Salida:
```
{
"deploymentConfigsList": [
"ThreeQuartersHealthy",
"CodeDeployDefault.AllAtOnce",
"CodeDeployDefault.HalfAtATime",
"CodeDeployDefault.OneAtATime"
]
}
```
+ Para obtener información sobre la API, consulte [ListDeploymentConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-configs.html) en la *Referencia de comandos de la AWS CLI*.
### `list-deployment-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-deployment-groups`.
**AWS CLI**
**Obtención de información acerca de los grupos de implementación**
En el siguiente ejemplo de `list-deployment-groups`, se muestra información sobre todos los grupos de implementación que están asociados a la aplicación especificada.
```
aws deploy list-deployment-groups --application-name WordPress_App
```
Salida:
```
{
"applicationName": "WordPress_App",
"deploymentGroups": [
"WordPress_DG",
"WordPress_Beta_DG"
]
}
```
+ Para obtener información sobre la API, consulte [ListDeploymentGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `list-deployment-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-deployment-instances`.
**AWS CLI**
**Obtención de información acerca de instancias de implementación**
En el siguiente ejemplo de `list-deployment-instances`, se muestra información sobre todas las instancias de implementación que están asociadas a la implementación especificada.
```
aws deploy list-deployment-instances \
--deployment-id d-A1B2C3111 \
--instance-status-filter Succeeded
```
Salida:
```
{
"instancesList": [
"i-EXAMPLE11",
"i-EXAMPLE22"
]
}
```
+ Para obtener información sobre la API, consulte [ListDeploymentInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-instances.html) en la *Referencia de comandos de la AWS CLI*.
### `list-deployment-targets`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-deployment-targets`.
**AWS CLI**
**Obtención de una lista de ID de destino asociados a una implementación**
En el siguiente ejemplo de `list-deployment-targets`, se obtiene una lista de los ID de destino asociados a las implementaciones que tienen el estado Failed o InProgress.
```
aws deploy list-deployment-targets \
--deployment-id "d-A1B2C3111" \
--target-filters "{\"TargetStatus\":[\"Failed\",\"InProgress\"]}"
```
Salida:
```
{
"targetIds": [
"i-0f1558aaf90e5f1f9"
]
}
```
Para obtener más información, consulte [ListDeploymentTargets](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListDeploymentTargets.html) en la *Referencia de la API de AWS CodeDeploy*.
+ Para obtener información sobre la API, consulte [ListDeploymentTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployment-targets.html) en la *Referencia de comandos de la AWS CLI*.
### `list-deployments`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-deployments`.
**AWS CLI**
**Obtención de información acerca de las implementaciones**
En el siguiente ejemplo de `list-deployments`, se muestra información sobre todas las implementaciones que están asociadas al grupo de implementación.
```
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
```
Salida:
```
{
"deployments": [
"d-EXAMPLE11",
"d-EXAMPLE22",
"d-EXAMPLE33"
]
}
```
+ Para obtener más información sobre la API, consulte [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-deployments.html) en *Referencia de comandos de la AWS CLI*.
### `list-git-hub-account-token-names`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-git-hub-account-token-names`.
**AWS CLI**
**Generación de una lista de nombres de las conexiones almacenadas en las cuentas de GitHub**
En el siguiente ejemplo de `list-git-hub-account-token-names`, se muestran los nombres de las conexiones almacenadas en las cuentas de GitHub del usuario de AWS actual.
```
aws deploy list-git-hub-account-token-names
```
Salida:
```
{
"tokenNameList": [
"my-first-token",
"my-second-token",
"my-third-token"
]
}
```
Para obtener más información, consulte [ListGitHubAccountTokenNames](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListGitHubAccountTokenNames.html) en la *Referencia de la API de AWS CodeDeploy*.
+ Para obtener información sobre la API, consulte [ListGitHubAccountTokenNames](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-git-hub-account-token-names.html) en la *Referencia de comandos de la AWS CLI*.
### `list-on-premises-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-on-premises-instances`.
**AWS CLI**
**Obtención de información acerca de una o varias instancias en las instalaciones**
En el siguiente ejemplo de `list-on-premises-instances`, se obtiene una lista de los nombres de instancias en las instalaciones que están disponibles para las instancias registradas en AWS CodeDeploy y que también tienen la etiqueta de instancia en las instalaciones especificada, asociada a la instancia en AWS CodeDeploy.
```
aws deploy list-on-premises-instances \
--registration-status Registered \
--tag-filters Key=Name,Value=CodeDeployDemo-OnPrem,Type=KEY_AND_VALUE
```
Salida:
```
{
"instanceNames": [
"AssetTag12010298EX"
]
}
```
+ Para obtener información sobre la API, consulte [ListOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-on-premises-instances.html) en la *Referencia de comandos de la AWS CLI*.
### `list-tags-for-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.
**AWS CLI**
**Para enumerar las etiquetas de un recurso (aplicación)**
En el siguiente ejemplo de `list-tags-for-resource`, se muestran las etiquetas aplicadas a una aplicación denominada testApp en CodeDeploy.
```
aws deploy list-tags-for-resource \
--resource-arn arn:aws:codedeploy:us-west-2:111122223333:application:testApp
```
Salida:
```
{
"Tags": [
{
"Key": "Type",
"Value": "testType"
},
{
"Key": "Name",
"Value": "testName"
}
]
}
```
Para obtener más información, consulte [Tagging instances for deployment groups in CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html) en la *Guía del usuario de AWS CodeDeploy*.
+ Para ver los detalles de la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/list-tags-for-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `push`
En el siguiente ejemplo de código, se muestra cómo utilizar `push`.
**AWS CLI**
**Agrupación e implementación de una revisión de aplicación compatible con AWS CodeDeploy en Amazon S3**
En el siguiente ejemplo de `push`, se agrupa e implementa una revisión de la aplicación en Amazon S3 y, a continuación, se asocia la revisión de la aplicación a la aplicación especificada.
```
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 salida describe cómo utilizar el comando `create-deployment` para crear una implementación que utilice la revisión de la aplicación cargada.
```
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
```
+ Para obtener información sobre la API, consulte [Push](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/push.html) en la *Referencia de comandos de la AWS CLI*.
### `register-application-revision`
En el siguiente ejemplo de código, se muestra cómo utilizar `register-application-revision`.
**AWS CLI**
**Registro de información sobre una revisión de aplicación ya cargada**
En el siguiente ejemplo de `register-application-revision`, se registra información sobre una revisión de aplicación ya cargada y almacenada en Amazon S3 con 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
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [RegisterApplicationRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register-application-revision.html) en la *Referencia de comandos de la AWS CLI*.
### `register-on-premises-instance`
En el siguiente ejemplo de código, se muestra cómo utilizar `register-on-premises-instance`.
**AWS CLI**
**Para registrar una instancia en las instalaciones**
En el siguiente ejemplo de `register-on-premises-instance`, se registra una instancia en las instalaciones con AWS CodeDeploy. No se crea el usuario de IAM especificado ni se asocia en AWS CodeDeploy ninguna etiqueta de instancia en las instalaciones a la instancia registrada.
```
aws deploy register-on-premises-instance \
--instance-name AssetTag12010298EX \
--iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser-OnPrem
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [RegisterOnPremisesInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register-on-premises-instance.html) en la *Referencia de comandos de la AWS CLI*.
### `register`
En el siguiente ejemplo de código, se muestra cómo utilizar `register`.
**AWS CLI**
**Para registrar una instancia en las instalaciones**
En el siguiente ejemplo de `register`, se registra una instancia en las instalaciones con AWS CodeDeploy, se asocia en AWS CodeDeploy la etiqueta de instancia en las instalaciones especificada a la instancia registrada y se crea un archivo de configuración en las instalaciones que se puede copiar en la instancia. No se crea el usuario de IAM ni se instala el agente de AWS CodeDeploy en la instancia.
```
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
```
Salida:
```
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
```
+ Para obtener información sobre la API, consulte [Register](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/register.html) en la *Referencia de comandos de la AWS CLI*.
### `remove-tags-from-on-premises-instances`
En el siguiente ejemplo de código, se muestra cómo utilizar `remove-tags-from-on-premises-instances`.
**AWS CLI**
**Eliminación de etiquetas de una o más instancias en las instalaciones**
En el siguiente ejemplo de `remove-tags-from-on-premises-instances`, se desasocian en AWS CodeDeploy las etiquetas en las instalaciones especificadas de las instancias en las instalaciones. No se anula el registro de las instancias en las instalaciones en AWS CodeDeploy, ni se desinstala el agente de AWS CodeDeploy de la instancia, ni tampoco se elimina el archivo de configuración en las instalaciones de las instancias ni los usuarios de IAM asociados a las instancias.
```
aws deploy remove-tags-from-on-premises-instances \
--instance-names AssetTag12010298EX AssetTag23121309EX \
--tags Key=Name,Value=CodeDeployDemo-OnPrem
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [RemoveTagsFromOnPremisesInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/remove-tags-from-on-premises-instances.html) en la *Referencia de comandos de la AWS CLI*.
### `stop-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `stop-deployment`.
**AWS CLI**
**Reintento de detener una implementación**
En el siguiente ejemplo de `stop-deployment`, se intenta detener una implementación en curso que está asociada a la cuenta de AWS del usuario.
aws deploy stop-deployment --deployment-id d-A1B2C3111
Salida:
```
{
"status": "Succeeded",
"statusMessage": "No more commands will be scheduled for execution in the deployment instances"
}
```
+ Para obtener información sobre la API, consulte [StopDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/stop-deployment.html) en la *Referencia de comandos de la AWS CLI*.
### `tag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `tag-resource`.
**AWS CLI**
**Etiquetado de un recurso (aplicación)**
En el siguiente ejemplo de `tag-resource`, se agregan dos etiquetas con las claves Name y Type y los valores testName y testType a una aplicación denominada testApp en 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
```
Si se ejecuta correctamente, este comando no genera ninguna salida.
Para obtener más información, consulte [Tagging instances for deployment groups in CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html) en la *Guía del usuario de AWS CodeDeploy*.
+ Para ver los detalles de la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/tag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `uninstall`
En el siguiente ejemplo de código, se muestra cómo utilizar `uninstall`.
**AWS CLI**
**Desinstalación de una instancia en las instalaciones**
En el siguiente ejemplo de `uninstall`, se desinstala el agente AWS CodeDeploy de la instancia en las instalaciones y se elimina el archivo de configuración en las instalaciones de la instancia. No se anula el registro de la instancia en AWS CodeDeploy, ni se desasocian de la instancia las etiquetas de la instancia en las instalaciones en AWS CodeDeploy, ni tampoco se elimina el usuario de IAM asociado a la instancia.
```
aws deploy uninstall
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [Uninstall](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/uninstall.html) en la *Referencia de comandos de la AWS CLI*.
### `untag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `untag-resource`.
**AWS CLI**
**Eliminación de etiquetas de un recurso (aplicación)**
En el siguiente ejemplo de `untag-resource`, se eliminan dos etiquetas con las claves Name y Type de una aplicación denominada testApp en CodeDeploy.
```
aws deploy untag-resource \
--resource-arn arn:aws:codedeploy:us-west-2:111122223333:application:testApp \
--tag-keys Name Type
```
Si se ejecuta correctamente, este comando no genera ninguna salida.
Para obtener más información, consulte [Tagging instances for deployment groups in CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-tagging.html) en la *Guía del usuario de AWS CodeDeploy*.
+ Para ver los detalles de la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/untag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `update-application`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-application`.
**AWS CLI**
**Cambio de los detalles de una aplicación**
En el siguiente `update-application` ejemplo, se cambia el nombre de una aplicación que está asociada a la cuenta de AWS del usuario.
```
aws deploy update-application \
--application-name WordPress_App \
--new-application-name My_WordPress_App
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [UpdateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/update-application.html) en la *Referencia de comandos de la AWS CLI*.
### `update-deployment-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-deployment-group`.
**AWS CLI**
**Cambio de la información acerca de un grupo de implementación**
En el siguiente ejemplo de `update-deployment-group`, se cambia la configuración de un grupo de implementación que está asociado a la aplicación especificada.
```
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
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [UpdateDeploymentGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/deploy/update-deployment-group.html) en la *Referencia de comandos de la AWS CLI*.