CodeDeploy ejemplos que utilizan AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CodeDeploy ejemplos que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with 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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usarloadd-tags-to-on-premises-instances.

AWS CLI

Para añadir etiquetas a las instancias locales

En el siguiente add-tags-to-on-premises-instances ejemplo, se asocia AWS CodeDeploy la misma etiqueta de instancia local a dos instancias locales. No registra las instancias locales 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.

El siguiente ejemplo de código muestra cómo usarlobatch-get-application-revisions.

AWS CLI

Para recuperar información sobre las revisiones de la aplicación

El siguiente batch-get-application-revisions ejemplo recupera información sobre la revisión especificada almacenada en un GitHub repositorio.

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 BatchGetApplicationRevisionsla AWS CodeDeploy APIReferencia.

El siguiente ejemplo de código muestra cómo usarlobatch-get-applications.

AWS CLI

Para obtener información sobre varias aplicaciones

En el siguiente batch-get-applications ejemplo, se muestra información sobre varias aplicaciones asociadas a la AWS cuenta 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 API obtener más información, consulte BatchGetApplicationsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlobatch-get-deployment-groups.

AWS CLI

Para recuperar información sobre uno o más grupos de implementación

En el siguiente batch-get-deployment-groups ejemplo, se recupera información sobre dos de los grupos de implementación que están asociados a la CodeDeploy aplicación 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 BatchGetDeploymentGroupsla AWS CodeDeploy APIReferencia.

El siguiente ejemplo de código muestra cómo usarlobatch-get-deployment-targets.

AWS CLI

Para recuperar los objetivos asociados a una implementación

El siguiente batch-get-deployment-targets ejemplo devuelve 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 BatchGetDeploymentTargetsla AWS CodeDeploy APIReferencia.

El siguiente ejemplo de código muestra cómo usarlobatch-get-deployments.

AWS CLI

Para obtener información sobre varias implementaciones

En el siguiente batch-get-deployments ejemplo, se muestra información sobre varios despliegues que están asociados a la cuenta del AWS 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": "CodeDeployDemoBucket",
                "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": "CodeDeployDemoBucket",
                "key": "MyOtherApp.zip"
                }
            },
            "deploymentId": "d-A1B2C3222",
            "createTime": 1409764576.589,
            "completeTime": 1409764596.101
        }
    ]
}

  • Para API obtener más información, consulte BatchGetDeploymentsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlobatch-get-on-premises-instances.

AWS CLI

Para obtener información sobre una o más instancias locales

En el siguiente batch-get-on-premises-instances ejemplo, se obtiene información sobre dos instancias locales.

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"
        }
    ]
}

El siguiente ejemplo de código muestra cómo usarlocontinue-deployment.

AWS CLI

Para empezar a redirigir el tráfico sin esperar a que transcurra un tiempo de espera especificado.

El siguiente continue-deployment ejemplo comienza a redirigir el tráfico desde las instancias del entorno original que están listas para empezar a transferir el tráfico a las instancias del entorno de reemplazo.

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 ContinueDeploymentla AWS CodeDeploy APIReferencia.

  • Para API obtener más información, consulte ContinueDeploymentla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-application.

AWS CLI

Para crear una aplicación

En el siguiente create-application ejemplo, se crea una aplicación y se asocia a la AWS cuenta del usuario.

aws deploy create-application --application-name MyOther_App

Salida:

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

  • Para API obtener más información, consulte CreateApplicationla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-deployment-config.

AWS CLI

Para crear una configuración de despliegue personalizada

El siguiente create-deployment-config ejemplo crea una configuración de despliegue personalizada y la asocia a la AWS cuenta 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"
}

El siguiente ejemplo de código muestra cómo usarlocreate-deployment-group.

AWS CLI

Para crear un grupo de despliegue

En el siguiente create-deployment-group ejemplo, se crea un grupo de despliegue y se asocia a la aplicación especificada y a la AWS cuenta 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"
}

El siguiente ejemplo de código muestra cómo usarlocreate-deployment.

AWS CLI

Ejemplo 1: Para crear una CodeDeploy implementación mediante la plataforma informática EC2 /On-premise

En el siguiente create-deployment ejemplo, se crea una implementación y se asocia a la cuenta del AWS 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=CodeDeployDemoBucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip

Salida:

{
    "deploymentId": "d-A1B2C3111"
}

Ejemplo 2: Para crear una CodeDeploy implementación con la plataforma de ECS cómputo Amazon

En el siguiente create-deployment ejemplo, se utilizan los dos archivos siguientes para implementar un ECS servicio de Amazon.

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, recupera el siguiente archivo appspec.yaml de un bucket de S3 llamadoecs-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 CreateDeploymentla AWS CodeDeploy APIReferencia.

  • Para API obtener más información, consulte CreateDeploymentla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-application.

AWS CLI

Eliminación de una aplicación

En el siguiente delete-application ejemplo, se elimina la aplicación especificada que está asociada a la AWS cuenta del usuario.

aws deploy delete-application --application-name WordPress_App

Este comando no genera ninguna salida.

  • Para API obtener más información, consulte DeleteApplicationla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-deployment-config.

AWS CLI

Para eliminar una configuración de despliegue

En el siguiente delete-deployment-config ejemplo, se elimina una configuración de despliegue personalizada que está asociada a la AWS cuenta del usuario.

aws deploy delete-deployment-config --deployment-config-name ThreeQuartersHealthy

Este comando no genera ninguna salida.

El siguiente ejemplo de código muestra cómo usarlodelete-deployment-group.

AWS CLI

Para eliminar un grupo de despliegue

En el siguiente delete-deployment-group ejemplo, se elimina un grupo de despliegue que está asociado a la aplicación especificada.

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

Salida:

{
    "hooksNotCleanedUp": []
}

El siguiente ejemplo de código muestra cómo usarlodelete-git-hub-account-token.

AWS CLI

Para eliminar la conexión de una GitHub cuenta

En el siguiente delete-git-hub-account-token ejemplo, se elimina la conexión de la cuenta especificada GitHub .

aws deploy delete-git-hub-account-token --token-name my-github-account

Salida:

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

Para obtener más información, consulte DeleteGitHubAccountTokenla AWS CodeDeploy APIReferencia.

El siguiente ejemplo de código muestra cómo usarloderegister-on-premises-instance.

AWS CLI

Para anular el registro de una instancia local

En el siguiente deregister-on-premises-instance ejemplo, se anula el registro de una instancia local AWS CodeDeploy, pero no se elimina el IAM usuario asociado a la instancia ni se disocia de la instancia en las etiquetas de AWS CodeDeploy la instancia local. Tampoco desinstala el AWS CodeDeploy agente de la instancia ni elimina el archivo de configuración local de la instancia.

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

Este comando no genera ninguna salida.

El siguiente ejemplo de código muestra cómo usarloderegister.

AWS CLI

Para anular el registro de una instancia local

En el siguiente deregister ejemplo se anula el registro de una instancia local con. AWS CodeDeploy No elimina el IAM usuario asociado a la instancia. En las etiquetas locales, AWS CodeDeploy se disocia de la instancia. No desinstala el AWS CodeDeploy agente de la instancia ni elimina el archivo de configuración local 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 API obtener más información, consulte Anular el registro en AWS CLI la referencia de comandos.

El siguiente ejemplo de código muestra cómo usarlo. get-application-revision

AWS CLI

Para obtener información sobre la revisión de una aplicación

En el siguiente get-application-revision ejemplo, 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=CodeDeployDemoBucket,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": "CodeDeployDemoBucket",
            "key": "WordPressApp.zip"
        }
    }
}

El siguiente ejemplo de código muestra cómo usarloget-application.

AWS CLI

Para obtener información sobre una aplicación

En el siguiente get-application ejemplo, se muestra información sobre una aplicación asociada a la AWS cuenta 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 API obtener más información, consulte GetApplicationla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloget-deployment-config.

AWS CLI

Para obtener información sobre una configuración de despliegue

En el siguiente get-deployment-config ejemplo, se muestra información sobre una configuración de despliegue asociada a la AWS cuenta 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 API obtener más información, consulte GetDeploymentConfigla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloget-deployment-group.

AWS CLI

Para ver información sobre un grupo de despliegues

En el siguiente get-deployment-group ejemplo, se muestra información sobre un grupo de despliegues 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 API obtener más información, consulte GetDeploymentGroupla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloget-deployment-instance.

AWS CLI

Para obtener información sobre una instancia de despliegue

En el siguiente get-deployment-instance ejemplo, se muestra información sobre una instancia de despliegue 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"
    }
}

El siguiente ejemplo de código muestra cómo usarloget-deployment-target.

AWS CLI

Para devolver información sobre un objetivo de despliegue

El siguiente get-deployment-target ejemplo devuelve información sobre un objetivo de despliegue 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 GetDeploymentTargetla AWS CodeDeploy APIReferencia.

  • Para API obtener más información, consulte GetDeploymentTargetla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloget-deployment.

AWS CLI

Para obtener información sobre una implementación

En el siguiente get-deployment ejemplo, se muestra información sobre una implementación asociada a la AWS cuenta 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": "CodeDeployDemoBucket",
            "key": "WordPressApp.zip"
            }
        },
        "deploymentId": "d-A1B2C3123",
        "deploymentGroupName": "WordPress_DG",
        "createTime": 1409764576.589,
        "completeTime": 1409764596.101,
        "ignoreApplicationStopFailures": false
    }
}

  • Para API obtener más información, consulte GetDeploymentla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloget-on-premises-instance.

AWS CLI

Para obtener información sobre una instancia local

En el siguiente get-on-premises-instance ejemplo, se recupera información sobre la instancia local 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"
    }
}

El siguiente ejemplo de código muestra cómo usarloinstall.

AWS CLI

Para instalar una instancia local

En el siguiente install ejemplo, se copia el archivo de configuración local de la ubicación especificada de la instancia a la ubicación de la instancia en la que el AWS CodeDeploy agente espera encontrarlo. También instala el AWS CodeDeploy agente en la instancia. No crea ningún IAM usuario, ni registra la instancia local ni asocia ninguna etiqueta de instancia local a la AWS CodeDeploy instancia. AWS CodeDeploy

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 API obtener más información, consulta la referencia sobre la instalación en AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlolist-application-revisions.

AWS CLI

Para obtener información sobre las revisiones de la aplicación

En el siguiente list-application-revisions ejemplo, 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 CodeDeployDemoBucket \
    --deployed exclude \
    --s-3-key-prefix WordPress_ \
    --sort-by lastUsedTime \
    --sort-order descending

Salida:

{
    "revisions": [
        {
            "revisionType": "S3",
            "s3Location": {
                "version": "uTecLusvCB_JqHFXtfUcyfV8bEXAMPLE",
                "bucket": "CodeDeployDemoBucket",
                "key": "WordPress_App.zip",
                "bundleType": "zip"
            }
        },
        {
            "revisionType": "S3",
            "s3Location": {
                "version": "tMk.UxgDpMEVb7V187ZM6wVAWEXAMPLE",
                "bucket": "CodeDeployDemoBucket",
                "key": "WordPress_App_2-0.zip",
                "bundleType": "zip"
            }
        }
    ]
}

El siguiente ejemplo de código muestra cómo usarlolist-applications.

AWS CLI

Para obtener información sobre las aplicaciones

El siguiente list-applications ejemplo muestra información sobre todas las aplicaciones asociadas a la AWS cuenta del usuario.

aws deploy list-applications

Salida:

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

  • Para API obtener más información, consulte ListApplicationsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlolist-deployment-configs.

