Spec-Zone.ru › AWS CLI v2

[ aws . codepipeline ]

get-pipeline

Описание

Возвращает метаданные, структуру, этапы и действия конвейера. Может использоваться для возвращения всей структуры конвейера в формате JSON, которая затем может быть изменена и использована для обновления структуры конвейера с помощью UpdatePipeline.

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

Синтаксис

  get-pipeline
--name <value>
[--pipeline-version <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]

Параметры

--name (строка)

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

--pipeline-version (целое число)

Номер версии конвейера. Если версия не указана, используется текущая версия.

--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
  • table
  • yaml
  • yaml-stream

--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 V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, отображающего двоичный блок, 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.

Для просмотра структуры конвейера

В этом примере возвращается структура конвейера с именем MyFirstPipeline.

Команда:

aws codepipeline get-pipeline --name MyFirstPipeline

Вывод:

{
  "pipeline": {
      "roleArn": "arn:aws:iam::111111111111:role/AWS-CodePipeline-Service",
      "stages": [
          {
              "name": "Source",
              "actions": [
                  {
                      "inputArtifacts": [],
                      "name": "Source",
                      "actionTypeId": {
                          "category": "Source",
                          "owner": "AWS",
                          "version": "1",
                          "provider": "S3"
                      },
                      "outputArtifacts": [
                          {
                              "name": "MyApp"
                          }
                      ],
                      "configuration": {
                          "S3Bucket": "awscodepipeline-demo-bucket",
                          "S3ObjectKey": "aws-codepipeline-s3-aws-codedeploy_linux.zip"
                      },
                      "runOrder": 1
                  }
              ]
          },
          {
              "name": "Beta",
              "actions": [
                  {
                      "inputArtifacts": [
                          {
                              "name": "MyApp"
                          }
                      ],
                      "name": "CodePipelineDemoFleet",
                      "actionTypeId": {
                          "category": "Deploy",
                          "owner": "AWS",
                          "version": "1",
                          "provider": "CodeDeploy"
                      },
                      "outputArtifacts": [],
                      "configuration": {
                          "ApplicationName": "CodePipelineDemoApplication",
                          "DeploymentGroupName": "CodePipelineDemoFleet"
                      },
                      "runOrder": 1
                  }
              ]
          }
      ],
      "artifactStore": {
          "type": "S3",
          "location": "codepipeline-us-east-1-11EXAMPLE11"
      },
      "name": "MyFirstPipeline",
      "version": 1
  }
}

Вывод

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

Представляет структуру действий и этапов, которые должны быть выполнены в конвейере.

name -> (строка)

Имя конвейера.

roleArn -> (строка)

Amazon Resource Name (ARN) для использования CodePipeline для выполнения действий без actionRoleArn или для делегирования ролей для действий с actionRoleArn.

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

Представляет информацию об S3-ведре, где хранятся артефакты для конвейера.

Примечание

Необходимо указать либо artifactStore, либо artifactStores в вашем конвейере, но не оба сразу. Если вы создаете действие в разных регионах в вашем конвейере, вы должны использовать artifactStores.

type -> (строка)

Тип хранилища артефактов, например, S3.

location -> (строка)

S3-ведро, используемое для хранения артефактов конвейера. Можно указать имя S3-ведpa, но не папку в ведре. Для вас создается папка для хранения артефактов конвейера, основанная на имени конвейера. Для хранения артефактов конвейера можно использовать любое S3-ведро в том же регионе Amazon Web Services, что и конвейер.

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

Ключ шифрования, используемый для шифрования данных в хранилище артефактов, например, ключ Amazon Web Services Key Management Service. Если этот параметр не определён, используется ключ Amazon S3 по умолчанию.

id -> (строка)

Идентификатор, используемый для идентификации ключа. Для ключа Amazon Web Services KMS можно использовать идентификатор ключа, ARN ключа или ARN псевдонима.

Примечание

Псевдонимы распознаются только в учётной записи, которая создала ключ KMS. Для межсчётных действий можно использовать только идентификатор ключа или ARN ключа для идентификации ключа. Межсчётные действия подразумевают использование роли из другой учётной записи (AccountB), поэтому указание идентификатора ключа будет использовать ключ из другой учётной записи (AccountB).

type -> (строка)

Тип ключа шифрования, например, ключ Amazon Web Services KMS. При создании или обновлении конвейера значение должно быть установлено в ‘KMS’.

