У цій статті я хочу поділитися з вами способом створення SSL сертифіката для вашого веб-застосунку, що працює на Docker, т.к. у російськомовній частині інтернету — такого рішення я не знайшов.
Докладніше під катом.
Ми мали docker v.17.05, docker-compose v.1.21, Ubuntu Server 18 і пінта чистого Let'sEncrypt. Не те що обов'язково потрібно було розгортати продакшен на Docker. Але якщо почав збирати Docker, стає важко зупинитись.
Отже, для початку наведу стандартні налаштування — які у нас були на етапі dev, тобто. без 443 порту та SSL в цілому:
докер-компост.імл
version: '2'
services:
php:
build: ./php-fpm
volumes:
- ./StomUp:/var/www/StomUp
- ./php-fpm/php.ini:/usr/local/etc/php/php.ini
depends_on:
- mysql
container_name: "StomPHP"
web:
image: nginx:latest
ports:
- "80:80"
- "443:443"
volumes:
- ./StomUp:/var/www/StomUp
- ./nginx/main.conf:/etc/nginx/conf.d/default.conf
depends_on:
- php
mysql:
image: mysql:5.7
command: mysqld --sql_mode=""
environment:
MYSQL_ROOT_PASSWORD: xxx
ports:
- "3333:3306"
nginx/main.conf
server {
listen 80;
server_name *.stomup.ru stomup.ru;
root /var/www/StomUp/public;
client_max_body_size 5M;
location / {
# try to serve file directly, fallback to index.php
try_files $uri /index.php$is_args$args;
}
location ~ ^/index.php(/|$) {
#fastcgi_pass unix:/var/run/php7.2-fpm.sock;
fastcgi_pass php:9000;
fastcgi_split_path_info ^(.+.php)(/.*)$;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
fastcgi_param DOCUMENT_ROOT $realpath_root;
fastcgi_buffer_size 128k;
fastcgi_buffers 4 256k;
fastcgi_busy_buffers_size 256k;
internal;
}
location ~ .php$ {
return 404;
}
error_log /var/log/nginx/project_error.log;
access_log /var/log/nginx/project_access.log;
}
Далі саме нам потрібно продати SSL. Чесно сказати - студіював com зону я порядку годин 2-х. Усі запропоновані варіанти там цікаві. Але на поточному етапі проекту, нам (бізнесу) потрібно було швидко і надійно прикрутити SSL Let'sEnctypt к Nginx контейнеру і трохи більше.
Насамперед ми встановили на сервер Certbot
sudo apt-get install certbot
Далі ми згенерували сертифікати wildcard для нашого домену
sudo certbot certonly -d stomup.ru -d *.stomup.ru --manual --preferred-challenges dns
після виконання certbot надасть нам 2 TXT записи, які потрібно вказати у налаштуваннях DNS.
_acme-challenge.stomup.ru TXT {тотКлючКоторыйВамВыдалCertBot}
Та натискаємо enter.
Після цього certbot перевірить наявність цих записів у DNS і створить вам сертифікати.
якщо ви додали сертифікат, але Certbot його не знайшов - спробуйте перезапустити команду через 5-10 хвилин.
Ну ось ми і горді власники Let'sEncrypt сертифіката на 90 днів, але тепер нам потрібно його прокинути в Docker.
Для цього найбанальнішим чином у docker-compose.yml, у секції nginx - приліковковуємо директорії.
Приклад docker-compose.yml із SSL
version: '2'
services:
php:
build: ./php-fpm
volumes:
- ./StomUp:/var/www/StomUp
- /etc/letsencrypt/live/stomup.ru/:/etc/letsencrypt/live/stomup.ru/
- ./php-fpm/php.ini:/usr/local/etc/php/php.ini
depends_on:
- mysql
container_name: "StomPHP"
web:
image: nginx:latest
ports:
- "80:80"
- "443:443"
volumes:
- ./StomUp:/var/www/StomUp
- /etc/letsencrypt/:/etc/letsencrypt/
- ./nginx/main.conf:/etc/nginx/conf.d/default.conf
depends_on:
- php
mysql:
image: mysql:5.7
command: mysqld --sql_mode=""
environment:
MYSQL_ROOT_PASSWORD: xxx
ports:
- "3333:3306"
Прилінкували? Супер - продовжуємо:
Тепер нам потрібно змінити конфіг Nginx на роботу з 443 портом та SSL в цілому:
Приклад конфігу main.conf із SSL
#
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name *.stomup.ru stomup.ru;
set $base /var/www/StomUp;
root $base/public;
# SSL
ssl_certificate /etc/letsencrypt/live/stomup.ru/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/stomup.ru/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/stomup.ru/chain.pem;
client_max_body_size 5M;
location / {
# try to serve file directly, fallback to index.php
try_files $uri /index.php$is_args$args;
}
location ~ ^/index.php(/|$) {
#fastcgi_pass unix:/var/run/php7.2-fpm.sock;
fastcgi_pass php:9000;
fastcgi_split_path_info ^(.+.php)(/.*)$;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
fastcgi_param DOCUMENT_ROOT $realpath_root;
fastcgi_buffer_size 128k;
fastcgi_buffers 4 256k;
fastcgi_busy_buffers_size 256k;
internal;
}
location ~ .php$ {
return 404;
}
error_log /var/log/nginx/project_error.log;
access_log /var/log/nginx/project_access.log;
}
# HTTP redirect
server {
listen 80;
listen [::]:80;
server_name *.stomup.ru stomup.ru;
location / {
return 301 https://stomup.ru$request_uri;
}
}
Власне після цих маніпуляцій йдемо до директорії з Docker-compose, пишемо docker-compose up -d. І перевіряємо працездатність SSL. Повинне все злетіти.
Головне не забувайте, що Let'sEnctypt сертифікат видається на 90 днів і вам необхідно буде його оновити через команду sudo certbot renew
, а потім перезапустити проект командою docker-compose restart
Як варіант - додати цю послідовність до crontab.
На мій погляд, це найпростіший спосіб підключення SSL до Docker Web-app.
PS Прошу взяти до уваги, що всі скрипти представлені в тексті - не остаточні, зараз проект знаходиться на стадії глибокого Dev, тому хочу вас попросити не критикувати конфіги - вони ще багато разів видозмінюватимуться.
Джерело: habr.com