AWS CLI

Para obtener información sobre las configuraciones de despliegue

En el siguiente list-deployment-configs ejemplo, se muestra información sobre todas las configuraciones de despliegue asociadas a la AWS cuenta del usuario.

aws deploy list-deployment-configs

Salida:

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

El siguiente ejemplo de código muestra cómo usarlolist-deployment-groups.

AWS CLI

Para obtener información sobre los grupos de despliegue

En el siguiente list-deployment-groups ejemplo, se muestra información sobre todos los grupos de despliegue 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 API obtener más información, consulte ListDeploymentGroupsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlolist-deployment-instances.

AWS CLI

Para obtener información sobre las instancias de despliegue

En el siguiente list-deployment-instances ejemplo, se muestra información sobre todas las instancias de despliegue 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"
    ]
}

El siguiente ejemplo de código muestra cómo usarlolist-deployment-targets.

AWS CLI

Para recuperar una lista de IDs los objetivos asociados a una implementación

En el siguiente list-deployment-targets ejemplo, se recupera una lista de objetivos IDs asociados a las implementaciones que tienen el estado «Fallido» 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 ListDeploymentTargetsla AWS CodeDeploy API Referencia.

El siguiente ejemplo de código muestra cómo usarlolist-deployments.

AWS CLI

Para obtener información sobre las implementaciones

En el siguiente list-deployments ejemplo, se muestra información sobre todas las implementaciones asociadas a la aplicación y al grupo de implementaciones especificados.

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 API obtener más información, consulte ListDeploymentsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlolist-git-hub-account-token-names.

AWS CLI

Para enumerar los nombres de las conexiones almacenadas a GitHub las cuentas

En el siguiente list-git-hub-account-token-names ejemplo, se muestran los nombres de las conexiones almacenadas a GitHub las cuentas del AWS usuario 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 ListGitHubAccountTokenNamesla AWS CodeDeploy APIReferencia.

El siguiente ejemplo de código muestra cómo usarlolist-on-premises-instances.

AWS CLI

Para obtener información sobre una o más instancias locales

En el siguiente list-on-premises-instances ejemplo, se recupera una lista de los nombres de instancias locales disponibles para las instancias que están registradas AWS CodeDeploy y que también tienen la etiqueta de instancia local especificada asociada a la instancia. 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"
    ]
}

El siguiente ejemplo de código muestra cómo usarlolist-tags-for-resource.

AWS CLI

Para enumerar las etiquetas de un recurso (aplicación)

En el siguiente list-tags-for-resource ejemplo, se enumeran 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 Etiquetar instancias para grupos de implementación CodeDeploy en la Guía del AWS CodeDeploy usuario.

  • Para API obtener más información, consulte ListTagsForResourcela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlopush.

AWS CLI

Para empaquetar e implementar una revisión de aplicación AWS CodeDeploy compatible en Amazon S3

El siguiente push ejemplo agrupa e implementa una revisión de la aplicación en Amazon S3 y, a continuación, 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://CodeDeployDemoBucket/WordPressApp.zip \
    --source /tmp/MyLocalDeploymentFolder/

El resultado describe cómo utilizar el create-deployment comando 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-config-name> --deployment-group-name <deployment-group-name> --s3-location bucket=CodeDeployDemoBucket,key=WordPressApp.zip,bundleType=zip,eTag="cecc9b8EXAMPLE50a6e71fdb88EXAMPLE",version=LFsJAUdEXAMPLEfvKtvi79L8EXAMPLE

  • Para API obtener más información, consulte la referencia de AWS CLI comandos Push in.

El siguiente ejemplo de código muestra cómo usarloregister-application-revision.

AWS CLI

Para registrar información sobre una revisión de una aplicación ya cargada

El siguiente register-application-revision ejemplo registra información sobre una revisión de aplicación ya cargada almacenada en Amazon S3 con. AWS CodeDeploy

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

Este comando no genera ninguna salida.

