SSL certifikát pre Docker web-app

V tomto článku chcem zdieľať spôsob vytvorenia SSL certifikátu pre vašu webovú aplikáciu bežiacu na Docker, pretože v slovenskej časti internetu som nenašiel podobné riešenie.

Viac informácií pod katom.

Mal som docker v.17.05, docker-compose v.1.21, Ubuntu Server 18 a čistý Let’sEncrypt. Nie je potrebné zavádzať produkciu na Docker. Ale ak ste začali s Dockerom, ťažko sa zastaviť.

Na začiatok uvediem štandardné nastavenia, ktoré sme mali v fáze dev, teda bez portu 443 a SSL v celku:

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 \/ {
        # snažte sa priamo obslúžiť súbor, ak nie, prejdite na 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;
}

Ďalej potrebujeme realizovať SSL. Úprimne povedané, študoval som zónu com asi 2 hodiny. Všetky navrhnuté možnosti sú zaujímavé. Ale v súčasnej fáze projektu, potrebujeme (biznis) rýchlo a spoľahlivo pripojiť SSL Let’sEncrypt k nginx k oceánu a nič viac.

Na prvom mieste sme nainštalovali na server certbot
sudo apt-get install certbot

Potom sme vygenerovali wildcard certifikáty pre našu domény

sudo certbot certonly -d stomup.ru -d *.stomup.ru --manual --preferred-challenges dns

po vykonaní certbot nám poskytne 2 TXT záznamy, ktoré je potrebné zadať v nastaveniach DNS.

_acme-challenge.stomup.ru TXT {tenKľúč, KtorýVámVydalCertBot}

A stlačíme enter.

Potom certbot skontroluje existenciu týchto záznamov v DNS a vytvorí pre vás certifikáty.
ak ste pridali certifikát, ale certbot nenašiel ho — skúste reštartovať príkaz o 5-10 minút.

Takže sme hrdi na to, že máme certifikát Let’sEncrypt na 90 dní, ale teraz ho musíme pripojiť k Dockeru.

Pre toto jednoducho v súbore docker-compose.yml, v sekcii nginx, prepojte adresáre.

Príklad docker-compose.yml s 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"

Prepojili sme? Super — pokračujeme:

Teraz musíme zmeniť konfiguráciu nginx na prácu s 443 portom a SSL v celku:

Príklad konfigurácie main.conf s 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;
	}
}

Vlastne po týchto manipuláciách prejdeme do adresára s Docker-compose, napíšeme docker-compose up -d. A skontrolujeme funkčnosť SSL. Malo by sa to všetko spustiť.

Hlavne nezabudnite, že certifikát Let’sEncrypt sa vydáva na 90 dní a budete ho musieť obnoviť pomocou príkazu sudo certbot renew, a potom reštartovať projekt príkazom docker-compose restart

Ako možnosť — pridať túto postupnosť do crontab.

Podľa môjho názoru je to najjednoduchší spôsob pripojenia SSL k Docker Web-app.

P.S. Prosím vezmite na vedomie, že všetky skripty uvedené v texte sú dočasné, projekt je momentálne v hlbokej fáze vývoja, takže vás žiadam, aby ste nekritizovali konfigurácie - budú sa ešte veľa ráz meniť.

Zdroj: habr.com