# 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*.