Остановка коннектора#

Остановка коннектора выполняется пользователем с логической ролью «Администратор».

Ручной способ#

На сервере, с которого производилась установка, выполните команду:

curl -v --cert ./<наименование экземпляра техсервиса>.pem --key ./<наименование экземпляра техсервиса>.pem -k -X DELETE https://localhost:8090/connectors/<наименование коннектора>

При помощи Jenkins#

Для остановки коннектора с помощью Jenkins используйте задание SYN_custom_replicator:

• с выбором тега stop_connector (запустит коннектор выбранной версии (из Nexus) в выбранном кластере).

Настраиваемые параметры:

• job_config_renew — параметр, использующийся для перенастройки задания Jenkins. Данный параметр используется, если был добавлен новый inventory. Меняет значения по умолчанию всех параметров. Сохраняет предыдущее состояние параметров inventories_repo, inventories_branch, inventories_path. Обновляет список тегов для всех playbooks. По умолчанию не указывается;

• inventory — кластер, для которого необходимо обновить библиотеки и конфигурации;

• nexusUrl — полный путь до дистрибутива (можно указать несколько через запятую);

• emailto — список адресов электронной почты, на которые придет письмо с результатом выполнения задания Jenkins;

• playbook — необходимый playbook;

• tags — тег stop_connector;

• usedWorker — используемые Workers;

• usedConnector — используемые коннекторы;

• select_all_hosts — запуск задания Jenkins на всех hosts из указанного inventory;

• only_on_host — необходимые hosts (отмечаются галочками);

• custom_vault_password — указывается, если нужен ручной ввод пароля для Ansible Vault;

• jenkins_slave — Slave Jenkins;

• jdk_tool — указание Jenkins Tool с нужной версией JDK;

• ansible_branch — ветка скриптов развертывания;

• ansible_version — версия используемого ansible;

• nexus_user_cred — ID credential типа username with password для выкачивания дистрибутива компонента из Nexus. Чтобы получить username и password для Nexus из HashiCorp Vault, необходимо заполнить параметр secman_url в формате: JenkinsCredID |SecManPath:SecManKeys|SecManParams, где:

  • JenkinsСredID — Jenkins Vault App Role Credential ID c реквизитами для подключения к HashiCorp Vault;

  • SecManPath — путь к секретам в HashiCorp Vault;

  • SecManKeys — имена полей для username и password в HashiCorp Vault (через запятую);

  • SecManParams — параметры для подключения к HashiCorp Vault (через точку с запятой). Если данные параметры по умолчанию, то пропускаются вместе с «|». Примеры:

    • SecManAppRoleCred|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/nexus:username,password

    • SecManAppRoleCred|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/nexus:username,password|engineVersion:2

• vault_cred — ID credential типа secret file со строкой для расшифровки паролей ansible vault (можно указывать несколько через запятую). Чтобы получить ansible vault password из HashiCorp Vault, необходимо заполнить параметр secman_url в формате: JenkinsСredID|SecManPath:SecManKey|SecManParams, где:

  • JenkinsСredID — Jenkins Vault App Role Credential ID с реквизитами для подключения к HashiCorp Vault;

  • SecManPath — путь к секрету в HashiCorp Vault;

  • SecManKey — имя поля для ansible vault password в HashiCorp Vault;

  • SecManParams — параметры для подключения к HashiCorp Vault (через точку с запятой). Если данные параметры по умолчанию, то пропускаются вместе с «|» (в качестве пароля можно использовать не строку, а файл в base64 формате и секрет в HashiCorp Vault с именем, оканчивающимся на «Base640», например: myVaultBase64). Примеры:

    • SecManAppRoleCred|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/vault:ansible_vault_password

    • SecManAppRoleCred|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/vault:ansible_vault_password|engineVersion:2

    • SecManAppRoleCred1|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/vault:ansible_vault_password1,SecManAppRoleCred2|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/vault:ansible_vault_password2

    • SecManAppRoleCred1|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/vault:ansible_vault_password1|engineVersion:2,SecManAppRoleCred2|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/vault:ansible_vault_password2|engineVersion:2

• server_ssh_cred — ID credential типа ssh key с ssh ключом для подключения к конечным серверам. Чтобы получить ssh_username, ssh_key, ssh_key_passsphrase для подключения к серверам из HashiCorp Vault, необходимо заполнить параметр secman_url в формате: JenkinsCredID|SecManPath:SecManKeys|SecManParams, где:

  • JenkinsСredID — Jenkins Vault App Role Credential ID, содержащий реквизиты для подключения к HashiCorp Vault;

  • SecManPath — путь к секретам в HashiCorp Vault;

  • SecManKeys — имена полей для ssh_username, ssh_key, ssh_key_passphrase в HashiCorp Vault (через запятую). Ssh_key_passphrase не указывается, если у ssh ключа нет пароля;

  • SecManParams — параметры подключения к HashiCorp Vault (через точку с запятой). Если данные параметры по умолчанию, то пропускаются вместе с «|» (в качестве ключа можно использовать не строку, а файл в base64 формате и секрет в HashiCorp Vault с именем, оканчивающимся на «Base64», например: myPrivateKeyBase64). Примеры:

    • SecManAppRoleCred|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/vault:ssh_username,ssh_key

    • SecManAppRoleCred|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/vault:ssh_username,ssh_key,ssh_key_passphrase

    • SecManAppRoleCred|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/vault:ssh_username,ssh_key,ssh_key_passphrase|engineVersion:2

• secman_url — URL для подключения к HashiCorp Vault;

• ssl_verify — проверка, являются ли сертификаты HashiCorp Vault/Nexus доверенными;

• second_hand_approve — подтверждение запуска другим администратором (контроль «второй рукой»);

• inventories_repo — репозиторий с inventory (ssh://);

• inventories_branch — ветка репозитория;

• inventories_path — путь до inventories от корня репозитория.