Настройка Service Pipeline#

Для настройки service pipeline необходимо:

  1. Создать пустой Jenkins pipeline с произвольным именем, например CDJE_UFS_PIPELINE_SERVICE;

  2. Открыть в настройки созданного pipeline;

  3. Включить checkbox Prepare an environment for the run;

  4. В блок Properties Content добавить следующее параметры:

NODE= метка Jenkins agent, на котором будет выполняться pipeline
ENVIR= любой суффикс, например, буквенный код стенда (**)
CHANNEL= канал, оставить пустым
CE= любой префикс компонента (см. раздел Подготовка, пункт Настройка BitBucket)
SUBDIVISION= название компонента, mailbridge (см. раздел Подготовка (installation_preparation), пункт Настройка BitBucket)
REPO_NAME= имя репозитория, всегда fpi
SEGMENT=придумать наименование логического сегмента, который впоследствии указать в common репозитории в файле environment.json
CUSTOM_USER_PASS_CREDS= ID записи в Jenkins Credentials plugin, который содержит учетные данные ТУЗ DevOps (см. раздел Подготовка (installation_preparation), пункт Добавление учетных данных в Jenkins Credentials plugin)
GIT_CRED= ID записи в Jenkins Credentials plugin, который содержит SSH ключи ТУЗ DevOps (см. раздел Подготовка (installation_preparation), пункт Добавление учетных данных в Jenkins Credentials plugin) DEBUG=включение режима режим отладки (true - включен, false - выключен)
GIT_URL= SSH url на пространство BitBucket, где располагаются созданные репозитории (см. раздел «Подготовка», пункт "Настройка BitBucket" документа «Руководство по установке»).
CONFIG_DIR=/

** см. раздел Подготовка п. Настройка BitBucket

По сочетанию параметров ENVIR, SUBDIVISION, CE, CHANNEL deploy pipeline будет искать репозитории, поэтому имена должны быть соответствующие.

  1. Настроить в Pipeline → Definition выбрать Pipeline script from SCM:

SCM: Git
Repository URL: SSH url на репозиторий BitBucket, где располагаются скрипты миграции pipeline
Credentials: ID записи в Jenkins Credentials plugin, который содержит SSH ключи ТУЗ DevOps (см. раздел Подготовка (installation_preparation), пункт Добавление учетных данных в Jenkins Credentials plugin)
Branch specifier: */service
Script path: deploy-fpi-service.groovy

  1. Сохранить изменения;

  2. Запустить сборку pipeline без указания параметров и дождаться выполнения, произойдет автоматическая конфигурация pipeline;

  3. Запустить процесс миграции скриптов PIPELINE версии release/D-01.039.088. Нажать Собрать с параметрами и указать следующее:

SERVICE_VERSION: service
ARTIFACT_TYPE: PIPELINE
ARTIFACT_VERSION:  release/D-01.039.088
PARAMS: MIGRATION + MIGRATE_DEPLOY_SCRIPTS

В результате выполнения этапа в репозиторий {код компонента}mailbridge_pipeline{стенд} в ветку master произойдет миграция скриптов pipeline, в репозиторий {код компонента}mailbridge_common{стенд} произойдет миграция конфигурационных файлов.

  1. Запустить процесс миграции скриптов COMMON версии D-01.001.00-440. Нажать Собрать с параметрами и указать следующее:

SERVICE_VERSION: service
ARTIFACT_TYPE: COMMON
ARTIFACT_VERSION: D-01.001.00-440
PARAMS: MIGRATION + MIGRATION_SUBSYSTEMS

В результате выполнения этапа в репозиторий {код компонента}mailbridge_common{стенд} в ветку master произойдет миграция набора конфигурационных файлов.