W tym artykule chcę podzielić się z Tobą metodą tworzenia certyfikatu SSL dla Twojej aplikacji internetowej działającej w Dockerze, ponieważ... W rosyjskojęzycznej części Internetu nie znalazłem takiego rozwiązania.
Więcej szczegółów pod rozcięciem.
Mieliśmy docker v.17.05, docker-compose v.1.21, Ubuntu Server 18 i kufel czystego Let'sEncrypt. Nie chodzi o to, że konieczne jest wdrożenie produkcji na Dockerze. Ale kiedy zaczniesz budować Dockera, trudno będzie przestać.
Na początek podam więc standardowe ustawienia - jakie mieliśmy na etapie deweloperskim, tj. bez portu 443 i ogólnie SSL:
docker-compose.yml
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;
}
Następnie faktycznie musimy wdrożyć SSL. Szczerze mówiąc, spędziłem około 2 godzin studiując strefę com. Wszystkie oferowane tam opcje są interesujące. Ale na obecnym etapie projektu my (firma) musieliśmy szybko i niezawodnie wkręcić SSL Let'sEnctypt к nginx pojemnik i nic więcej.
Przede wszystkim zainstalowaliśmy go na serwerze certbot
sudo apt-get install certbot
Następnie wygenerowaliśmy certyfikaty wieloznaczne dla naszej domeny
sudo certbot certonly -d stomup.ru -d *.stomup.ru --manual --preferred-challenges dns
po wykonaniu certbot dostarczy nam 2 rekordy TXT, które należy określić w ustawieniach DNS.
_acme-challenge.stomup.ru TXT {тотКлючКоторыйВамВыдалCertBot}
I naciśnij Enter.
Następnie certbot sprawdzi obecność tych rekordów w DNS i utworzy dla Ciebie certyfikaty.
jeśli dodałeś certyfikat ale certbot nie znalazłem - spróbuj ponownie uruchomić polecenie po 5-10 minutach.
Cóż, jesteśmy dumnymi posiadaczami certyfikatu Let'sEncrypt przez 90 dni, ale teraz musimy przesłać go do Dockera.
Aby to zrobić w najbardziej banalny sposób, w docker-compose.yml, w sekcji nginx, łączymy katalogi.
Przykład docker-compose.yml z 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"
Połączony? Świetnie – kontynuujmy:
Teraz musimy zmienić konfigurację nginx pracować z 443 portu i SSL ogólnie:
Przykładowa konfiguracja pliku main.conf z 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;
}
}
Właściwie po tych manipulacjach wchodzimy do katalogu z Docker-compose, piszemy docker-compose up -d. Sprawdzamy także funkcjonalność protokołu SSL. Wszystko powinno wystartować.
Najważniejsze, aby nie zapomnieć, że certyfikat Let'sEnctypt jest wydawany na 90 dni i trzeba będzie go odnowić za pomocą polecenia sudo certbot renew, a następnie uruchom ponownie projekt za pomocą polecenia docker-compose restart
Inną opcją jest dodanie tej sekwencji do pliku crontab.
Moim zdaniem jest to najłatwiejszy sposób połączenia protokołu SSL z aplikacją Docker Web.
PS Proszę wziąć pod uwagę, że wszystkie skrypty zaprezentowane w tekście nie są ostateczne, projekt jest obecnie na etapie głębokiego Dev, dlatego bardzo proszę o nie krytykowanie konfiguracji - będą one wielokrotnie modyfikowane.
Źródło: www.habr.com