Docker-compose для создания веб-сервера

Рассмотрим сценарий, который позволит быстро развернуть простой веб-сервер в docker. В качестве компонентов мы будем использовать:

  • Веб сервер NGINX.
  • Интерпретатор сценариев PHP.
  • СУБД MariaDB.
  • Веб-интерфейс для управления базами данный phpMyAdmin.

Помимо этого, мы приведем пример минимальных настроек для работы данного сервера.

Подготовка

Подготовим операционную систему к работе.

1. Установка Docker.

Для запуска сценария нам необходимо установить docker и docker-compose. Для каждого типа Linux необходимо выполнить свой набор команд.

Подробнее процесс описан в инструкции Установка Docker на Linux .

2. Каталог для работы.

Создадим и перейдем в каталог, где будут находиться файлы веб-сервера и сам сценарий docker-compose.

mkdir /opt/webserver

cd /opt/webserver

Команды ниже будут выполняться из расчета, что мы находимся в созданном каталоге.

Мы готовы к созданию сценария.

Сценарий и настройка сервера

Создаем файл docker-compose:

vi docker-compose.yml

  1. services:
  2. web_nginx:
  3. image: nginx
  4. hostname: web_nginx
  5. container_name: web_nginx
  6. restart: unless-stopped
  7. environment:
  8. TZ: «Europe/Moscow»
  9. ports:
  10. — 80:80
  11. — 443:443
  12. volumes:
  13. — ./nginx/conf.d:/etc/nginx/conf.d
  14. — ./nginx/ssl:/etc/nginx/ssl
  15. — ./www_data:/usr/share/nginx/html
  16. web_php:
  17. build:
  18. context: ./php/
  19. args:
  20. buildno: 2023101101
  21. hostname: web_php
  22. container_name: web_php
  23. restart: unless-stopped
  24. user: root
  25. environment:
  26. TZ: «Europe/Moscow»
  27. volumes:
  28. — ./www_data:/var/www/html
  29. — ./php/php.ini:/usr/local/etc/php/php.ini
  30. web_db:
  31. image: mariadb
  32. hostname: web_db
  33. container_name: web_db
  34. restart: unless-stopped
  35. environment:
  36. TZ: «Europe/Moscow»
  37. MARIADB_DATABASE: website
  38. MARIADB_USER: website
  39. MARIADB_PASSWORD: website123
  40. MARIADB_ROOT_PASSWORD: root_password
  41. volumes:
  42. — ./mysql_data:/var/lib/mysql
  43. web_pma:
  44. image: phpmyadmin
  45. hostname: web_pma
  46. container_name: web_pma
  47. restart: unless-stopped
  48. environment:
  49. TZ: «Europe/Moscow»
  50. PMA_HOST: web_db
  51. UPLOAD_LIMIT: 50M
  52. ports:
  53. — 81:80

* сценарий создаст 4 контейнера:

  • web_nginx — веб-сервер, на базе nginx.
  • web_php — интерпретатор PHP.
  • web_db — сервер баз данных MariaDB.
  • web_pma — веб-инструмент для работы с базами данных MySQL/MariaDB.
5 — 18 Создаем контейнер веб-сервера nginx. В качестве образа используем одноименный nginx.
16 Конфигурационные файлы будут находится в каталоге nginx/conf.d хостовой машины (в каталоге с docker-compose.yml) и /etc/nginx/conf.d внутри контейнера.
17 Каталоги для хранения сертификатов.
18 Файлы веб-приложения — www_data на хосте docker и /usr/share/nginx/html внутри контейнера.
20 — 33 Контейнер с PHP.
21 — 24 Мы не будем брать готовый образ и сами соберем контейнер с использованием Dockerfile. Создание и описание последнего будет ниже в инструкции.
32 Как и для веб-сервера мы используем каталог www_data с рабочими файлами сайта, но пробрасываем их в каталог /var/www/html внутри контейнера.
33 Файл с настройками PHP.
35 — 47 Контейнер с базой данных MariaDB.
42 При инициализации будет создана база с именем website .
43 При инициализации будет создан пользователь с именем website .
44 Пароль пользователя website будет website123 .
45 Указываем пароль для суперпользователя root.
49 — 59 Контейнер с phpMyAdmin.
56 С помощью данной переменной окружения говорим, на каком контейнере запущена СУБД.
57 Разрешаем передачу файлов размером не более 50 Мб. По умолчанию ограничение в 2 Мб.
59 Обратите внимание, что данный контейнер мы вешаем на внешний 81 порт.

Создадим каталог для хранения Dockerfile — он нам нужен для сборки контейнера с PHP:

mkdir php

Создадим в данном каталоге файл Dockerfile:

vi php/Dockerfile

  1. FROM php:8.2-fpm
  2. MAINTAINER Dmitriy Mosk <master@remontka.com>
  3. ENV TZ=Europe/Moscow
  4. RUN apt update &&
  5. docker-php-ext-install mysqli

* с помощью данного файла будет собран контейнер с интерпретатором php и компонентом php-fpm, принимающим запросы на обработку скриптов.

1 В качестве базового образа берем php:8.2-fpm. Из его названия видно, что версия php будет 8.2. Меняем на версию, которая нужна, именно, вам.
7 — 8 Дополнительно установим php расширение mysqli . Как правило, для рабочего проекта нужно больше разрешений. Вы можете их перечислить через пробел.

Создадим конфигурационный файл php.ini:

vi php/php.ini

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE
short_open_tag = On
post_max_size = 1G
upload_max_filesize = 512M
date.timezone = «Europe/Moscow»

* где:

  • error_reporting — для продуктива лучше не отображать информацию об устаревших функциях (E_DEPRECATED), плохой совместимости кода (E_STRICT) и информации о потенциальных проблемах (E_NOTICE).
  • short_open_tag — позволяет использовать короткую нотацию для раскрытия блока код PHP.
  • post_max_size — максимальный объем данных, которые можно передать на сервер методом POST.
  • upload_max_filesize — максимальный объем загружаемого файла.
  • date.timezone — часовой пояс.

Создаем каталог:

mkdir -p nginx/conf.d

И создаем конфигурационный файл nginx для виртуального домена:

vi nginx/conf.d/remontka.com.conf

  1. server {
  2. listen 80;
  3. listen 443 ssl;
  4. server_name remontka.com;
  5. location ~ /.well-known {
  6. root /usr/share/nginx/html;
  7. allow all;
  8. }
  9. if ($scheme = ‘http’) {
  10. return 301 https://$host$request_uri;
  11. }
  12. ssl_certificate /etc/nginx/ssl/remontka.com.crt;
  13. ssl_certificate_key /etc/nginx/ssl/remontka.com.key;
  14. root /usr/share/nginx/html;
  15. error_log /var/log/nginx/error.log;
  16. index index.php;
  17. location / {
  18. try_files $uri $uri/ index.php;
  19. }
  20. location ~ .php$ {
  21. set $root_path /var/www/html;
  22. fastcgi_pass web_php:9000;
  23. fastcgi_index index.php;
  24. fastcgi_param SCRIPT_FILENAME $root_path$fastcgi_script_name;
  25. include fastcgi_params;
  26. fastcgi_param DOCUMENT_ROOT $root_path;
  27. }
  28. location ~* ^.+.(jpg|jpeg|gif|png|css|zip|tgz|gz|rar|bz2|doc|docx|xls|xlsx|exe|pdf|ppt|tar|wav|bmp|rtf|js)$ {
  29. expires modified +1w;
  30. }
  31. }

* данный файл описывает поведение и ответ веб-сервера nginx при обращении к домену remontka.com .

2 — 3 Сервер будет слушать на портах 80 и 443.
5 Указывает, для какого домена будет действовать данная настройка.
7 — 10 Данная настройка понадобится, если мы захотим получить бесплатный сертификат от Let’s Encrypt.
12 — 14 Перенаправляет запросы с http на https.
16 — 17 Пути до файлов сертификатов. Необходимы для работы https.
29 — 36 Данный блок описывает поведение nginx при обработке файлов с расширением php. В нашем примере запросы будут передаваться контейнеру web_php.

