.env файл

Чтобы запустить контейнеризированную версию платформы Navixy, .env файл является основным конфигурационным файлом. Он содержит такие важные параметры, как учетные данные базы данных, доменные имена, рабочая папка установки платформы и другие.

Параметр .env файл в основном используется во время начальной установки платформы. Тем не менее, если вам нужно изменить что-либо в конфигурации уже существующей платформы, вам также потребуется изменить этот файл.

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

Если вы измените какие-либо настройки конфигурации в то время, когда экземпляр уже работает, изменения не применяются мгновенно. Необходимо реинициализировать весь экземпляр, чтобы они вступили в силу. Для этого из основной папки платформы (navixy-package) выполните команду: docker compose up -d Это пересоздаст контейнеры с новыми настройками.

UID и GID

Это служебные параметры, используемые только на этапе сборки платформы. Вам не нужно их менять.

WORKDIR

Это параметр, указывающий рабочую директорию платформы — где хранятся база данных и все файлы сервисов. Необходимо обеспечить безопасность этой директории, чтобы избежать потери бизнес-данных.

Значение этого параметра по умолчанию: WORKDIR=./work.

Это означает, что /work директория внутри распакованной сборки Navixy используется. Если директория не существует, она будет создана.

При необходимости вы можете разместить рабочую директорию в любом месте вашей системы. Для этого укажите полный путь к директории. Примеры:

• /home/admin/work

• /usr/local/navixy

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

navixy_username

Это имя пользователя, используемое для доступа к базе данных. Оно всегда navixy, не изменяйте его.

navixy_passwd

Это пароль для пользователя базы данных navixy . По умолчанию это значение пусто, и от вас требуется указать желаемый пароль. Рекомендуется автоматически сгенерировать надежный пароль, но выбор за вами — вы можете указать любой желаемый пароль.

Не меняйте этот пароль после того, как база данных создана и платформа развернута.

service_domain

Это основной домен вашего экземпляра платформы. Он используется для:

• Доступа к пользовательскому интерфейсу.

• Активации устройств.

В случае, если вы используете установку с одним доменом (без отдельных доменов для API и панели администратора), этот домен также будет использоваться для:

• Доступа к API по ссылке service_domain/api

• Доступа к панели администратора по ссылке service_domain/panel

Это также может быть IP-адрес вашего сервера, если вы не собираетесь использовать доменное имя для вашего сервиса.

api_domain

Этот параметр является необязательным и используется только для установки с тремя доменами.

Здесь необходимо указать доменное имя, используемое для доступа к API вашей платформы.

panel_domain

Это также необязательный параметр, используемый для установки с тремя доменами.

Здесь необходимо указать доменное имя, используемое для доступа к панели администратора вашей платформы.

le_enabled

Этот параметр активирует автоматическую выдачу и последующую перевыдачу SSL-сертификата Let's Encrypt.

По умолчанию он true . Это означает, что при развертывании платформы будет настроен Certbot, который будет автоматически управлять выдачей SSL-сертификатов для ваших доменов. Таким образом, вам не придется беспокоиться о покупке сторонних сертификатов. Экземпляр настроится для работы с SSL-защитой.

Если вы хотите использовать собственный SSL-сертификат вместо Let's Encrypt, измените этот параметр на false.

le_email

Это адрес электронной почты для получения информации о работе Certbot, такой как истечение срока действия сертификата, отзыв сертификата и проблемы, которые могут привести к невозможности перевыпустить сертификат.

По умолчанию этот параметр пуст. Рекомендуется указать действительный адрес электронной почты, чтобы вы не пропустили важные уведомления о SSL-защите вашего сайта.

redirect_to_https

Эта настройка позволяет перенаправлять запросы с http на https. Если ваша платформа настроена для использования SSL-защиты и кто-то пытается использовать URL, начинающийся с http, будет выполнено автоматическое перенаправление на https .

Если параметр отключен (false), перенаправление не будет выполняться, и сайт не откроется.

Этот параметр применим только в случае, если SSL-защита включена и SSL-сертификат установлен.

service_ssl_cert and service_ssl_key

Если вы не планируете использовать Let's Encrypt и хотите вместо этого использовать собственный SSL-сертификат, вам необходимо поместить сертификат для вашего домена и его приватный ключ в директорию: WORKDIR/nginx/ssl.

Обязательно переключите le_enabled параметр на false прежде чем вносить какие-либо изменения в этот раздел. Вы не можете использовать собственные сертификаты для платформы, когда certbot запущен.

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

service_ssl_cert=my_domain_com.crt
service_ssl_key=my_domain_com.key

MYSQL_RANDOM_ROOT_PASSWORD

Этот параметр включает генерацию случайного пароля для MySQL root пользователя. Значение по умолчанию — true.

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

Если вы предпочитаете задать конкретный пароль root для MySQL, измените значение на false и перейдите к следующему параметру.

MYSQL_ROOT_PASSWORD

Здесь вы указываете root-пароль для MySQL.

Этот параметр применяется только когда MYSQL_RANDOM_ROOT_PASSWORD переключен на false. В противном случае значение игнорируется.

skip_db_update

Этот параметр отключает обновление базы данных при запуске контейнера navixy-standalone-db . Он используется в тестовых целях, вам не нужно менять значение по умолчанию (false) во время обычного использования платформы.