Postavite PHP aplikaciju pomoću Docker-compose

PHP aplikacije obično se sastoje od web poslužitelja, sustava relacijske baze podataka i samog tumača jezika. U ovom vodiču koristit ćemo cijeli stog PHP aplikacija pomoću dockera. Ovo je dubinski vodič u kojem ćemo izgraditi i orkestrirati kontejnere za Nginx (web poslužitelj), MySQL (sustav baze podataka) i PHP.

Radi ovog tutoriala, napisat ćemo jednostavnu aplikaciju koja čita popis gradova iz baze podataka i prikazuje ga na web stranici, na ovaj način ćemo demonstrirati osnovnu, ali radnu PHP aplikaciju.

Ovaj vodič pretpostavlja da imate već instaliran Docker-CE i barem minimalno radno znanje o dockeru. U tom slučaju možete pregledati sljedeće tutorijale:

• Instaliranje Docker CE na Ubuntu 16.04
• Instalacija Docker CE na CentOS 7
• Kako koristiti Docker: Stvaranje vašeg prvog Docker spremnika

Konfiguriranje našeg radnog okruženja

Docker-bazirana aplikacija u stvarnom životu obično se sastoji od nekoliko spremnika. Ručno upravljanje njima lako može postati prilično neuredno i glomazno. Tu dolazi docker-compose. Pomaže vam upravljati brojnim spremnicima putem jednostavne yamlkonfiguracijske datoteke.

Instalirajte docker-compose.

curl -L https://github.com/docker/compose/releases/download/1.19.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

Stvorite mapu za držanje svih potrebnih datoteka ovog primjera, a zatim cdu nju. Od sada pa nadalje, ovo je naš radni direktorij i svaka naredba će se izvršavati unutar ove mape i svaka će staza biti referencirana u odnosu na nju. Ova se mapa kasnije može referencirati kao WORKING_DIR.

mkdir ~/docker
cd ~/docker

Sada stvorite još tri mape.

mkdir php nginx app

phpMapa gdje ćemo graditi naš običaj PHP sliku, nginxmapa održat će potrebne datoteke za naš običaj Nginx slike i appmapa gdje ćemo se stavljanjem izvorni kod i konfiguraciju naše nanošenja uzorka.

Konfiguriranje PHP spremnika

U ovom primjeru koristit ćemo se php-fpmza povezivanje s Nginx web poslužiteljem. Koristit ćemo službenu osnovnu sliku PHP-a. Međutim, također moramo instalirati i omogućiti neka proširenja kako bismo mogli pristupiti bazi podataka. Unutar phpmape stvorite datoteku pod nazivom Dockerfilei u nju stavite sljedeći sadržaj.

FROM php:7.1-fpm-alpine3.4
RUN apk update --no-cache \
    && apk add --no-cache $PHPIZE_DEPS \
    && apk add --no-cache mysql-dev \
    && docker-php-ext-install pdo pdo_mysql

Imajte na umu da koristimo Alpine verziju službene PHP slike. Alpine je vrlo mala distribucija usmjerena na kontejnere pružajući mnogo manje površine. Također, imajte na umu korištenje naredbe docker-php-ext-install, službena PHP slika pruža ovu naredbu kako bi se olakšao proces instaliranja i konfiguriranja PHP proširenja.

Sada, napravimo ovu Docker sliku izdavanjem sljedećeg (unutar našeg WORKING_DIR):

docker build -t vultr-php php/

docker-compose.ymldatoteka

Kao što je već spomenuto, docker-composeomogućuje vam upravljanje brojnim spremnicima kroz jednostavnu konfiguracijsku datoteku. Ova konfiguracijska datoteka obično se zove docker-compose.yml. Stvorite ovu datoteku unutar appmape.

touch app/docker-compose.yml

Sada stavite sljedeći sadržaj u ovu datoteku.

version: '2'
services:
  php:
    image: vultr-php
    volumes:
      - ./:/app
    working_dir: /app

Objasnit ćemo ovu sintaksu. Prvo, obratite pažnju na prvi redak.

version: '2'

Ovo određuje verziju korištene docker-compose.ymlkonfiguracijske datoteke. Sljedeći redak specificira usluge, ili drugim riječima, spremnike koji će se osigurati.

services:
  php:
    image: vultr-php
    volumes:
      - ./:/app
    working_dir: /app

Imajte na umu da svaka usluga ima određeni ključ unutar servicesbloka. Ovdje naveden naziv koristit će se za kasnije upućivanje na ovaj specifični spremnik. Također imajte na umu da unutar phpkonfiguracije definiramo sliku koja se koristi za pokretanje spremnika (ovo je slika koju smo prethodno izgradili). Također definiramo mapiranje volumena.

