get-deployment-target

Описание

Возвращает информацию о целевой точке развертывания.

См. также: Документацию API AWS

Синтаксис

  get-deployment-target
--deployment-id <value>
--target-id <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--deployment-id (строка)

Уникальный идентификатор развертывания.

--target-id (строка)

Уникальный идентификатор целевой точки развертывания.

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному в --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения перепишут значения, предоставленные JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. При отсутствии значения или значении input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, при предоставлении yaml-input будет выведен пример входного YAML, который можно использовать с --cli-input-yaml. При указании значения output выполняется валидация входных данных команды и возвращается пример выходного JSON для этой команды. Сгенерированный JSON-скелет нестабилен между версиями AWS CLI и не гарантируется обратная совместимость в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое значение)

Включить отладочную запись журнала.

--endpoint-url (строка)

Переопределяет URL по умолчанию команды заданным URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (логическое значение)

Отключить автоматическую постраничную навигацию. При отключении автоматической постраничной навигации AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

json
text
таблица
yaml
yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование определенного профиля из файла учетных данных.

--region (строка)

Используемый регион. Переопределяет настройки конфигурации/окружения.

--version (строка)

Отображение версии этого инструмента.

--color (строка)

Включение/выключение цветного вывода.

включено
выключено
автоматически

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Файл сертификата CA для использования при проверке сертификатов SSL. Переопределяет настройки конфигурации/окружения.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться в режиме блокировки без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться в режиме блокировки без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для заданной настройки cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.

Для возвращения информации о целевой точке развертывания

Следующий get-deployment-target пример возвращает информацию о целевой точке развертывания, связанной с указанным развертыванием.

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

Вывод:

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

Дополнительную информацию см. в разделе GetDeploymentTarget в Справочнике по API AWS CodeDeploy.

Вывод

deploymentTarget -> (структура)

Целевая среда развертывания, содержащая информацию о развертывании, такую как его статус, события жизненного цикла и время последнего обновления. Она также содержит метаданные о целевой среде развертывания. Метаданные целевой среды развертывания зависят от типа целевой среды (instanceTarget , lambdaTarget или ecsTarget ).

deploymentTargetType -> (строка)

Тип развертывания, специфичный для вычислительной платформы развертывания или развертываний, инициированных обновлением стека CloudFormation.

instanceTarget -> (структура)

Информация о целевом объекте для развертывания, использующего вычислительную платформу EC2/локального сервера.

deploymentId -> (строка)

Уникальный идентификатор развертывания.

targetId -> (строка)

Уникальный идентификатор целевой среды развертывания, имеющей тип instanceTarget .

targetArn -> (строка)

Amazon Resource Name (ARN) целевого объекта.

status -> (строка)

Статус целевого экземпляра EC2/локального сервера развертывания.

lastUpdatedAt -> (метка времени)

Дата и время обновления целевого экземпляра развертыванием.

lifecycleEvents -> (список)

События жизненного цикла развертывания для данного целевого экземпляра.

(структура)

Информация об событии жизненного цикла развертывания.

lifecycleEventName -> (строка)

Имя события жизненного цикла развертывания, например ApplicationStop , BeforeInstall , AfterInstall , ApplicationStart или ValidateService .

diagnostics -> (структура)

Диагностическая информация об событии жизненного цикла развертывания.

errorCode -> (строка)

Соответствующий код ошибки:

Success: Указанный скрипт был выполнен.
ScriptMissing: Указанный скрипт не найден в указанном месте.
ScriptNotExecutable: Указанный скрипт не является распознаваемым исполняемым файлом.
ScriptTimedOut: Указанный скрипт не был завершен в указанный период времени.
ScriptFailed: Указанный скрипт завершился с ошибкой.
UnknownError: Указанный скрипт не был выполнен по неизвестной причине.

scriptName -> (строка)

Имя скрипта.

message -> (строка)

Сообщение, связанное с ошибкой.

logTail -> (строка)

Последняя часть диагностического журнала.

Если доступно, CodeDeploy возвращает до последних 4 КБ диагностического журнала.

startTime -> (метка времени)

Метка времени, указывающая момент запуска события жизненного цикла развертывания.

endTime -> (метка времени)

Метка времени, указывающая момент завершения события жизненного цикла развертывания.

status -> (строка)

Статус события жизненного цикла развертывания:

Pending: Событие жизненного цикла развертывания ожидает.
InProgress: Событие жизненного цикла развертывания выполняется.
Succeeded: Событие жизненного цикла развертывания выполнено успешно.
Failed: Событие жизненного цикла развертывания завершилось с ошибкой.
Skipped: Событие жизненного цикла развертывания пропущено.
Unknown: Событие жизненного цикла развертывания неизвестно.

instanceLabel -> (строка)

Метка, определяющая, является ли экземпляр исходным целевым объектом (BLUE) или целевым объектом замены (GREEN).

lambdaTarget -> (структура)

Информация о целевом объекте для развертывания, использующего платформу Lambda.

deploymentId -> (строка)

Уникальный идентификатор развертывания.

targetId -> (строка)

Уникальный идентификатор целевой среды развертывания, имеющей тип lambdaTarget .

targetArn -> (строка)

Amazon Resource Name (ARN) целевого объекта.

status -> (строка)

Статус целевой функции Lambda развертывания.

lastUpdatedAt -> (метка времени)

Дата и время обновления целевой функции Lambda развертыванием.

lifecycleEvents -> (список)

События жизненного цикла развертывания для данной целевой функции Lambda.

(структура)

Информация об событии жизненного цикла развертывания.

lifecycleEventName -> (строка)

Имя события жизненного цикла развертывания, например ApplicationStop , BeforeInstall , AfterInstall , ApplicationStart или ValidateService .

diagnostics -> (структура)

Диагностическая информация об событии жизненного цикла развертывания.

errorCode -> (строка)

Соответствующий код ошибки:

Success: Указанный скрипт был выполнен.
ScriptMissing: Указанный скрипт не найден в указанном месте.
ScriptNotExecutable: Указанный скрипт не является распознаваемым исполняемым файлом.
ScriptTimedOut: Указанный скрипт не был завершен в указанный период времени.
ScriptFailed: Указанный скрипт завершился с ошибкой.
UnknownError: Указанный скрипт не был выполнен по неизвестной причине.

scriptName -> (строка)

Имя скрипта.

message -> (строка)

Сообщение, связанное с ошибкой.

logTail -> (строка)

Последняя часть диагностического журнала.

Если доступно, CodeDeploy возвращает до последних 4 КБ диагностического журнала.

startTime -> (метка времени)

Метка времени, указывающая момент запуска события жизненного цикла развертывания.

endTime -> (метка времени)

Метка времени, указывающая момент завершения события жизненного цикла развертывания.

status -> (строка)

Статус события жизненного цикла развертывания:

Pending: Событие жизненного цикла развертывания ожидает.
InProgress: Событие жизненного цикла развертывания выполняется.
Succeeded: Событие жизненного цикла развертывания выполнено успешно.
Failed: Событие жизненного цикла развертывания завершилось с ошибкой.
Skipped: Событие жизненного цикла развертывания пропущено.
Unknown: Событие жизненного цикла развертывания неизвестно.

lambdaFunctionInfo -> (структура)

Объект LambdaFunctionInfo, описывающий целевую функцию Lambda.

functionName -> (строка)

Имя функции Lambda.

functionAlias -> (строка)

Псевдоним функции Lambda. Дополнительная информация содержится в разделе «Псевдонимы функций Lambda» в руководстве разработчика Lambda.

currentVersion -> (строка)

Версия функции Lambda, на которую направлен трафик.

targetVersion -> (строка)

Версия функции Lambda, на которую направлен трафик после развертывания функции Lambda.