El siguiente ejemplo de código muestra cómo usarloregister-on-premises-instance.

AWS CLI

Para registrar una instancia local

En el siguiente register-on-premises-instance ejemplo, se registra una instancia local con. AWS CodeDeploy No crea el IAM usuario especificado ni asocia en AWS CodeDeploy ninguna instancia local etiquetas 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.

El siguiente ejemplo de código muestra cómo usarloregister.

AWS CLI

Para registrar una instancia local

En el siguiente register ejemplo, se registra una instancia local AWS CodeDeploy, se asocia AWS CodeDeploy la etiqueta de instancia local especificada a la instancia registrada y se crea un archivo de configuración local que se puede copiar en la instancia. No crea el IAM usuario ni instala el AWS CodeDeploy agente 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 API obtener más información, consulte Registrar en la referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloremove-tags-from-on-premises-instances.

AWS CLI

Para eliminar etiquetas de una o más instancias locales

En el siguiente remove-tags-from-on-premises-instances ejemplo, se disocian las etiquetas locales especificadas AWS CodeDeploy de las instancias locales. No anula el registro de las instancias locales AWS CodeDeploy, ni desinstala el AWS CodeDeploy agente de la instancia, ni elimina el archivo de configuración local de las instancias, ni elimina los IAM usuarios que están 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.

El siguiente ejemplo de código muestra cómo usarlostop-deployment.

AWS CLI

Para intentar detener una implementación

El siguiente stop-deployment ejemplo intenta detener una implementación en curso que está asociada a la AWS cuenta 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 API obtener más información, consulte la Referencia StopDeploymentde comandos AWS CLI .

El siguiente ejemplo de código muestra cómo usarlotag-resource.

AWS CLI

Para etiquetar un recurso (aplicación)

En el siguiente tag-resource ejemplo, se agregan dos etiquetas con las claves Nombre y Tipo testName y valores testType a una aplicación denominada testApp in CodeDeploy. :

aws deploy tag-resource \
    --resource-arn  arn:aws:codedeploy:us-west-2:111122223333:application:testApp \
    --tags Key=Name,Value=testName Key=Type,Value=testType

Si se ejecuta correctamente, este comando no genera ninguna salida.

Para obtener más información, consulte Etiquetar instancias para grupos de implementación CodeDeploy en la Guía del AWS CodeDeploy usuario.

  • Para API obtener más información, consulte TagResourcela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlouninstall.

AWS CLI

Para desinstalar una instancia local

En el siguiente uninstall ejemplo, se desinstala el AWS CodeDeploy agente de la instancia local y se elimina el archivo de configuración local de la instancia. No anula el registro de la instancia ni desasocia ninguna etiqueta de instancia local de la instancia, ni AWS CodeDeploy elimina el usuario asociado a la IAM instancia. AWS CodeDeploy

aws deploy uninstall

Este comando no genera ninguna salida.

  • Para API obtener más información, consulta Desinstalar en la referencia de comandos.AWS CLI

El siguiente ejemplo de código muestra cómo usarlountag-resource.

AWS CLI

Para eliminar etiquetas de un recurso (aplicación)

En el siguiente untag-resource ejemplo, se eliminan dos etiquetas con las claves Nombre y Tipo de una aplicación denominada testApp in 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 Etiquetar instancias para grupos de implementación CodeDeploy en la Guía del AWS CodeDeploy usuario.

  • Para API obtener más información, consulte UntagResourcela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloupdate-application.

AWS CLI

Para cambiar los detalles de una aplicación

El siguiente update-application ejemplo cambia el nombre de una aplicación que está asociada a la AWS cuenta del usuario.

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

Este comando no genera ninguna salida.

  • Para API obtener más información, consulte UpdateApplicationla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloupdate-deployment-group.

AWS CLI

Para cambiar la información sobre un grupo de despliegues

En el siguiente update-deployment-group ejemplo, se cambia la configuración de un grupo de despliegue 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.