Создаем каталог для хранения сертификатов:

mkdir nginx/ssl

Генерируем самоподписанные сертификаты:

openssl req -new -x509 -days 1461 -nodes -out nginx/ssl/remontka.com.crt -keyout nginx/ssl/remontka.com.key -subj «/C=RU/ST=SPb/L=SPb/O=Global Security/OU=IT Department/CN=remontka.com/CN=www.remontka.com»

* данная команда сформирует ключи remontka.com.crt и remontka.com.key в каталоге nginx/ssl относительно нашей рабочей папки.

Для тестирования веб-сервера нам будет достаточно самозаверенного сертификата. Но для продуктивной среды лучше будет получить сертификаты от доверенного центра.

Сценарий для развертывания веб-сервера готов.

Запуск и тестирование

Для создания и запуска контейнеров выполняем команду:

docker-compose up -d

Запуск контейнеров займет какой-то время. Ждем.

Создадим файл:

vi www_data/index.php

<?php

phpinfo();

?>

Можно проверить работу сервера из командной строки:

curl -k https://127.0.0.1

Мы должны получить ответ в виде html-страницы с параметрами PHP.

Того же самого эффекта можно добиться в браузере, перейдя по адресу https://<IP-адрес хоста docker>. При получении предупреждения безопасности, игнорируем его.

Сертификат от Let’s Encrypt

Ранее мы настроили веб-сервер с самоподписанным сертификатом, но в рабочей среде нам нужен сертификат, которому доверяют многие системы. Проще всего использовать бесплатный сертификат от Let’s Encrypt. Для его получения сначала открываем наш файл docker-compose:

vi docker-compose.yml

И добавляем новый volume для контейнера web_nginx:

services:

web_nginx:

volumes:

— ./nginx/well-known/:/usr/share/nginx/html

* мы пробрасываем внутрь контейнера каталог nginx/well-known .

Теперь можно запустить команду:

docker run -it —rm —name certbot -v «/opt/webserver/nginx/ssl:/etc/letsencrypt» -v «/opt/webserver/nginx/well-known:/usr/share/nginx/html» certbot/certbot certonly —webroot —agree-tos —email postmaster@remontka.com —webroot-path /usr/share/nginx/html/ -d remontka.com -d www.remontka.com

* данная команда создаст временный контейнер, который запросит сертификат для домена remontka.com и его поддомена www.remontka.com. В качестве каталога, где будет размещен временный файл проверки будет использоваться /usr/share/nginx/html, который является каталогом /opt/webserver/nginx/well-known на хосте docker и также смотри в папку /usr/share/nginx/html внутри веб-контейнера web_nginx.

Если настройка выполнена верно, мы должны получить файлы сертификата, которые будут находиться в каталоге /opt/webserver/nginx/ssl/live/remontka.com . Пропишем новые сертификаты:

vi nginx/conf.d/remontka.com.conf

ssl_certificate /etc/nginx/ssl/live/remontka.com/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/live/remontka.com/privkey.pem;

Перечитаем конфигурацию веб-сервером. Сначала проверим ее:

docker exec web_nginx nginx -t

И если ошибок нет:

docker exec web_nginx nginx -s reload

Для продления сертификата используем команду:

docker run -it —rm —name certbot -v «/opt/webserver/nginx/ssl:/etc/letsencrypt» -v «/opt/webserver/nginx/well-known:/usr/share/nginx/html» certbot/certbot renew

Читайте также

Дополнительная информация по работе с docker и веб-серверами:

1. Создание собственного образа Docker .

2. Настройка веб-сервера в Docker (NGINX + PHP + MariaDB) .

3. Шпаргалка по работе с docker-compose .

4. Docker-compose для создания nginx entrypoint .

5. NGINX + Apache + MariaDB (MySQL) + PHP + PHP-FPM (fastCGI) + FTP + PHPMyAdmin + Memcached + Postfix на Ubuntu .

6. NGINX + Apache (httpd) + MariaDB (MySQL) + PHP + PHP-FPM (fastCGI) + FTP + PHPMyAdmin + Memcached + Postfix на CentOS 8 .

EnglishRussianUkrainian