artifactStores -> (массив)

Сопоставление объектов artifactStore и соответствующих регионов Amazon Web Services. Должно быть хранилище артефактов для региона конвейера и для каждого действия в разных регионах в конвейере.

Примечание

Необходимо указать либо artifactStore, либо artifactStores в вашем конвейере, но не оба сразу. Если вы создаете действие в разных регионах в вашем конвейере, вы должны использовать artifactStores.

key -> (строка)

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

S3-ведро, в котором хранятся артефакты конвейера.

Примечание

Необходимо указать либо artifactStore, либо artifactStores в вашем конвейере, но не оба сразу. Если вы создаете действие в разных регионах в вашем конвейере, вы должны использовать artifactStores.

type -> (строка)

Тип хранилища артефактов, например, S3.

location -> (строка)

S3-ведро, используемое для хранения артефактов конвейера. Можно указать имя S3-ведpa, но не папку в ведре. Для вас создается папка для хранения артефактов конвейера, основанная на имени конвейера. Для хранения артефактов конвейера можно использовать любое S3-ведро в том же регионе Amazon Web Services, что и конвейер.

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

Ключ шифрования, используемый для шифрования данных в хранилище артефактов, например, ключ Amazon Web Services Key Management Service. Если этот параметр не определён, используется ключ Amazon S3 по умолчанию.

id -> (строка)

Идентификатор, используемый для идентификации ключа. Для ключа Amazon Web Services KMS можно использовать идентификатор ключа, ARN ключа или ARN псевдонима.

Примечание

Псевдонимы распознаются только в учётной записи, которая создала ключ KMS. Для межсчётных действий можно использовать только идентификатор ключа или ARN ключа для идентификации ключа. Межсчётные действия подразумевают использование роли из другой учётной записи (AccountB), поэтому указание идентификатора ключа будет использовать ключ из другой учётной записи (AccountB).

type -> (строка)

Тип ключа шифрования, например, ключ Amazon Web Services KMS. При создании или обновлении конвейера значение должно быть установлено в ‘KMS’.

stages -> (список)

Этап, на котором нужно выполнить действие.

(структура)

Представляет информацию о стадии и её определении.

name -> (строка)

Название стадии.

blockers -> (список)

Зарезервировано для будущего использования.

(структура)

Зарезервировано для будущего использования.

name -> (строка)

Зарезервировано для будущего использования.

type -> (строка)

Зарезервировано для будущего использования.

actions -> (список)

Действия, включённые в стадию.

(структура)

Представляет информацию об объявлении действия.

name -> (строка)

Имя объявления действия.

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

Указывает тип действия и поставщика действия.

category -> (строка)

Категория определяет, какой тип действия можно выполнить на стадии и ограничивает тип поставщика для действия. Допустимые категории ограничены следующими значениями.

  • Источник
  • Сборка
  • Тестирование
  • Развёртывание
  • Вызов
  • Утверждение
  • Вычисление

owner -> (строка)

Создатель вызываемого действия. Для поля Owner в разделе категории действия в структуре вашей конвейерной линии имеются три допустимых значения: AWS , ThirdParty и Custom . Дополнительную информацию см. в разделе "Допустимые типы и поставщики действий" в CodePipeline .

provider -> (строка)

Поставщик сервиса, вызываемого действием. Допустимые поставщики определяются категорией действия. Например, действие в категории типа "Развёртывание" может иметь поставщика CodeDeploy, который будет указан как CodeDeploy . Дополнительную информацию см. в разделе "Допустимые типы и поставщики действий" в CodePipeline .

version -> (строка)

Строка, описывающая версию действия.

runOrder -> (целое число)

Порядок выполнения действий.

configuration -> (массив)

Настройка действия. Это пары ключ-значение, которые указывают входные значения для действия. Дополнительную информацию см. в разделе "Требования к структуре действия" в CodePipeline. Список свойств конфигурации для типа действия CloudFormation в CodePipeline см. в справке по свойствам конфигурации в Руководстве пользователя по CloudFormation. Примеры фрагментов шаблонов см. в разделе "Использование функций переопределения параметров с конвейерами CodePipeline" в Руководстве пользователя по CloudFormation.

Значения могут быть представлены в формате JSON или YAML. Например, формат элемента конфигурации JSON выглядит следующим образом:

JSON:

"Configuration" : { Key : Value },

key -> (строка)

value -> (строка)

commands -> (список)

Команды оболочки для выполнения вашего действия вычисления в CodePipeline. Поддерживаются все команды, кроме многострочных форматов. Хотя используются журналы CodeBuild и разрешения, вам не нужно создавать никакие ресурсы в CodeBuild.

Примечание

Использование времени вычислений для этого действия повлечёт дополнительные расходы в CodeBuild.

(строка)

outputArtifacts -> (список)

Имя или идентификатор результата объявления действия, например, артефакта теста или сборки.

(структура)

Представляет информацию о выводе действия.

name -> (строка)

Имя вывода артефакта, например, "My App".

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

Имена выходных артефактов должны быть уникальными в пределах конвейера.

files -> (список)

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

(строка)

inputArtifacts -> (список)

Имя или идентификатор артефакта, потребляемого действием, например, артефакта теста или сборки.

(структура)

Представляет информацию об артефакте, над которым нужно работать, например, артефакте теста или сборки.

name -> (строка)

Имя артефакта, над которым нужно работать (например, "My App").

Артефакты — это файлы, над которыми работают действия в конвейере. Подробные сведения об параметрах артефактов см. в настройке действия для каждого действия. Например, входной артефакт действия источника S3 — это имя файла (или путь к файлу), и файлы обычно предоставляются в виде ZIP-архива. Пример имени артефакта: SampleApp_Windows.zip

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

outputVariables -> (список)

Список переменных, которые должны быть экспортированы из действия вычисления. Это переменные среды CodeBuild, используемые для этого действия.

(строка)

roleArn -> (строка)

ARN службы IAM, которая выполняет объявленное действие. Это подразумевается через roleArn для конвейера.

region -> (строка)

Регион Amazon Web Services для объявления действия, например us-east-1.

namespace -> (строка)

Пространство имён переменных, связанное с действием. Все переменные, производимые в качестве результата этим действием, находятся в этом пространстве имён.

timeoutInMinutes -> (целое число)

Срок ожидания в минутах, который может быть применён к значению по умолчанию для времени ожидания ActionType, указанному в квотах для CodePipeline. Это свойство доступно только для типа действия ручного утверждения.

environmentVariables -> (список)

Переменные среды для действия.

(структура)

Переменные среды для действия.

name -> (строка)

Имя переменной среды в паре ключ-значение.

value -> (строка)

Значение переменной среды в паре ключ-значение.

type -> (строка)

Указывает тип использования значения переменной среды. Значение может быть либо PLAINTEXT, либо SECRETS_MANAGER. Если значение равно SECRETS_MANAGER, предоставьте ссылку на секреты в значении EnvironmentVariable.

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

Метод, используемый, когда стадия не завершена успешно. Например, настройка этого поля для отката автоматически откатит невыполненную стадию к последнему успешно выполненному выполнению конвейера на стадии.

result -> (строка)

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

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

Настройка повтора указывает автоматический повтор неудачной стадии, а также настроенный режим повтора.

retryMode -> (строка)

Метод, который вы хотите настроить для автоматического повтора стадии при ошибке. Вы можете указать повтор только для неудачного действия на стадии или всех действий на стадии.

conditions -> (список)

Условия, настроенные как условия ошибки. Дополнительную информацию об условиях см. в разделах "Условиях стадии" и "Как работают условия стадии?".

(структура)

Условие для стадии. Условие состоит из правил и результата для условия. Дополнительную информацию об условиях см. в разделах "Условиях стадии" и "Как работают условия стадии?". Дополнительную информацию о правилах см. в справке по правилам CodePipeline.

result -> (строка)

Действие, которое нужно выполнить, когда выполнено условие. Например, откат выполнения при условии ошибки.

rules -> (список)

Правила, составляющие условие.

(структура)

Представляет информацию о правиле, которое необходимо создать для связанного условия. Пример — создание нового правила для входного условия, например, правила, которое проверяет результат теста перед разрешением запуска на стадии развертывания. Дополнительную информацию об условиях см. в разделах "Условиях стадии" и "Как работают условия стадии?". Дополнительную информацию о правилах см. в справке по правилам CodePipeline.

name -> (строка)

Имя правила, созданного для условия, например, VariableCheck.

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

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

category -> (строка)

Категория определяет, какой тип правила можно запустить на стадии и ограничивает тип поставщика для правила. Допустимая категория — Rule.

owner -> (строка)

Создатель вызываемого правила. Допустимое значение для поля Owner в категории правила — AWS.

provider -> (строка)

Поставщик правила, например, правило DeploymentWindow. Список имён поставщиков правил см. в справке по правилам CodePipeline.

version -> (строка)

Строка, описывающая версию правила.

configuration -> (массив)

Поля конфигурации действия для правила.

key -> (строка)

value -> (строка)

commands -> (список)

Команды оболочки для выполнения вашего правила команд в CodePipeline. Поддерживаются все команды, кроме многострочных форматов. Хотя используются журналы CodeBuild и разрешения, вам не нужно создавать никакие ресурсы в CodeBuild.

Примечание

Использование времени вычислений для этого действия повлечёт дополнительные расходы в CodeBuild.

(строка)

inputArtifacts -> (список)

Поля входных артефактов для правила, например, указание входного файла для правила.

(структура)

Представляет информацию об артефакте, над которым нужно работать, например, артефакте теста или сборки.

name -> (строка)

Имя артефакта, над которым нужно работать (например, "My App").

Артефакты — это файлы, над которыми работают действия в конвейере. Подробные сведения об параметрах артефактов см. в настройке действия для каждого действия. Например, входной артефакт действия источника S3 — это имя файла (или путь к файлу), и файлы обычно предоставляются в виде ZIP-архива. Пример имени артефакта: SampleApp_Windows.zip

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

roleArn -> (строка)

ARN роли конвейера, связанной с правилом.

region -> (строка)

Регион для условия, связанного с правилом.

timeoutInMinutes -> (целое число)

Срок ожидания действия для правила.

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

Метод, используемый, когда этап завершился успешно. Например, настройка этого поля для условий позволит этапу завершиться успешно, когда условия будут выполнены.

conditions -> (список)

Условии, являющиеся условиями успеха.

(структура)

Условие для этапа. Условие состоит из правил и результата для условия. Более подробную информацию об условиях можно найти в разделе Условия этапов и Как работают условия этапов? .. Более подробную информацию о правилах можно найти в справочнике по правилам CodePipeline.

result -> (строка)

Действие, выполняемое при выполнении условия. Например, откат выполнения для условия ошибки.

rules -> (список)

Правила, составляющие условие.

(структура)

Представляет информацию о правиле, которое нужно создать для связанного условия. Примером может служить создание нового правила для условия входа, такого как правило, которое проверяет результат теста перед разрешением запуска в этап развертывания. Более подробную информацию об условиях можно найти в разделе Условия этапов и Как работают условия этапов? . Более подробную информацию о правилах можно найти в справочнике по правилам CodePipeline.

name -> (строка)

Имя правила, созданного для условия, например VariableCheck.

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

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

category -> (строка)

Категория определяет тип правила, которое может выполняться на этапе, и ограничивает тип поставщика для правила. Действительная категория — Rule.

owner -> (строка)

Создатель вызываемого правила. Действительное значение для поля Owner в категории правила — AWS.

provider -> (строка)

Поставщик правил, например, правило DeploymentWindow. Список имён поставщиков правил см. в справочнике по правилам CodePipeline.

version -> (строка)

Строка, описывающая версию правила.

configuration -> (карта)

Поля конфигурации действия для правила.

key -> (строка)

value -> (строка)

commands -> (список)

Команды оболочки для выполнения с правилом команд в CodePipeline. Поддерживаются все команды, кроме многострочных форматов. Хотя используются журналы и разрешения CodeBuild, создавать ресурсы в CodeBuild не нужно.

Примечание

Использование времени вычислений для этого действия повлечёт дополнительные расходы в CodeBuild.

(строка)

inputArtifacts -> (список)

Поля входных артефактов для правила, например, указание входного файла для правила.

(структура)

Представляет информацию об артефакте, над которым ведётся работа, например, артефакте теста или сборки.

name -> (строка)

Имя артефакта, над которым ведётся работа (например, «My App»).

Артефакты — это файлы, над которыми работают действия в конвейере. Подробности о параметрах артефактов см. в конфигурации каждого действия. Например, входной артефакт действия источника S3 — это имя файла (или путь к файлу), и файлы обычно предоставляются в формате ZIP. Пример имени артефакта: SampleApp_Windows.zip

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

roleArn -> (строка)

ARN роли конвейера, связанной с правилом.

region -> (строка)

Регион для условия, связанного с правилом.

timeoutInMinutes -> (целое число)

Таймаут действия для правила.

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

Метод, используемый, когда этап разрешает вход. Например, настройка этого поля для условий позволит входить на этап, когда условия будут выполнены.

conditions -> (список)

Условии, настроенные как условия входа.

(структура)

Условие для этапа. Условие состоит из правил и результата для условия. Более подробную информацию об условиях можно найти в разделе Условия этапов и Как работают условия этапов? .. Более подробную информацию о правилах можно найти в справочнике по правилам CodePipeline.

result -> (строка)

Действие, выполняемое при выполнении условия. Например, откат выполнения для условия ошибки.

rules -> (список)

Правила, составляющие условие.

(структура)

Представляет информацию о правиле, которое нужно создать для связанного условия. Примером может служить создание нового правила для условия входа, такого как правило, которое проверяет результат теста перед разрешением запуска в этап развертывания. Более подробную информацию об условиях можно найти в разделе Условия этапов и Как работают условия этапов? . Более подробную информацию о правилах можно найти в справочнике по правилам CodePipeline.

name -> (строка)

Имя правила, созданного для условия, например VariableCheck.

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

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

category -> (строка)

Категория определяет тип правила, которое может выполняться на этапе, и ограничивает тип поставщика для правила. Действительная категория — Rule.

owner -> (строка)

Создатель вызываемого правила. Действительное значение для поля Owner в категории правила — AWS.

provider -> (строка)

Поставщик правил, например, правило DeploymentWindow. Список имён поставщиков правил см. в справочнике по правилам CodePipeline.

version -> (строка)

Строка, описывающая версию правила.

configuration -> (карта)

Поля конфигурации действия для правила.

key -> (строка)

value -> (строка)

commands -> (список)

Команды оболочки для выполнения с правилом команд в CodePipeline. Поддерживаются все команды, кроме многострочных форматов. Хотя используются журналы и разрешения CodeBuild, создавать ресурсы в CodeBuild не нужно.

Примечание

Использование времени вычислений для этого действия повлечёт дополнительные расходы в CodeBuild.

(строка)

inputArtifacts -> (список)

Поля входных артефактов для правила, например, указание входного файла для правила.

(структура)

Представляет информацию об артефакте, над которым ведётся работа, например, артефакте теста или сборки.

name -> (строка)

Имя артефакта, над которым ведётся работа (например, «My App»).

Артефакты — это файлы, над которыми работают действия в конвейере. Подробности о параметрах артефактов см. в конфигурации каждого действия. Например, входной артефакт действия источника S3 — это имя файла (или путь к файлу), и файлы обычно предоставляются в формате ZIP. Пример имени артефакта: SampleApp_Windows.zip

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

roleArn -> (строка)

ARN роли конвейера, связанной с правилом.

region -> (строка)

Регион для условия, связанного с правилом.

timeoutInMinutes -> (целое число)

Таймаут действия для правила.

version -> (целое число)

Номер версии конвейера. Новый конвейер всегда имеет номер версии 1. Этот номер увеличивается при обновлении конвейера.

executionMode -> (строка)

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

pipelineType -> (строка)

CodePipeline предоставляет следующие типы конвейеров, которые отличаются по характеристикам и цене, чтобы вы могли настроить функции и стоимость своего конвейера в соответствии с потребностями ваших приложений.

  • Конвейеры типа V1 имеют JSON-структуру, содержащую стандартные параметры конвейера, этапа и действия.
  • Конвейеры типа V2 имеют ту же структуру, что и конвейеры типа V1, а также дополнительные параметры для безопасности выпуска и конфигурации триггеров.

Предупреждение

Включение параметров V2, таких как триггеры по Git-тегам, в JSON-конвейера при создании или обновлении конвейера приведёт к тому, что конвейер будет иметь тип конвейера V2 и соответствующие затраты.

Подробнее о ценах на CodePipeline см. раздел Цены .

Подробнее о выборе типа конвейера см. Какой тип конвейера подходит мне? .

variables -> (список)

Список, определяющий переменные конвейера для ресурса конвейера. Имена переменных могут содержать буквенно-цифровые символы и символ подчеркивания, а значения должны соответствовать [A-Za-z0-9@\-_]+.

(структура)

Переменная, объявленная на уровне конвейера.

name -> (строка)

Имя переменной на уровне конвейера.

defaultValue -> (строка)

Значение переменной на уровне конвейера.

description -> (строка)

Описание переменной на уровне конвейера. Оно используется для добавления дополнительного контекста о переменной и не используется во время выполнения конвейера.

triggers -> (список)

Конфигурация триггера, определяющая тип события, такого как теги Git, запускающего конвейер.

Примечание

При указании конфигурации триггера отключается стандартное обнаружение изменений для коммитов репозитория и ветвей.

(структура)

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

Примечание

Это поддерживается только для типа действия CodeStarSourceConnection.

Примечание

При указании конфигурации триггера отключается стандартное обнаружение изменений для коммитов репозитория и ветвей.

providerType -> (строка)

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

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

Предоставляет критерии фильтрации и этап источника для события репозитория, запускающего конвейер, такого как теги Git.

sourceActionName -> (строка)

Имя действия источника конвейера, где указана конфигурация триггера, например, теги Git. Конфигурация триггера запустит конвейер при указанном изменении.

Примечание

Вы можете указать только одну конфигурацию триггера на действие источника.

push -> (список)

Поле, в котором указано событие репозитория, которое запустит конвейер, например, отправка тегов Git, с подробностями.

(структура)

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

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

Поле, содержащее сведения о конфигурации триггера для тегов Git.

includes -> (список)

Список шаблонов тегов Git, которые, при отправке, включаются в критерии запуска конвейера.

(строка)

excludes -> (список)

Список шаблонов тегов Git, которые, при отправке, исключаются из запуска конвейера.

(строка)

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

Поле, определяющее фильтр по ветвям для конфигурации триггера push.

includes -> (список)

Список шаблонов ветвей Git, которые, при отправке коммита, включаются в критерии запуска конвейера.

(строка)

excludes -> (список)

Список шаблонов ветвей Git, которые, при отправке коммита, исключаются из запуска конвейера.

(строка)

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

Поле, определяющее фильтр по путям к файлам для конфигурации триггера push.

includes -> (список)

Список шаблонов путей к файлам репозитория Git, которые, при отправке коммита, включаются в критерии запуска конвейера.

(строка)

excludes -> (список)

Список шаблонов путей к файлам репозитория Git, которые, при отправке коммита, исключаются из запуска конвейера.

(строка)

pullRequest -> (список)

Поле, где событие репозитория, которое запустит конвейер, задано как запросы на вытягивание.

(структура)

Критерии события для конфигурации триггера запроса на вытягивание, такие как списки ветвей или путей к файлам для включения и исключения.

Следующие значения являются допустимыми для событий для этого фильтра:

  • CLOSED
  • OPEN
  • UPDATED

events -> (список)

Поле, определяющее, какие события запросов на вытягивание отфильтровать (OPEN, UPDATED, CLOSED) для конфигурации триггера.

(строка)

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

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

includes -> (список)

Список шаблонов ветвей Git, которые, при отправке коммита, включаются в критерии запуска конвейера.

(строка)

excludes -> (список)

Список шаблонов ветвей Git, которые, при отправке коммита, исключаются из запуска конвейера.

(строка)

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

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

includes -> (список)

Список шаблонов путей к файлам репозитория Git, которые, при отправке коммита, включаются в критерии запуска конвейера.

(строка)

excludes -> (список)

Список шаблонов путей к файлам репозитория Git, которые, при отправке коммита, исключаются из запуска конвейера.

(строка)

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

Представляет метаданные конвейера, возвращаемые в результате работы действия GetPipeline.

pipelineArn -> (строка)

Идентификатор ресурса Amazon (ARN) конвейера.

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

Дата и время создания конвейера в формате отметки времени.

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

Дата и время последнего обновления конвейера в формате отметки времени.

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

Дата и время остановки опроса изменений источника (периодических проверок) для конвейера в формате отметки времени.

Предупреждение

Конвейеры, неактивные более 30 дней, будут иметь отключение опроса. Дополнительная информация в структуре конвейера в разделе pollingDisabledAt. Инструкции по миграции конвейера с опроса на обнаружение изменений на основе событий находятся в статье Миграция конвейеров опроса для использования обнаружения изменений на основе событий.

Вы можете мигрировать (обновить) конвейер опроса для использования обнаружения изменений на основе событий. Например, для конвейера с источником CodeCommit рекомендуется мигрировать (обновить) конвейер для использования CloudWatch Events. Дополнительные сведения см. в статье Миграция конвейеров опроса для использования обнаружения изменений на основе событий в руководстве пользователя CodePipeline.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API