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

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

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

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

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

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


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

  1. Перейдите в Скрипты → Создать скрипт.
  2. Укажите Название скрипта.
  3. Выберите Владельца скрипта. Только владелец сможет изменить скрипт.
  4. Выберите, кому разрешён Доступ к образу:
    • Владельцу;
    • Всем.
  5. Если нужно, включите опцию Скрывать содержимое скрипта. Тогда только владелец скрипта и администраторы платформы смогут просматривать код скрипта и создавать его копии.
  6. Укажите Краткое описание скрипта. Оно отображается в списке скриптов.
  7. Укажите Фильтры для выполнения скрипта. Скрипт доступен для запуска на ВМ при совпадении условий всех фильтров. Фильтр Теги ОС является обязательным, остальные — опциональными. Подробнее см. в статье Фильтры для выполнения скриптов.
  8. Если нужно, добавьте Параметры скрипта:
    1. Нажмите Добавить параметр.
    2. Укажите Название параметра и его Описание. Если в качестве параметра вы используете имя переменной, её описание добавится автоматически.

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

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

        Пример формы

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

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

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

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

Пример создания скрипта


Пример создания шаблона письма

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


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

Чтобы изменить настройки доступа к скрипту из репозитория ISPsystem, перейдите в Скрипты → выберите скрипт → меню → Информация.

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

Чтобы остановить запущенный скрипт, нажмите в карточке ВМ или списке задач.