monqctl
Установку клиента управления Monq можно произвести на любой сервер под управление Linux или Windows.
Информация
По умолчанию в распространяемом образе Monq - клиент управления Monq уже установлен и частично сконфигурирован.
Дополнительно, для работы с обновлениями Monq необходимо добавить в конфигурацию monqctl
токен доступа к обновлениям ReleaseHub - шаг №3 конфигурации.
Загрузите последнюю версию Клиента управления MONQ из нашего репозитория:
curl -LO https://downloads.monq.ru/tools/monqctl/`curl -s https://downloads.monq.ru/tools/monqctl/latest.txt`/linux-x64/monqctl.zip
Windows
Ссылка для загрузки версии monqctl
для Windows - скачать (opens new window)
Вставьте в фрагмент команды вместо
$(curl -s https://downloads.monq.ru/tools/monqctl/latest.txt)
нужную версию.
Например, команда загрузки версии v1.1.0 для Linux будет выглядеть следующим образом:
curl -LO https://downloads.monq.ru/tools/monqctl/v1.1.0/linux-x64/monqctl.zip
Разархивируйте полученный файл:
#debian based distribs
sudo apt-get install unzip
#redhat based distribs
sudo yum install unzip
unzip monqctl.zip
Сделайте двоичный файл monqctl
исполняемым:
chmod +x ./monqctl
Переместите двоичный файл в директорию из переменной окружения $PATH
:
sudo mv ./monqctl /usr/local/bin/monqctl
Убедитесь, что установлена последняя версия monqctl
:
monqctl --version
monqctl
Для начала работы с monqctl требуется выполнить конфигурацию контекста программы для использования с конкретным экземпляром Monq.
Конфигурация токена доступа к обновлениям
При конфигурации monqctl вам потребуется токен для доступа в ReleaseHub. Его требуется получить, обратившись в поддержку Monq.
Предположим, что ваш экземпляр Monq расположен по следующему адресу: monq.domain.com
и вам необходимо произвести конфигурацию monqctl
. Для этого выполните следующие действия:
Добавьте экземпляр Monq в конфигурацию контекста:
monqctl config set instance monq.domain.com --server=http://pl-microservice-registry.api.monq.domain.com
Добавьте разрешение для доступа к экземпляру Monq. Токены в ранних версиях реестра микросервисов не используется:
monqctl config set credential monq-user
Добавьте токен доступа в ReleaseHub для получения обновлений:
monqctl config set releasehub monq-release-hub --token=<token>
Сконфигурируйте контекст, который связывает экземпляр Monq, разрешение доступа и MONQ ReleaseHub для доступа к обновлениям:
monqctl config set context monq.domain.com --instance=monq.domain.com --credential=monq-user --releasehub=monq-release-hub
Установите текущий контекст экземпляра Monq, с которым будет взаимодействовать клиент управления monqctl
:
monqctl config use-context monq.domain.com
monqctl
Использование:
monqctl [options] [command]
Опции:
Опция | Описание |
---|---|
--version | Показать текущую версию программы monqctl |
-?, -h, --help | Показать справку |
Команды:
Команда | Описание | Справка |
---|---|---|
config | Команда для работы с конфигурацией monqctl | monqctl config -h |
registry | Команда для работы с реестром микросервисов | monqctl registry -h |
release | Команда для работы с обновлениями Monq | monqctl release -h |
instance | Команда управления текущим инстансом Monq | monqctl instance -h |
monqctl registry
Использование:
monqctl [options] registry [command]
Опции:
Опция | Описание |
---|---|
-?, -h, --help | Показать справку |
Команды:
Команда | Описание | Справка |
---|---|---|
get | Команда получение статусов и информации из реестра микросервисов | monqctl registry get -h |
apply | Команда для применения конфигураций микросервисов | monqctl registry apply -h |
update | Команда для обновления версии реестра микросервисов | monqctl registry update -h |
export | Команда для экспорта обновления из ReleaseHub в папку | monqctl registry export -h |
monqctl release
Использование:
monqctl [options] release [command]
Опции:
Опция | Описание |
---|---|
-?, -h, --help | Показать справку |
Команды:
Команда | Описание | Справка |
---|---|---|
update | Команда обновления объектов ППО текущей инсталяции | monqctl release update -h |
version | Команда для работы с доступными версиями Monq | monqctl release version -h |
use-version <version> | Команда для выбора устанавливаемой версии обновления | monqctl release use-version -h |
current-version | Команда для получения текущей версии Monq | monqctl release current-version -h |
monqctl instance
Использование:
monqctl [options] instance [command]
Опции:
Опция | Описание |
---|---|
-?, -h, --help | Показать справку |
Команды:
Команда | Описание | Справка |
---|---|---|
clear | Команда очистки сущностей Monq | monqctl instance clear -h |
exec | Команда запуска миграций с БД Monq | monqctl instance exec -h |
get | Команда получения информации об инстансе Monq | monqctl instance get -h |
monqctl config
monqctl config get instances
monqctl config get instances <Name of instance>
monqctl config get credentials
monqctl config get credentials <Name of credential>
monqctl config get releasehubs
monqctl config get releasehubs <Name of ReleaseHub>
monqctl config get contexts
monqctl config get contexts <Name of context>
monqctl config rename instance <old-instance> <new-instance>
monqctl config rename credential <old-user> <new-user>
monqctl config rename releasehub <old-release-hub> <new-release-hub>
monqctl config rename context <old-smon> <new-smon>
monqctl config delete instance <Name of instance>
monqctl config delete credential <Name of credential>
monqctl config delete releasehub <Name of releasehub>
monqctl config delete context <Name of context>
monqctl config view
monqctl config current-context
monqctl config use-context <Name of context>