Обзор развертывания Dokku на сервере¶
Предварительные требования¶
Для успешного развертывания приложения требуются следующие условия:
-
Операционная система: Ubuntu.
-
Права доступа: права суперпользователя (root) для установки системных пакетов и выполнения скриптов.
-
Доступ к сети: возможность загрузки файлов с внешних ресурсов (dokku.com).
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение | | Префикс | dokku | | Домен | hostkey.in | | Полный шаблон | dokku{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
В процессе работы системы создаются и используются следующие директории:
-
/tmp/bootstrap.sh— временный файл установочного скрипта. -
/root/nginx— рабочая директория для управления контейнером Nginx с поддержкой SSL. -
/data/nginx/user_conf.d— каталог для хранения конфигурационных файлов веб-сервера. -
/data/nginx/nginx-certbot.env— файл с переменными окружения для Certbot.
Процесс установки приложения¶
Установка Dokku версии v0.38.34 выполняется в несколько этапов:
-
Настройка сетевого окружения: в файл
/etc/hostsдобавляется запись, связывающая имя хоста с адресом127.0.0.1, что необходимо для корректной инициализации Dokku. -
Загрузка установщика: скачивается официальный установочный скрипт
bootstrap.sh. -
Выполнение установки: запускается скрипт установки с указанием конкретной версии приложения.
-
Настройка домена: устанавливается глобальный домен для управления через команду
dokku domains:set-global. -
Установка зависимостей: выполняется команда для загрузки и настройки необходимых компонентов ядра (core dependencies).
Права доступа и безопасность¶
-
Для работы веб-сервера используется директория
/root/nginxс правами доступа0755. -
Конфигурационные файлы в
/root/nginx/compose.ymlимеют права0644. -
Устанавливаются системные зависимости для обеспечения безопасности и корректной работы ядра Dokku.
Контейнеры Docker и их запуск¶
Для управления SSL-сертификатами используется контейнер Nginx с поддержкой Certbot:
| Параметр | Значение |
|---|---|
| Имя образа | jonasal/nginx-certbot:latest |
| Режим сети | host |
| Политика перезапуска | unless-stopped |
Переменная CERTBOT_EMAIL | hkadm@hostkey.com |
| Том (volumes) | nginx_secrets:/etc/letsencrypt |
| Том (volumes) | /data/nginx/user_conf.d:/etc/nginx/user_conf.d |
Инструкция по обновлению приложения¶
Для обновления Dokku необходимо выполнить повторный запуск установочного скрипта с указанием нужной версии: