CodeDeploy exemplos usando AWS CLI - AWS Exemplos de código do SDK
Ações

Há mais exemplos de AWS SDK disponíveis no repositório AWS Doc SDK Examples GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

CodeDeploy exemplos usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with CodeDeploy.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar add-tags-to-on-premises-instances.

AWS CLI

Para adicionar tags a uma ou mais instâncias on-premises

O add-tags-to-on-premises-instances exemplo a seguir associa AWS CodeDeploy a mesma tag de instância local a duas instâncias locais. Ele não registra as instâncias locais com AWS CodeDeploy.

aws deploy add-tags-to-on-premises-instances \
    --instance-names AssetTag12010298EX AssetTag23121309EX \
    --tags Key=Name,Value=CodeDeployDemo-OnPrem

Este comando não produz saída.

O código de exemplo a seguir mostra como usar batch-get-application-revisions.

AWS CLI

Para recuperar informações sobre revisões de aplicações

O batch-get-application-revisions exemplo a seguir recupera informações sobre a revisão especificada armazenada em um GitHub repositório.

aws deploy batch-get-application-revisions \
    --application-name my-codedeploy-application \
    --revisions "[{\"gitHubLocation\": {\"commitId\": \"fa85936EXAMPLEa31736c051f10d77297EXAMPLE\",\"repository\": \"my-github-token/my-repository\"},\"revisionType\": \"GitHub\"}]"

Saída:

{
    "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 obter mais informações, consulte BatchGetApplicationRevisions na Referência de APIs do AWS CodeDeploy .

O código de exemplo a seguir mostra como usar batch-get-applications.

AWS CLI

Para obter informações sobre várias aplicações

O batch-get-applications exemplo a seguir exibe informações sobre vários aplicativos associados à AWS conta do usuário.

aws deploy batch-get-applications --application-names WordPress_App MyOther_App

Saída:

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

O código de exemplo a seguir mostra como usar batch-get-deployment-groups.

AWS CLI

Para recuperar informações sobre um ou mais grupos de implantação

O batch-get-deployment-groups exemplo a seguir recupera informações sobre dois dos grupos de implantação associados ao CodeDeploy aplicativo especificado.

aws deploy batch-get-deployment-groups \
    --application-name my-codedeploy-application \
    --deployment-group-names "[\"my-deployment-group-1\",\"my-deployment-group-2\"]"

Saída:

{
    "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 obter mais informações, consulte BatchGetDeploymentGroups na Referência de APIs do AWS CodeDeploy .

O código de exemplo a seguir mostra como usar batch-get-deployment-targets.

AWS CLI

Para recuperar os destinos associados a uma implantação

O exemplo batch-get-deployment-targets a seguir retorna informações sobre um dos destinos associados à implantação especificada.

aws deploy batch-get-deployment-targets \
    --deployment-id "d-1A2B3C4D5" \
    --target-ids "i-01a2b3c4d5e6f1111"

Saída:

{
    "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 obter mais informações, consulte BatchGetDeploymentTargets na Referência de APIs do AWS CodeDeploy .

O código de exemplo a seguir mostra como usar batch-get-deployments.

AWS CLI

Para obter informações sobre várias implantações

O batch-get-deployments exemplo a seguir exibe informações sobre várias implantações associadas à AWS conta do usuário.

aws deploy batch-get-deployments --deployment-ids d-A1B2C3111 d-A1B2C3222

Saída:

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

O código de exemplo a seguir mostra como usar batch-get-on-premises-instances.

AWS CLI

Para obter informações sobre uma ou mais instâncias on-premises

O exemplo batch-get-on-premises-instances a seguir obtém informações sobre duas instâncias on-premises.

aws deploy batch-get-on-premises-instances --instance-names AssetTag12010298EX AssetTag23121309EX

Saída:

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

O código de exemplo a seguir mostra como usar continue-deployment.

AWS CLI

Como começar a redirecionamento do tráfego sem esperar que ocorra um tempo de espera especificado.

O exemplo continue-deployment a seguir inicia o redirecionamento do tráfego de instâncias no ambiente original que estão prontas para começar a transferir tráfego para instâncias no ambiente de substituição.

aws deploy continue-deployment \
    --deployment-id "d-A1B2C3111" \
    --deployment-wait-type "READY_WAIT"

Este comando não produz saída.

Para obter mais informações, consulte ContinueDeployment na Referência de APIs do AWS CodeDeploy .

  • Para obter detalhes da API, consulte ContinueDeploymentem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-application.

AWS CLI

Para criar uma aplicação

O create-application exemplo a seguir cria um aplicativo e o associa à AWS conta do usuário.

aws deploy create-application --application-name MyOther_App

Saída:

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

  • Para obter detalhes da API, consulte CreateApplicationem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-deployment-config.

AWS CLI

Para criar uma configuração de implantação personalizada

O create-deployment-config exemplo a seguir cria uma configuração de implantação personalizada e a associa à AWS conta do usuário.

aws deploy create-deployment-config \
    --deployment-config-name ThreeQuartersHealthy \
    --minimum-healthy-hosts type=FLEET_PERCENT,value=75

Saída:

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

O código de exemplo a seguir mostra como usar create-deployment-group.

AWS CLI

Para criar um grupo de implantação

O create-deployment-group exemplo a seguir cria um grupo de implantação e o associa ao aplicativo especificado e à AWS conta do usuário.

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

Saída:

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

O código de exemplo a seguir mostra como usar create-deployment.

AWS CLI

Exemplo 1: Para criar uma CodeDeploy implantação usando a plataforma de computação EC2 /On-premises

O create-deployment exemplo a seguir cria uma implantação e a associa à AWS conta do usuário.

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

Saída:

{
    "deploymentId": "d-A1B2C3111"
}

Exemplo 2: Para criar uma CodeDeploy implantação usando a plataforma computacional Amazon ECS

O exemplo create-deployment a seguir usa os dois arquivos a seguir para implantar um serviço do Amazon ECS.

Conteúdo do arquivo create-deployment.json:

{
    "applicationName": "ecs-deployment",
    "deploymentGroupName": "ecs-deployment-dg",
    "revision": {
        "revisionType": "S3",
        "s3Location": {
            "bucket": "ecs-deployment-bucket",
            "key": "appspec.yaml",
            "bundleType": "YAML"
        }
    }
}

Esse arquivo, por sua vez, recupera o seguinte arquivo appspec.yaml de um bucket do S3 chamado 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

Saída:

{
    "deploymentId": "d-1234ABCDE"
}

Para obter mais informações, consulte CreateDeployment na Referência de APIs do AWS CodeDeploy .

  • Para obter detalhes da API, consulte CreateDeploymentem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-application.

AWS CLI

Como excluir uma aplicação

O delete-application exemplo a seguir exclui o aplicativo especificado que está associado à AWS conta do usuário.

aws deploy delete-application --application-name WordPress_App

Este comando não produz saída.

  • Para obter detalhes da API, consulte DeleteApplicationem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-deployment-config.

AWS CLI

Para excluir uma configuração de implantação

O delete-deployment-config exemplo a seguir exclui uma configuração de implantação personalizada associada à AWS conta do usuário.

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

Este comando não produz saída.

O código de exemplo a seguir mostra como usar delete-deployment-group.

AWS CLI

Para excluir um grupo de implantação

O exemplo delete-deployment-group a seguir exclui um grupo de implantação associado à aplicação especificada.

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

Saída:

{
    "hooksNotCleanedUp": []
}

O código de exemplo a seguir mostra como usar delete-git-hub-account-token.

AWS CLI

Para excluir uma conexão de GitHub conta

O delete-git-hub-account-token exemplo a seguir exclui a conexão da GitHub conta especificada.

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

Saída:

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

Para obter mais informações, consulte DeleteGitHubAccountToken na Referência de APIs do AWS CodeDeploy .

O código de exemplo a seguir mostra como usar deregister-on-premises-instance.

AWS CLI

Como cancelar o registro de uma instância on-premises

O deregister-on-premises-instance exemplo a seguir cancela o registro de uma instância local com AWS CodeDeploy, mas não exclui o usuário do IAM associado à instância nem se desassocia da instância nas tags AWS CodeDeploy da instância local. Ele também não desinstala o AWS CodeDeploy Agente da instância nem remove o arquivo de configuração local da instância.

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

Este comando não produz saída.

O código de exemplo a seguir mostra como usar deregister.

AWS CLI

Como cancelar o registro de uma instância on-premises

O deregister exemplo a seguir cancela o registro de uma instância local com. AWS CodeDeploy Ele não exclui o usuário do IAM que está associado à instância. Ele se dissocia AWS CodeDeploy das tags locais da instância. Ele não desinstala o AWS CodeDeploy Agente da instância nem remove o arquivo de configuração local da instância.

aws deploy deregister \
    --instance-name AssetTag12010298EX \
    --no-delete-iam-user \
    --region us-west-2

Saída:

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 ver detalhes da API, consulte Deregister na Referência de comandos da AWS CLI .

O código de exemplo a seguir mostra como usar get-application-revision.

AWS CLI

Para obter informações sobre uma revisão da aplicação

O exemplo get-application-revision a seguir exibe informações sobre uma revisão da aplicação associada à aplicação especificada.

aws deploy get-application-revision \
    --application-name WordPress_App \
    --s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip

Saída:

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

O código de exemplo a seguir mostra como usar get-application.

AWS CLI

Para obter informações sobre uma aplicação

O get-application exemplo a seguir exibe informações sobre um aplicativo associado à AWS conta do usuário.

aws deploy get-application --application-name WordPress_App

Saída:

{
    "application": {
        "applicationName": "WordPress_App",
        "applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "createTime": 1407878168.078,
        "linkedToGitHub": false
    }
}

  • Para obter detalhes da API, consulte GetApplicationem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-deployment-config.

AWS CLI

Para obter informações sobre uma configuração de implantação

O get-deployment-config exemplo a seguir exibe informações sobre uma configuração de implantação associada à AWS conta do usuário.

aws deploy get-deployment-config --deployment-config-name ThreeQuartersHealthy

Saída:

{
    "deploymentConfigInfo": {
        "deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "minimumHealthyHosts": {
            "type": "FLEET_PERCENT",
            "value": 75
        },
        "createTime": 1411081164.379,
        "deploymentConfigName": "ThreeQuartersHealthy"
    }
}

O código de exemplo a seguir mostra como usar get-deployment-group.

AWS CLI

Como visualizar informações sobre um grupo de implantação

O exemplo get-deployment-group a seguir exibe informações sobre um grupo de implantação associado à aplicação especificada.

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

Saída:

{
    "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 obter detalhes da API, consulte GetDeploymentGroupem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-deployment-instance.

AWS CLI

Para obter informações sobre uma instância de implantação

O exemplo get-deployment-instance a seguir exibe informações sobre uma instância de implantação associada à implantação especificada.

aws deploy get-deployment-instance --deployment-id d-QA4G4F9EX --instance-id i-902e9fEX

Saída:

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

O código de exemplo a seguir mostra como usar get-deployment-target.

AWS CLI

Como retornar informações sobre um destino de implantação

O exemplo get-deployment-target a seguir retorna informações sobre um destino de implantação associado à implantação especificada.

aws deploy get-deployment-target \
    --deployment-id "d-A1B2C3111" \
    --target-id "i-a1b2c3d4e5f611111"

Saída:

{
    "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 obter mais informações, consulte GetDeploymentTarget na Referência de APIs do AWS CodeDeploy .

O código de exemplo a seguir mostra como usar get-deployment.

AWS CLI

Para obter informações sobre uma implantação

O get-deployment exemplo a seguir exibe informações sobre uma implantação associada à AWS conta do usuário.

aws deploy get-deployment --deployment-id d-A1B2C3123

Saída:

{
    "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 obter detalhes da API, consulte GetDeploymentem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-on-premises-instance.

AWS CLI

Para obter informações sobre uma única instância on-premises

O exemplo get-on-premises-instance a seguir retorna as informações sobre uma instância on-premises especificada.

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

Saída:

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

O código de exemplo a seguir mostra como usar install.

AWS CLI

Como instalar uma instância on-premises

O install exemplo a seguir copia o arquivo de configuração local do local especificado na instância para o local na instância em que o AWS CodeDeploy agente espera encontrá-lo. Ele também instala o AWS CodeDeploy Agente na instância. Ele não cria nenhum usuário do IAM, nem registra a instância local nem associa nenhuma tag de instância local AWS CodeDeploy à instância. 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

Saída:

Creating the on-premises instance configuration file... DONE
Installing the AWS CodeDeploy Agent... DONE

  • Para ver detalhes da API, consulte Install na Referência de comandos da AWS CLI .

O código de exemplo a seguir mostra como usar list-application-revisions.

AWS CLI

Para obter informações sobre revisões da aplicação

O exemplo list-application-revisions a seguir exibe informações sobre todas as revisões da aplicação associadas à aplicação 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

Saída:

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

O código de exemplo a seguir mostra como usar list-applications.

AWS CLI

Para obter informações sobre aplicações

O list-applications exemplo a seguir exibe informações sobre todos os aplicativos associados à AWS conta do usuário.

aws deploy list-applications

Saída:

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

  • Para obter detalhes da API, consulte ListApplicationsem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-deployment-configs.

AWS CLI

Para obter informações sobre configurações de implantação

O list-deployment-configs exemplo a seguir exibe informações sobre todas as configurações de implantação associadas à AWS conta do usuário.

aws deploy list-deployment-configs

Saída:

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

O código de exemplo a seguir mostra como usar list-deployment-groups.

AWS CLI

Para obter informações sobre grupos de implantação

O exemplo list-deployment-groups a seguir exibe informações sobre todos os grupos de implantação associados à aplicação especificada.

aws deploy list-deployment-groups --application-name WordPress_App

Saída:

{
    "applicationName": "WordPress_App",
    "deploymentGroups": [
        "WordPress_DG",
        "WordPress_Beta_DG"
    ]
}

O código de exemplo a seguir mostra como usar list-deployment-instances.

AWS CLI

Para obter informações sobre instâncias de implantação

O exemplo list-deployment-instances a seguir exibe informações sobre todas as instâncias de implantação associadas à implantação especificada.

aws deploy list-deployment-instances \
    --deployment-id d-A1B2C3111 \
    --instance-status-filter Succeeded

Saída:

{
    "instancesList": [
        "i-EXAMPLE11",
        "i-EXAMPLE22"
    ]
}

O código de exemplo a seguir mostra como usar list-deployment-targets.

AWS CLI

Para recuperar uma lista de destinos associados IDs a uma implantação

O list-deployment-targets exemplo a seguir recupera uma lista de destinos IDs associados às implantações que têm o status “Falha” ou "InProgress”.

aws deploy list-deployment-targets \
    --deployment-id "d-A1B2C3111" \
    --target-filters "{\"TargetStatus\":[\"Failed\",\"InProgress\"]}"

Saída:

{
    "targetIds": [
        "i-0f1558aaf90e5f1f9"
    ]
}

Para obter mais informações, consulte ListDeploymentTargets na Referência de APIs do AWS CodeDeploy .

O código de exemplo a seguir mostra como usar list-deployments.

AWS CLI

Para obter informações sobre implantações

O exemplo list-deployments a seguir exibe informações sobre todas as implantações associadas à aplicação e ao grupo de implantação 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

Saída:

{
    "deployments": [
        "d-EXAMPLE11",
        "d-EXAMPLE22",
        "d-EXAMPLE33"
    ]
}

  • Para obter detalhes da API, consulte ListDeploymentsem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-git-hub-account-token-names.

AWS CLI

Para listar os nomes das conexões armazenadas com as GitHub contas

O list-git-hub-account-token-names exemplo a seguir lista os nomes das conexões armazenadas com as GitHub contas do AWS usuário atual.

aws deploy list-git-hub-account-token-names

Saída:

{
    "tokenNameList": [
        "my-first-token",
        "my-second-token",
        "my-third-token"
    ]
}

Para obter mais informações, consulte ListGitHubAccountTokenNames na Referência de APIs do AWS CodeDeploy .

O código de exemplo a seguir mostra como usar list-on-premises-instances.

AWS CLI

Para obter informações sobre uma ou mais instâncias on-premises

O list-on-premises-instances exemplo a seguir recupera uma lista de nomes de instâncias locais disponíveis para instâncias registradas AWS CodeDeploy e que também têm a tag de instância local especificada associada à instância. AWS CodeDeploy 

aws deploy list-on-premises-instances \
    --registration-status Registered \
    --tag-filters Key=Name,Value=CodeDeployDemo-OnPrem,Type=KEY_AND_VALUE

Saída:

{
    "instanceNames": [
        "AssetTag12010298EX"
    ]
}

O código de exemplo a seguir mostra como usar list-tags-for-resource.

AWS CLI

Para listar tags para um recurso (aplicação)

O list-tags-for-resource exemplo a seguir lista as tags aplicadas a um aplicativo chamado TestApp em CodeDeploy.

aws deploy list-tags-for-resource \
    --resource-arn arn:aws:codedeploy:us-west-2:111122223333:application:testApp

Saída:

{
    "Tags": [
        {
            "Key": "Type",
            "Value": "testType"
        },
        {
            "Key": "Name",
            "Value": "testName"
        }
    ]
}

Para obter mais informações, consulte Como marcar instâncias para grupos de implantação CodeDeploy no Guia do AWS CodeDeploy usuário.

O código de exemplo a seguir mostra como usar push.

AWS CLI

Para agrupar e implantar uma revisão de aplicativo AWS CodeDeploy compatível no Amazon S3

O exemplo push a seguir empacota e implanta uma revisão da aplicação no Amazon S3 e, em seguida, associa a revisão da aplicação à aplicação 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/

A saída descreve como usar o comando create-deployment para criar uma implantação que usa a revisão da aplicação carregada.

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 ver detalhes da API, consulte Push na Referência de comandos da AWS CLI .

O código de exemplo a seguir mostra como usar register-application-revision.

AWS CLI

Para registrar informações sobre uma revisão de aplicação já carregada

O register-application-revision exemplo a seguir registra informações sobre uma revisão de aplicativo já carregada armazenada no Amazon S3 com. 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 não produz saída.

O código de exemplo a seguir mostra como usar register-on-premises-instance.

AWS CLI

Para registrar uma instância on-premises

O register-on-premises-instance exemplo a seguir registra uma instância local com. AWS CodeDeploy Ele não cria o usuário do IAM especificado nem associa tags à instância registrada em AWS CodeDeploy nenhuma instância local.

aws deploy register-on-premises-instance \
    --instance-name AssetTag12010298EX \
    --iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser-OnPrem

Este comando não produz saída.

O código de exemplo a seguir mostra como usar register.

AWS CLI

Para registrar uma instância on-premises

O register exemplo a seguir registra uma instância local com AWS CodeDeploy, AWS CodeDeploy associa na tag de instância local especificada à instância registrada e cria um arquivo de configuração local que pode ser copiado para a instância. Ele não cria o usuário do IAM nem instala o AWS CodeDeploy Agente na instância.

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

Saída:

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 ver detalhes da API, consulte Register na Referência de comandos da AWS CLI .

O código de exemplo a seguir mostra como usar remove-tags-from-on-premises-instances.

AWS CLI

Para remover tags de uma ou mais instâncias on-premises

O remove-tags-from-on-premises-instances exemplo a seguir dissocia as tags locais especificadas das instâncias locais. AWS CodeDeploy Ele não cancela o registro das instâncias locais AWS CodeDeploy, nem desinstala o AWS CodeDeploy Agente da instância, nem remove o arquivo de configuração local das instâncias, nem exclui os usuários do IAM associados às instâncias.

aws deploy remove-tags-from-on-premises-instances \
    --instance-names AssetTag12010298EX AssetTag23121309EX \
    --tags Key=Name,Value=CodeDeployDemo-OnPrem

Este comando não produz saída.

O código de exemplo a seguir mostra como usar stop-deployment.

AWS CLI

Como tentar interromper uma implantação

O stop-deployment exemplo a seguir tenta interromper uma implantação em andamento associada à AWS conta do usuário.

aws deploy stop-deployment --deployment-id d-A1B2C3111

Saída:

{
    "status": "Succeeded",
    "statusMessage": "No more commands will be scheduled for execution in the deployment instances"
}

  • Para obter detalhes da API, consulte StopDeploymentem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar tag-resource.

AWS CLI

Como marcar um recurso (aplicação)

O tag-resource exemplo a seguir adiciona duas tags com as chaves Name e Type e os valores TestName e TestType a um aplicativo chamado TestApp em. 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

Se for bem-sucedido, esse comando não gerará nenhum resultado.

Para obter mais informações, consulte Como marcar instâncias para grupos de implantação CodeDeploy no Guia do AWS CodeDeploy usuário.

  • Para obter detalhes da API, consulte TagResourceem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar uninstall.

AWS CLI

Como desinstalar uma instância on-premises

O uninstall exemplo a seguir desinstala o AWS CodeDeploy Agente da instância local e remove o arquivo de configuração local da instância. Ele não cancela o registro da instância AWS CodeDeploy, nem desassocia nenhuma tag de instância local AWS CodeDeploy da instância, nem exclui o usuário do IAM associado à instância.

aws deploy uninstall

Este comando não produz saída.

  • Para ver detalhes da API, consulte Uninstall na Referência de comandos da AWS CLI .

O código de exemplo a seguir mostra como usar untag-resource.

AWS CLI

Para remover tags de um recurso (aplicação)

O untag-resource exemplo a seguir remove duas tags com as chaves Name e Type de um aplicativo chamado TestApp em CodeDeploy.

aws deploy untag-resource \
    --resource-arn  arn:aws:codedeploy:us-west-2:111122223333:application:testApp \
    --tag-keys Name Type

Se for bem-sucedido, esse comando não gerará nenhum resultado.

Para obter mais informações, consulte Como marcar instâncias para grupos de implantação CodeDeploy no Guia do AWS CodeDeploy usuário.

  • Para obter detalhes da API, consulte UntagResourceem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-application.

AWS CLI

Para alterar os detalhes de uma aplicação

O update-application exemplo a seguir altera o nome de um aplicativo associado à AWS conta do usuário.

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

Este comando não produz saída.

  • Para obter detalhes da API, consulte UpdateApplicationem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-deployment-group.

AWS CLI

Para alterar as informações sobre um grupo de implantação

O exemplo update-deployment-group a seguir altera as configurações de um grupo de implantação associado à aplicação 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 não produz saída.