Получение статуса коннекторов#

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

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

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

При возникновении ошибок выводится сообщение в формате:

"[${currentDateTime}] ${sendExceptionsEncountered.get()} previous sends failed, task will be stopped."
"First encountered exception:", sendException.get()

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

При помощи Jenkins#

Для получения статуса коннекторов с помощью Jenkins используйте задание SYN_custom_replicator с выбором playbook replicator.yml с тегом status (покажет состояние и список коннекторов).

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

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

  • jenkins_slave — Slave Jenkins.

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

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

  • nexus_user_cred — ID credential типа username with password для выкачивания дистрибутива. При задании параметра secman_url - полный путь в SHashiCorp Vault до имени пользователя и пароля, например {ID credential типа vault app role для получение секретов из SecMan}|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/nexus:{user},{password}.

  • vault_cred — ID credential типа secret file со строкой для расшифровки паролей (ansible vault) (можно указывать несколько через запятую). При задании параметра secman_url - полный путь в HashiCorp Vault до пароля, например {ID credential }|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/vault:{password_1},{ID credential _2}|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/vault:{password_2} (в качестве пароля можно использовать не строку, а файл в base64 формате с ключом секрета, заканчивающимся на Base64, например myVaultBase64).

  • server_ssh_cred — ID credential типа ssh key для подключения к серверам. При задании параметра secman_url - полный путь в HashiCorp Vault, например {ID credential типа vault app role для получение секретов из SecMan}|/CI01994970_CI02618129_ES/A/DEV/APP/JEN/KV/ssh:{пользователь},{ключ},{passphrase} (в качестве ключа можно использовать не строку, а файл в base64 формате с ключом секрета, заканчивающимся на Base64, например myPrivateKeyBase64).

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

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

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

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

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

  • playbook — выбрать необходимый playbook.

  • tags — используемые теги. Если ни один тег не выбран, то играется весь плейбук.

  • usedWorker — используемые воркеры.

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

  • downloadFromNexus — нужно ли выкачивать дистрибутив из Нексуса? (для остановки/старта это обычно не нужно).

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

  • only_on_host — отметить галочками необходимые hosts.

  • m36_check — включить проверку метрики M36.

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

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

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

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

Если не выбран ни один из параметров only_on_host, install_all_hosts выполнение задания Jenkins прервется с ошибкой Не выбраны hosts.