targetVersionWeight -> (двойное)

Процент трафика, который получает целевая версия функции Lambda.

ecsTarget -> (структура)

Информация о целевом объекте для развертывания, использующего платформу вычислений Amazon ECS.

deploymentId -> (строка)

Уникальный идентификатор развертывания.

targetId -> (строка)

Уникальный идентификатор целевого объекта развертывания, имеющего тип ecsTarget .

targetArn -> (строка)

Amazon Resource Name (ARN) целевого объекта.

lastUpdatedAt -> (временная метка)

Дата и время, когда целевое приложение Amazon ECS было обновлено развертыванием.

lifecycleEvents -> (список)

События жизненного цикла развертывания для этого целевого приложения Amazon ECS.

(структура)

Информация о событии жизненного цикла развертывания.

lifecycleEventName -> (строка)

Имя события жизненного цикла развертывания, например, ApplicationStop , BeforeInstall , AfterInstall , ApplicationStart или ValidateService .

diagnostics -> (структура)

Диагностическая информация о событии жизненного цикла развертывания.

errorCode -> (строка)

Соответствующий код ошибки:

Success: Указанный скрипт был выполнен.
ScriptMissing: Указанный скрипт не был найден в указанном месте.
ScriptNotExecutable: Указанный скрипт не является распознаваемым исполняемым файлом.
ScriptTimedOut: Указанный скрипт не завершил выполнение в указанный период времени.
ScriptFailed: Указанный скрипт не выполнился как ожидалось.
UnknownError: Указанный скрипт не был выполнен по неизвестной причине.

scriptName -> (строка)

Имя скрипта.

message -> (строка)

Сообщение, связанное с ошибкой.

logTail -> (строка)

Последняя часть диагностического журнала.

Если доступно, CodeDeploy возвращает до последних 4 КБ диагностического журнала.

startTime -> (временная метка)

Временная метка, указывающая время начала события жизненного цикла развертывания.

endTime -> (временная метка)

Временная метка, указывающая время завершения события жизненного цикла развертывания.

status -> (строка)

Статус события жизненного цикла развертывания:

Pending: Событие жизненного цикла развертывания ожидает.
InProgress: Событие жизненного цикла развертывания выполняется.
Succeeded: Событие жизненного цикла развертывания выполнено успешно.
Failed: Событие жизненного цикла развертывания завершилось ошибкой.
Skipped: Событие жизненного цикла развертывания пропущено.
Unknown: Событие жизненного цикла развертывания неизвестно.

status -> (строка)

Статус целевого приложения Amazon ECS развертывания Amazon ECS.

taskSetsInfo -> (список)

Объекты ECSTaskSet , связанные с целевым объектом ECS.

(структура)

Информация о наборе задач Amazon ECS в развертывании CodeDeploy. Набор задач Amazon ECS включает в себя подробности, такие как желаемое количество задач, количество выполняемых задач и служит ли набор задач для трафика производства. Приложение CodeDeploy, использующее платформу вычислений Amazon ECS, развертывает контейнерное приложение в службе Amazon ECS как набор задач.

identifer -> (строка)

Уникальный идентификатор ECSTaskSet .

desiredCount -> (целое)

Количество задач в наборе задач. Во время развертывания, использующего тип вычислений Amazon ECS, CodeDeploy инструктирует Amazon ECS создать новый набор задач и использует это значение для определения количества задач, которые нужно создать. После создания обновленного набора задач CodeDeploy переключает трафик на новый набор задач.

pendingCount -> (целое)

Количество задач в наборе задач, которые находятся в состоянии PENDING во время развертывания Amazon ECS. Задача в состоянии PENDING готовится перейти в состояние RUNNING. Набор задач переходит в состояние PENDING при первом запуске или при перезапуске после состояния STOPPED.

runningCount -> (целое)

Количество задач в наборе задач, которые находятся в состоянии RUNNING во время развертывания Amazon ECS. Задача в состоянии RUNNING выполняется и готова к использованию.

status -> (строка)

Статус набора задач. Существует три допустимых статуса набора задач:

PRIMARY : Указывает, что набор задач обрабатывает трафик производства.
ACTIVE : Указывает, что набор задач не обрабатывает трафик производства.
DRAINING : Указывает, что задачи в наборе задач останавливаются, а соответствующие целевые объекты отписываются от группы целевых объектов.

trafficWeight -> (вещественное число)

Процент трафика, обслуживаемый этим набором задач.

targetGroup -> (структура)

Группа целевых объектов, связанная с набором задач. Группа целевых объектов используется CodeDeploy для управления трафиком к набору задач.

name -> (строка)

Для развертываний типа "синий/зеленый" это имя группы целевых объектов, из которой экземпляры в исходной среде отписываются и с которой экземпляры в заменяющей среде регистрируются. Для развертываний на месте это имя группы целевых объектов, из которой экземпляры отписываются, чтобы они не обрабатывали трафик во время развертывания, а затем вновь регистрируются после завершения развертывания.

taskSetLabel -> (строка)

Метка, которая определяет, является ли набор задач ECS исходной целью (BLUE ) или заменяющей целью (GREEN ).

cloudFormationTarget -> (структура)

Информация о целевом объекте, который будет обновлен развертыванием CloudFormation "синий/зеленый". Этот тип целевого объекта используется для всех развертываний, инициированных обновлением стека CloudFormation.

deploymentId -> (строка)

Уникальный идентификатор развертывания CloudFormation "синий/зеленый".

targetId -> (строка)

Уникальный идентификатор целевого объекта развертывания, имеющего тип CloudFormationTarget .

lastUpdatedAt -> (временная метка)

Дата и время, когда целевое приложение было обновлено развертыванием CloudFormation "синий/зеленый".

lifecycleEvents -> (список)

События жизненного цикла развертывания CloudFormation "синий/зеленый" для этого целевого приложения.

(структура)

Информация о событии жизненного цикла развертывания.

lifecycleEventName -> (строка)

diagnostics -> (структура)

Диагностическая информация о событии жизненного цикла развертывания.

errorCode -> (строка)

Соответствующий код ошибки:

Success: Указанный скрипт был выполнен.
ScriptMissing: Указанный скрипт не был найден в указанном месте.
ScriptNotExecutable: Указанный скрипт не является распознаваемым исполняемым файлом.
ScriptTimedOut: Указанный скрипт не завершил выполнение в указанный период времени.
ScriptFailed: Указанный скрипт не выполнился как ожидалось.
UnknownError: Указанный скрипт не был выполнен по неизвестной причине.

scriptName -> (строка)

Имя скрипта.

message -> (строка)

Сообщение, связанное с ошибкой.

logTail -> (строка)

Последняя часть диагностического журнала.

Если доступно, CodeDeploy возвращает до последних 4 КБ диагностического журнала.

startTime -> (временная метка)

Временная метка, указывающая время начала события жизненного цикла развертывания.

endTime -> (временная метка)

Временная метка, указывающая время завершения события жизненного цикла развертывания.

status -> (строка)

Статус события жизненного цикла развертывания:

Pending: Событие жизненного цикла развертывания ожидает.
InProgress: Событие жизненного цикла развертывания выполняется.
Succeeded: Событие жизненного цикла развертывания выполнено успешно.
Failed: Событие жизненного цикла развертывания завершилось ошибкой.
Skipped: Событие жизненного цикла развертывания пропущено.
Unknown: Событие жизненного цикла развертывания неизвестно.

status -> (строка)

Статус целевого приложения развертывания CloudFormation "синий/зеленый".

resourceType -> (строка)

Тип ресурса для развертывания CloudFormation "синий/зеленый".

targetVersionWeight -> (вещественное число)

Процент трафика производства, который получает целевая версия развертывания CloudFormation "синий/зеленый".