volumes:
  - ./:/app

Ovo govori mapirati docker-composetrenutni imenik ( ./) u /appdirektorij unutar spremnika. Zadnji redak postavlja /appmapu unutar spremnika kao radni direktorij, što znači da je to mapa iz koje se prema zadanim postavkama izvršavaju sve buduće naredbe unutar spremnika.

Sada možemo orkestrirati naše kontejnere.

cd ~/docker/app
docker-compose up -d

Možete pokrenuti sljedeću naredbu kako biste bili sigurni da je PHP spremnik izvršen:

docker ps

Kako izvršiti naredbe unutar kontejnera

Još uvijek unutar appmape, uz pomoć docker-composenaredbe možemo pokrenuti bilo koju naredbu unutar definiranog servisnog kontejnera .

docker-compose exec [service] [command]

[service]Rezervirano mjesto se odnosi na ključ usluga. U našem slučaju, ovo je bilo php. Pokrenimo naredbu unutar spremnika da provjerimo našu verziju PHP-a.

docker-compose exec php php -v

Vidjet ćete sljedeći izlaz.

PHP 7.1.14 (cli) (built: Feb  7 2018 00:40:45) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2018 Zend Technologies

Konfiguriranje Nginx spremnika

Baš kao i PHP kontejner, moramo stvoriti prilagođenu sliku za web poslužitelj. Ali u ovom slučaju, samo trebamo pružiti konfiguraciju za naš virtual host. Provjerite jeste li unutar naše WORKING_DIRi kreirajte Dockerfileunutar nginxmape:

cd ~/docker
touch nginx/Dockerfile

Sada stavite sljedeći sadržaj u ovo Dockerfile:

FROM nginx:1.13.8-alpine
COPY ./default.conf /etc/nginx/conf.d/default.conf

Koristimo zadanu sliku Nginxa temeljenu na Alpineu. Na ovoj Docker datoteci jednostavno kopiramo konfiguracijsku datoteku u postavke naše aplikacije. Prije izrade ove slike stvorite konfiguracijsku datoteku.

touch nginx/default.conf

Sada ga popunite ovim sadržajem.

server {
    listen 80 default_server;
    listen [::]:80 default_server ipv6only=on;

    root /app;
    index index.php;

    #server_name server_domain_or_IP;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        try_files $uri /index.php =404;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass php:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Imajte na umu da u fastcgi_pass php:9000retku referiramo na PHP spremnik njegovim imenom unutar servicebloka docker-compose.ymlkonfiguracijske datoteke. Interno docker-composestvara mrežu i dodjeljuje naziv usluge kao naziv hosta svakoj od definiranih usluga. Sada možemo izgraditi sliku Nginxa.

docker build -t vultr-nginx nginx/

Ažuriranje docker-compose.yml

Sada ažurirajte app/docker-compose.ymldatoteku.

version: '2'
services:
  php:
    image: vultr-php
    volumes:
      - ./:/app
    working_dir: /app
  web:
    image: vultr-nginx
    volumes:
      - ./:/app
    depends_on:
      - php
    ports:
      - 80:80

Dodali smo samo novu uslugu. Konfiguracija je gotovo ista, osim sljedećeg.

depends_on:
  - php
ports:
  - 80:80

Once the Nginx container needs the PHP service to be fully initialized, we force this requirement in the depends_on option. The ports configuration key maps a host port to a container port, here we map the port 80 in the host to the port 80 in the container.

Now create a file called index.php inside the app folder and put the following in it.

<?php phpinfo();

Make sure the port 80 is accessible through your firewall and execute the following.

cd ~/docker/app
docker-compose up -d

Once again, double check that the service is up.

docker ps

Open a browser and access [vultr-instance-ip]. You may find out your Vultr instance IP address by running the following.

hostname -I

You will see the PHP info page.

Configuring the MySQL container

Službena MySQL slika omogućuje vam da konfigurirate spremnik putem jednostavnih varijabli okruženja. To se može učiniti s environmentopcijom unutar definicije servisnog bloka. Ažurirajte ~/docker/app/docker-compose.ymldatoteku na sljedeće.

version: '2'
services:
  php:
    image: vultr-php
    volumes:
      - ./:/app
    working_dir: /app
  web:
    image: vultr-nginx
    volumes:
      - ./:/app
    depends_on:
      - php
    ports:
      - 80:80
  mysql:
    image: mysql:5.7.21
    volumes:
      - ./:/app
      - dbdata:/var/lib/mysql
    environment:
      - MYSQL_DATABASE=world
      - MYSQL_ROOT_PASSWORD=root
    working_dir: /app
volumes:
  dbdata:

Sada smo definirali novu uslugu za bazu podataka. Obratite pažnju na liniju dbdata:/var/lib/mysql. Time se staza na spremniku postavlja /var/lib/mysqlna trajni volumen kojim upravlja Docker, na taj način podaci baze podataka ostaju nakon uklanjanja spremnika. Ovaj volumen treba definirati u bloku najviše razine kao što možete vidjeti na kraju datoteke.

Prije orkestriranja naše nove konfiguracije, preuzmimo uzorak MySQL baze podataka. Službeni MySQL dokumentacija daje neke primjere baza podataka. Koristit ćemo poznatu svjetsku bazu podataka. Ova baza podataka pruža popis zemalja i gradova. Da biste preuzeli ovaj uzorak, izvršite sljedeće unutar naše mape aplikacije.

curl -L http://downloads.mysql.com/docs/world.sql.gz -o world.sql.gz
gunzip world.sql.gz

Sada organiziramo naše kontejnere.

docker-compose up -d

Kao što ste možda već primijetili, docker-compose upnaredba pokreće samo one spremnike koji još nisu pokrenuti. Provjerava razlike između vaše docker-compose.ymldatoteke i trenutne konfiguracije pokrenutih spremnika.

Još jednom provjerite je li MySQL spremnik pokrenut.

docker ps

Sada popunite svjetsku bazu podataka.

docker-compose exec -T mysql mysql -uroot -proot world < world.sql

Možete provjeriti je li baza podataka popunjena odabirom podataka izravno iz baze podataka. Prvo pristupite MySQL promptu unutar spremnika.

docker-compose exec mysql mysql -uroot -proot world

U MySQL promptu pokrenite sljedeće.

select * from city limit 10;

Vidjet ćete popis gradova. Sada zatvorite MySQL prompt.

mysql> exit

Izrada naše aplikacije

Sada kada su svi potrebni spremnici pokrenuti i pokrenuti, možemo se usredotočiti na naš uzorak aplikacije. Ažurirajte app/index.phpdatoteku na sljedeće.

<?php

$pdo = new PDO('mysql:host=mysql;dbname=world;charset=utf8', 'root', 'root');

$stmt = $pdo->prepare("
    select city.Name, city.District, country.Name as Country, city.Population
    from city
    left join country on city.CountryCode = country.Code
    order by Population desc
    limit 10
");
$stmt->execute();
$cities = $stmt->fetchAll(PDO::FETCH_ASSOC);

?>

<!doctype html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Vultr Rocks!</title>
</head>
<body>
    <h2>Most Populous Cities In The World</h2>
    <table>
    <thead>
        <tr>
            <th>Name</th>
            <th>Country</th>
            <th>District</th>
            <th>Population</th>
        </tr>
    </thead>
    <tbody>
        <?php foreach($cities as $city): ?>
            <tr>
                <td><?=$city['Name']?></td>
                <td><?=$city['Country']?></td>
                <td><?=$city['District']?></td>
                <td><?=number_format($city['Population'], 0)?></td>
            </tr>
        <?php endforeach ?>
    </tbody>
    </table>
</body>
</html>

Ako pristupite [vultr-instance-ip]putem web preglednika, vidjet ćete popis najnaseljenijih gradova na svijetu. Čestitamo, postavili ste potpuno funkcionalnu PHP aplikaciju pomoću dockera.

Zaključak

U ovom vodiču demonstrirao sam korak po korak kako konfigurirati potpuno funkcionalnu PHP aplikaciju. Napravili smo prilagođene slike za PHP i Nginx i konfigurirali docker-compose za orkestriranje naših spremnika. Unatoč tome što je vrlo osnovna i jednostavna, ova postavka odražava stvarni životni scenarij.

U ovom vodiču izgradili smo i označili naše slike lokalno. Za fleksibilnije postavljanje, ove slike možete gurnuti u docker registar . Možete gurnuti u službeni docker registar ili čak postaviti vlastiti docker registar. U svakom slučaju, to će vam omogućiti da izgradite svoje slike na jednom hostu i koristite ih na drugom.

Za detaljniju upotrebu docker-compose, trebate pogledati službenu dokumentaciju .

Ovisno o zahtjevima vaše aplikacije i PHP okviru koji koristite, možda ćete htjeti dodati još proširenja. To se lako može učiniti modificiranjem Dockerfilekorištene za izgradnju naše prilagođene PHP slike. Međutim, neka proširenja trebaju dodatne ovisnosti za instaliranje u spremnik. Trebali biste pogledati popis proširenja u službenoj dokumentaciji PHP-a kako biste pregledali osnovne zahtjeve svakog proširenja.