Обзор развертывания nginx-certbot на сервере¶
Предварительные требования¶
Для корректной работы приложения требуются следующие условия:
-
Установленный Docker и Docker Compose.
-
Доступ к портам 80 (HTTP) и 443 (HTTPS).
-
Наличие прав суперпользователя (
root) для создания директорий и управления контейнерами.
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение |
|---|---|
| Префикс | nginx-certbot |
| Домен | hostkey.in |
| Полный шаблон | nginx-certbot{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
Все основные файлы конфигурации и данные приложения сосредоточены в директории /data/nginx/:
-
/data/nginx/docker-compose.yml— файл для развертывания контейнера. -
/data/nginx/user_conf.d/— каталог с пользовательскими конфигурациями Nginx. -
/data/nginx/nginx-certbot.env— файл с переменными окружения. -
/etc/letsencrypt/— содержимое томаnginx_secrets, где хранятся SSL-сертификаты.
Процесс установки приложения¶
Процесс развертывания включает в себя следующие этапы:
-
Подготовка системных директорий: создаются папки
/data,/data/nginxи/data/nginx/user_conf.d. -
Настройка локального разрешения имен: в файл
/etc/hostsдобавляется запись для доменаnginx-certbot{Server_ID_from_Invapi}.hostkey.in, указывающая на127.0.0.1. -
Генерация конфигурационных файлов: создаются файлы
docker-compose.yml, файл настроек Nginx и файл переменных окружения.envв директории/data/nginx/. -
Создание Docker-тома
nginx_secretsдля безопасного хранения сертификатов. -
Запуск приложения через Docker Compose из директории
/data/nginx/.
Права доступа и безопасность¶
-
Директория
/data/nginx/и её подкаталоги имеют владельцаrootи группуroot. -
Права доступа на файлы конфигурации установлены в режиме
0644. -
Права доступа на директории установлены в режиме
0640.
Контейнеры Docker и их запуск¶
Приложение развертывается с использованием одного основного контейнера через Docker Compose.
nginx¶
-
Имя образа:
jonasal/nginx-certbot:latest -
Порты:
-
80:80(HTTP) -
443:443(HTTPS) -
Тома (volumes):
-
nginx_secrets:/etc/letsencrypt— для хранения сертификатов Let's Encrypt. -
./user_conf.d:/etc/nginx/user_conf.d— для пользовательских конфигураций сервера. -
Переменные окружения:
-
CERTBOT_EMAIL=hkadm@hostkey.com -
Политика перезапуска:
unless-stopped.
Инструкция по обновлению приложения¶
Для обновления приложения необходимо выполнить следующие действия:
-
Перейти в директорию с конфигурацией:
-
Подтянуть актуальные образы и перезапустить контейнер: