Документация

Python

Python – язык программирования общего назначения, который можно интегрировать для работы сайтов и приложений.

Для добавления проект Python выполните шаги:

  1. Установите Python.
  2. Настройте пользователя.
  3. Создайте сайт для проекта с Python.
  4. Добавление проекта Python.
  5. Проверьте работоспособность.
Перед импортом пользователей с Python убедитесь, что на целевом сервере все нужные версии Python установлены.

Установка

Для включения:

  1. В Основном меню панели выберите Настройки.
  2. В раскрывшемся списке выберите Конфигурация ПО.
  3. На открывшейся форме выберите Python в списке и нажмите на кнопку Установить.

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

Настройка пользователя

После того как Python будет установлен на панель, добавьте права на использования пользователю, под которым будут добавляться проекты Python, для этого:

  1. В Основном меню выберите Пользователи.
  2. Выберите соответствующего пользователя и нажмите на кнопку Изменить.
  3. На открывшейся форме найдите секцию Доступ.
  4. Отметьте чекбос Python и нажмите на кнопку Сохранить.

После сохранения в столбце Состояние пользователя будет отображаться иконка Python.

Создание сайта для проекта с Python

Теперь необходимо создать сайт с обработчиком Python, для этого:

  1. В Основном меню выберите Сайты.
  2. На открывшейся форме нажмите на кнопку Создать сайт.
  3. Выберите вкладку Расширенные настройки (подробное описание настроек см. Создание сайта) и заполните необходимые поля. Ниже представлены важные поля при создании сайта с проектом Python:
    • секция Основные настройки:
      • Доменное имя – имя сайта;
      • Директория сайта – путь к директории сайта. Указывается относительно домашней директории владельца;
      • Псевдоним сайта – дополнительные имена вашего сайта (необязательное поле);
      • Обработчик – выберите Python;
      • SSL-сертификат – сертификат для данного сайта. Вы можете указать существующий сертификат из списка либо создать новый самоподписанный сертификат;
      • IP-адрес – список IP-адресов, за которыми закреплен сайт;
      • Владелец сайта – выберите из списка необходимого пользователя;
      • Сайт по умолчанию (чекбокс) – если сайт является сайтом по умолчанию, то запрос по не зарегистрированному на этом Web-сервере доменному имени (в том числе запрос по IP-адресу) на любой из назначенных этому сайту IP-адресов будет обрабатываться именно этим сайтом;
    • секция Обработчик (Python):
      • Режим работы Python:
        • CGI (Apache + Python) – вызовом интерпретатора Python занимается Apache2, код будет выполнен при обращении непосредственно к файлу;
        • Web-сервер Python – некоторым пакетам Python необходимо настроить сервер (например, Django). Выполните настройку после того, как будет установлен соответсвующий пакет:
          • Путь к серверу – путь к файлу сервера приложения относительно домашней директории сайта;
          • Аргументы сервера – список аргументов, которые будут переданы серверу при запуске;
          • Способ подключения (выбор способа доступен только при выборе режима работы Сервер Python):
            • Порт – будет назначен свободный непривилегированный порт для сайта;
            • Сокет – сайт будет работать через сокет.
        • Версия Python – выберите необходимую версию Python.
  4. Нажмите на кнопку Создать.

На вкладке Сайты будет добавлен созданный сайт, у которого в столбце Параметры будет отображаться иконка Python.

Добавление проекта Python

Добавьте свой проект Python в созданный сайт, для этого:

  1. В Основном меню выберите Сайты.
  2. Выберите необходимый сайт и нажмите на кнопку Файлы сайта.
  3. На открывшейся форме Менеджер файлов нажмите Загрузить.
  4. Выберите, откуда необходимо загрузить файлы:
    • Файл с локального компьютера – нажмите на кнопку Выбрать файл или переместите необходимые файлы в зону drag-and-drop;
    • URL файла на другом сервере:
      • URL – ссылка на файл, который будет загружен, например, http://example.com/dir/file.html;
      • Имя файла – имя файла, с которым будет сохранен в текущем каталоге. Если оставить это поле пустым, имя файла будет выделено из URL.
  5. Укажите необходимые пакеты в файле requirements.txt.
  6. Нажмите на кнопку Вернуться к списку сайтов.
  7. Нажмите на кнопку ““ и выберите Установка пакетов Python.
    Python выполнит установку всех указанных пакетов вашего проекта. Процесс установки отображается серой иконкой Python в столбце параметров сайта.
  8. После выполнения установки нажмите на кнопку ““ и выберите Перезапустить (Python).
    Буде выполнен перезапуск проекта; иконка Python станет зеленого цвета, что означает правильную работу проекта.
Если вы установили пакет Python, который требует настройки Web-сервера:
  1. Выполните настройку сайта, нажав на кнопку Редактировать.
  2. Перейдите в раздел Обработчик и заполните поля для Web-сервер Python.
  3. После заполнения полей нажмите на кнопку Сохранить.
  4. Если необходимо, выполните настройку установленного пакета Python.

Проверка работоспособности

Для проверки работоспособности:

  • если на ПК установлена ОС семейства Unix, то добавьте в файл /etc/hosts запись вида:
    1.1.1.1 example.ru
    Где:
    • 1.1.1.1 — IP-адрес вашего сервера;
    • example.ru — имя сайта;
  • если на ПК установлена ОС Windows, то добавьте в файл C:\windows\system32\drivers\etc\hosts запись вида:
    1.1.1.1 example.ru
    Где:
    • 1.1.1.1 — IP-адрес вашего сервера;
    • example.ru — имя сайта.

Введите в браузере имя сайта для проверки корректности создания.