View a markdown version of this page

CodeDeploy ejemplos que utilizan AWS CLI - AWS Ejemplos de código de SDK
Acciones

Hay más ejemplos de AWS SDK disponibles en el repositorio de ejemplos de AWS Doc SDK. GitHub

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 de 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 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.

Acciones

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

El siguiente add-tags-to-on-premises-instances ejemplo asocia la misma etiqueta de instancia local AWS CodeDeploy 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.

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

El siguiente batch-get-application-revisions ejemplo recupera información sobre la revisión especificada almacenada en un repositorio. 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, consulta BatchGetApplicationRevisions en la AWS CodeDeploy Referencia de la API de .

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

El siguiente batch-get-applications ejemplo muestra información sobre varias aplicaciones asociadas a la cuenta del usuario. AWS 

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 más información sobre la API, consulte BatchGetApplications la sección de referencia de AWS CLI comandos.

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

El siguiente batch-get-deployment-groups ejemplo recupera información sobre dos de los grupos de implementación que están asociados a la aplicación especificada. CodeDeploy 

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, consulta BatchGetDeploymentGroups en la AWS CodeDeploy Referencia de la API de .

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, consulta BatchGetDeploymentTargets en la AWS CodeDeploy Referencia de la API de .

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

El siguiente batch-get-deployments ejemplo muestra información sobre varias implementaciones asociadas a la cuenta del usuario. AWS 

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 más información sobre la API, consulte la sección BatchGetDeployments de referencia de AWS CLI comandos.

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

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, consulta ContinueDeployment en la AWS CodeDeploy Referencia de la API de .

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

En el siguiente ejemplo de código, se muestra cómo utilizar create-application.

AWS CLI

Para crear una aplicación

El siguiente create-application ejemplo crea una aplicación y la asocia a la cuenta del AWS usuario.

aws deploy create-application --application-name MyOther_App

Salida:

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

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

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

El siguiente create-deployment-config ejemplo crea una configuración de implementación personalizada y la asocia a la cuenta del usuario. AWS 

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 más información sobre la API, consulte CreateDeploymentConfig la sección de referencia de AWS CLI comandos.

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

El siguiente create-deployment-group ejemplo crea un grupo de implementación y lo asocia a la aplicación especificada y a la cuenta del usuario. AWS 

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

En el siguiente ejemplo de código, se muestra cómo utilizar create-deployment.

AWS CLI

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

El siguiente create-deployment ejemplo crea una implementación y la asocia a la AWS cuenta 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: Para crear una CodeDeploy implementación con la plataforma informática Amazon ECS

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, consulta CreateDeployment en la AWS CodeDeploy Referencia de la API de .

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

En el siguiente ejemplo de código, se muestra cómo utilizar delete-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 cuenta del usuario. AWS 

aws deploy delete-application --application-name WordPress_App

Este comando no genera ninguna salida.

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

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

El siguiente delete-deployment-config ejemplo elimina una configuración de implementación personalizada que está asociada a la cuenta del usuario. AWS 

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

Este comando no genera ninguna salida.

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

En el siguiente ejemplo de código, se muestra cómo utilizar delete-git-hub-account-token.

AWS CLI

Para eliminar la conexión de una cuenta GitHub

El siguiente delete-git-hub-account-token ejemplo 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, consulta DeleteGitHubAccountToken en la AWS CodeDeploy Referencia de la API de .

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 deregister-on-premises-instance ejemplo, se cancela el registro de una instancia local con AWS CodeDeploy, pero no se elimina el usuario de IAM asociado a la instancia, ni se desvincula de la instancia en las etiquetas de instancia local. AWS CodeDeploy 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.

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 deregister ejemplo, se cancela el registro de una instancia local con. AWS CodeDeploy No se elimina el usuario de IAM que está asociado a la instancia. En las etiquetas locales, se AWS CodeDeploy desvincula 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 obtener información sobre la API, consulte Deregister en la Referencia de comandos de la AWS CLI .

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

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

El siguiente get-application ejemplo muestra información sobre una aplicación que está asociada a la cuenta del AWS 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 la sección de referencia de AWS CLI comandos.

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

El siguiente get-deployment-config ejemplo muestra información sobre una configuración de implementación asociada a la cuenta del usuario. AWS 

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

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

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

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, consulta GetDeploymentTarget en la AWS CodeDeploy Referencia de la API de .

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

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

El siguiente get-deployment ejemplo muestra información sobre una implementación asociada a la cuenta del AWS 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 más información sobre la API, consulte GetDeployment la Referencia de AWS CLI comandos.

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

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 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 usuario de IAM, no 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 obtener información sobre la API, consulte Install en la Referencia de comandos de la AWS CLI .

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

En el siguiente ejemplo de código, se muestra cómo utilizar list-applications.

AWS CLI

Obtención de información sobre las aplicaciones

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

aws deploy list-applications

Salida:

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

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

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

El siguiente list-deployment-configs ejemplo muestra información sobre todas las configuraciones de implementación asociadas a la cuenta del usuario. AWS 

aws deploy list-deployment-configs

Salida:

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

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 más información sobre la API, consulta la Referencia de comandos. ListDeploymentGroups AWS CLI

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

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 list-deployment-targets ejemplo, se recupera una lista de los ID de destino 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, consulta ListDeploymentTargets en la AWS CodeDeploy Referencia de la API de .

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 la Referencia de ListDeployments comandos AWS CLI .

En el siguiente ejemplo de código, se muestra cómo utilizar list-git-hub-account-token-names.

AWS CLI

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

El siguiente list-git-hub-account-token-names ejemplo muestra 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, consulta ListGitHubAccountTokenNames en la AWS CodeDeploy Referencia de la API de .

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 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 asociada a la instancia la etiqueta de instancia local especificada. 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"
    ]
}

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)

El siguiente list-tags-for-resource ejemplo muestra las etiquetas aplicadas a una aplicación llamada 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 obtener más información sobre la API, consulta la sección ListTagsForResource de referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar push.

AWS CLI

Para empaquetar e implementar una revisión de aplicación AWS CodeDeploy compatible 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-config-name> --deployment-group-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 en la Referencia de comandos de la AWS CLI .

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

El siguiente register-application-revision ejemplo 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.

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

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 register ejemplo, se registra una instancia local en AWS CodeDeploy, se asocia AWS CodeDeploy la etiqueta de instancia local especificada con la instancia registrada y se crea un archivo de configuración local que se puede copiar a la instancia. No crea el usuario de IAM 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 obtener información sobre la API, consulte Register en la Referencia de comandos de la AWS CLI .

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

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

En el siguiente ejemplo de código, se muestra cómo utilizar stop-deployment.

AWS CLI

Reintento de detener una implementación

El siguiente stop-deployment ejemplo intenta detener una implementación en curso asociada a la cuenta del usuario. AWS

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 más información sobre la API, consulte StopDeployment la referencia de AWS CLI comandos.

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 tag-resource ejemplo, se agregan dos etiquetas con las claves Nombre y Tipo y los valores TestName y 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 obtener más información sobre la API, consulta la sección TagResource de referencia de AWS CLI comandos.

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 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 desvincula ninguna etiqueta de instancia local de la instancia AWS CodeDeploy, ni elimina el usuario AWS CodeDeploy de IAM que está asociado a la instancia.

aws deploy uninstall

Este comando no genera ninguna salida.

  • Para obtener información sobre la API, consulte Uninstall en la Referencia de comandos de la AWS CLI .

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 untag-resource ejemplo, se eliminan dos etiquetas con las claves Nombre y Tipo de una aplicación llamada 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 obtener más información sobre la API, consulta la sección UntagResource de referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar update-application.

AWS CLI

Cambio de los detalles de una aplicación

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

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

Este comando no genera ninguna salida.

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

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.