Скрипты позволяют автоматически настраивать виртуальные машины: устанавливать программное обеспечение, изменять конфигурационные файлы и т. д. По умолчанию доступны скрипты из репозитория ISPsystem.

На ОС семейства Linux вы можете запустить Shell-скрипты на языке bash, на ОС Windows — Powershell-скрипты.

Вы можете задать параметры для скрипта. При запуске скрипта значения параметров нужно будет вводить вручную или выбирать из списка. В качестве параметров, которые нужно вводить вручную, можно использовать переменные. Тогда при запуске скрипта в поле ввода параметра будет отображено значение переменной.

Обратите внимание!

Значение встроенной переменной PASS, содержащей пароль root-пользователя, нельзя будет изменить при запуске скрипта. Используйте собственную переменную или параметр для передачи пароля в скрипт.

Создание скрипта

Чтобы создать собственный скрипт:

  1. Перейдите в Скрипты → Создать скрипт.
  2. Укажите Название скрипта.
  3. Укажите Краткое описание скрипта. Оно отображается в списке скриптов.
  4. Укажите Фильтры для выполнения скрипта. Скрипт доступен для запуска на ВМ при совпадении условий всех фильтров.
  5. Если нужно, добавьте Параметры скрипта:
    1. Нажмите Добавить параметр.

    2. Укажите Название параметра и его Описание. Если в качестве параметра вы используете имя переменной, её описание добавится автоматически.

    3. Вы можете задать значения параметра, которые будут предлагаться при запуске скрипта. Чтобы сделать это, нажмите Добавить:

      1. Укажите Значение параметра и Описание значения.

      2. Чтобы добавить больше параметров, нажмите Добавить ещё значение. В правой части окна вы можете посмотреть как будет выглядеть форма выбора параметра.

        Пример формы

      3. Нажмите Добавить.
    4. Для обязательного параметра включите опцию Сделать обязательным.
    5. Чтобы добавить в скрипт больше параметров, нажмите Добавить ещё параметр в скрипт.
  6. Выберите Тип скрипта:
    • Shell скрипт — для ОС семейства Linux;
    • Powershell скрипт — для ОС Windows.

  7. Введите тело Скрипта в окне редактора. Чтобы развернуть окно редактора на весь экран, нажмите . Для возврата в оконный режим нажмите . В редакторе есть функция автодополнения. Например, если вам нужно вставить в скрипт имя переменной или параметра, начните ввод и редактор предложит варианты окончания.

    Обратите внимание!

    Внешние переменные и параметры указываются в скрипте в формате ($NAME), где NAME — имя переменной. Например, для записи IP-адреса ВМ в файл можно использовать команду echo ($IP) >> /tmp/ip.txt.

  8. Чтобы после выполнения скрипта на почту пользователю было отправлено письмо, нажмите Добавить в разделе Уведомление на E-mail.
  9. По умолчанию предлагается настроить шаблон письма на английском языке — Письмо для EN.
  10. Введите Тему письма.
  11. Далее укажите содержание письма в поле Контент. В этом поле вы можете использовать те же переменные и параметры, что вы использовали в скрипте. Подробнее о создании шаблонов писем см. Шаблоны писем в скриптах.
  12. Для предварительного просмотра письма нажмите Предпросмотр.
  13. Если нужен шаблон письма на русском языке, нажмите Добавить письмо для RU. Если какой-либо из шаблонов вам не нужен, нажмите Удалить письмо для RU/Удалить письмо для EN.
  14. Нажмите Создать.

Операции со скриптами

Чтобы изменить настройки скрипта, перейдите в Скрипты → выберите скрипт → меню → Редактировать.

Чтобы запустить скрипты на ВМ, перейдите в Виртуальные машины → выберите ВМ → меню → Запустить скрипт → выберите скрипты → введите параметры скриптов → выберите порядок выполнения скриптов в колонке "Приоритет запуска" → Запустить скрипт. Подробнее см. в статье Запуск скриптов на ВМ.

Чтобы остановить запущенный скрипт, нажмите image2021-2-9_10-22-27.png в карточке ВМ или списке задач.