Jelastic CLI

Для того чтобы установить Jelastic CLI на локальный компьютер необходимо в терминале выполнить следующую команду:

curl -s ftp://ftp.jelastic.com/pub/cli/jelastic-cli-installer.sh | bash

• заранее убедитесь, что у вас установлена Java версии 1.7 и выше;

• в случае, если вы используете операционную систему Windows, вам необходимо сначала установить Unix-подобную среду и интерфейс командной строки для Microsoft Windows (например Cygwin), с помощью которого вы сможете выполнить все необходимые команды.

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

~ $ touch /home/name/.config/jelastic/jelastic.properties

где {name} — имя вашей директории.

Jelastic CLI представляет собой исполняемый .jar архив и ряд предварительно сконфигурированных команд (bash скриптов) для его работы. С их помощью вы сможете контролировать, управлять и автоматизировать работу вашего окружения.

1. 1

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

   ~/jelastic/environment/control/getenvs

   Далее укажите следующие значения:

   Platform URL — app.jelastic.regruhosting.ru;
   Email — логин (email) вашей учетной записи;
   Password — пароль учетной записи.
   

   Если введенные данные верны, вы увидите логотип Jelastic и версию используемой в данный момент платформы:

   

   Аутентификация может быть также инициирована вручную ( например, если вам нужно переключить текущий сеанс или войти под другим пользователем ) соответствующей командой:

   ~/jelastic/users/authentication/signin --login {email} --password {password} --platformUrl {platform_url}

   В данном случае, выделенные строки должны быть заменены соответствующими параметрами учетной записи (которые описаны выше):

   

   Если вход произведен успешно, полученный ответ будет включать в себя параметр: «result»: 0

   Информация об актуальной сессии пользователя (т.е адрес платформы и ваши учетные данные) хранятся в автоматически генерируемом файле ~/.config/jelastic/jelastic.properties, которые извлекаются при необходимости. Это позволяет сконцентрироваться на выполняемых операциях без повторения шага авторизации.

1. 2

   если вы ранее не сталкивались с Jelastic API, вам потребуется информация о структуре интерфейса командной строки. Вы можете получить доступ к справочной информации, выполнив команду:

   ~/jelastic/jelastic-help

   

1. 3

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

   ls ~/jelastic/environment/control

   Каждая из представленных функций легко может быть инициирована с помощью указания полного пути до нее:

   

2. 4

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

   

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

Обеспечивая полнофункциональное дистанционное управление, Jelastic CLI работает со всеми типами окружений и приложений, и поддерживает все необходимые операции, от самых простых до самых сложных. Ниже приведены несколько примеров его использования:

Запуск/Остановка окружения

Наиболее распространенными операциями для управления окружением являются его запуск и остановка.

1. 1

   для того чтобы остановить окружение, выполните следующую команду:

   ~/jelastic/environment/control/stopenv --envName {env_name}

   где {env_name} — название окружения.

   

   Ответ «result»: 0 означает, что операция прошла успешно и без ошибок;

1. 2

   для запуска окружения необходимо выполнить следующую команду:

   ~/jelastic/environment/control/startenv --envName {env_name}

   

Переустановка Docker-контейнера

Окружения основанные на Docker-стандарте также полностью поддерживают интерфейс командной строки. В качестве примера рассмотрим обновление версии шаблона для одного контейнера или одновременно для группы контейнеров.

1. 1

   для начала узнаем список доступных версий для шаблона:

   ~/jelastic/environment/control/getdockertags --image {template_name} [--userName {login}] [--password {password}]

   где {template_name} — идентификатор шаблона;
   {login} и {password} — необязательные параметры, указываются в случае использования пользовательского репозитория.

   Если соответствующий шаблон находится в Hub-регистре, имя хоста может быть пропущено (в нашем случае jelastic/wordpress-db). В противном случае потребуется указание полного имени:

   

   В нашем случае доступны две версии шаблона: default и latest;

1. 2

   далее вам необходимо узнать уникальные идентификаторы узлов с помощью команды:

   ~/jelastic/environment/control/getenvinfo --envName {env_name} | grep -B 5 {image} | grep id

   В нашем примере доступен один контейнер с указанным шаблоном:

   

1. 3

   далее выберите контейнер, который вы хотите обновить:

   ~/jelastic/environment/control/redeploycontainerbyid --envName {env_name} --nodeId {node_id} --tag {tag}

   где {env_name} — название окружения;
   {node_id} — идентификатор узла, который должен быть обновлен;
   {tag} — версия шаблона.
   

   Если вам потребуется обновить версию шаблона для группы контейнеров, необходимо использовать следующую команду:

   ~/jelastic/environment/control/redeploycontainersbygroup --envName {env_name} --nodeGroup {group_id} --tag {tag} [--sequential {true/false}]

   где {group_id} — идентификатор группы узлов (его можно узнать, выполнив приведенную во втором пункте команду с указанием параметра -A 30 {image} | grep nodeGroup).
   sequential — является не обязательной опцией (определяет значение true/false) Это позволяет остальным узлам продолжать обрабатывать входящие запросы, в то время как запускается обновление, для обеспечения доступности услуг.

   Этот процесс может занять несколько минут, дождитесь пока он будет завершен: