Adăugarea PostgreSQL la Docker Compose

Pe mașina noastră locală, am decis să folosim Docker pentru a gestiona serviciile. Creează un fișier docker-compose.yaml și adaugă PostgreSQL ca serviciu:

1
2
3
4
5
6
7
8
9
10

version: '3'

services:
    database:
        image: postgres:13-alpine
        environment:
            POSTGRES_USER: main
            POSTGRES_PASSWORD: main
            POSTGRES_DB: main
        ports: [5432]

Aceasta va instala un server PostgreSQL și va configura unele variabile de mediu care controlează numele bazei de date și datele de autentificare. Valorile nu prea contează.

De asemenea, expunem portul PostgreSQL (5432) al containerului la gazda locală. Asta ne va ajuta să accesăm baza de date de pe serverul nostru.

Pornirea Docker Compose

Pornește Docker Compose în fundal (-d):

1

$ docker-compose up -d

Așteaptă puțin pentru a permite pornirea bazei de date și verifică dacă totul funcționează bine:

1
2
3
4
5

$ docker-compose ps

        Name                      Command              State            Ports
---------------------------------------------------------------------------------------
guestbook_database_1   docker-entrypoint.sh postgres   Up      0.0.0.0:32780->5432/tcp

Dacă nu există containere care rulează sau dacă în coloana State nu scrie Up, atunci verifică în jurnalele Docker Compose pentru mai multe detalii:

1

$ docker-compose logs

Accesarea bazei de date locale

Utilizarea comenzii psql se poate dovedi utilă din când în când. Dar trebuie să îți amintești datele de autentificare și numele bazei de date. Mai puțin evident, trebuie să cunoști și portul local pe care rulează baza de date. Docker alege un port aleatoriu, astfel încât să poți lucra la mai multe proiecte folosind PotgreSQL în același timp (portul local face parte din rezultatul lui docker-compose ps).

Dacă rulezi psql prin Symfony CLI, nu trebuie să memorezi nimic.

Symfony CLI detectează automat serviciile Docker care rulează pentru proiect și expune variabilele de mediu de care psql are nevoie pentru a se conecta la baza de date.

Datorită acestor convenții, accesarea bazei de date prin symfony run este mult mai ușoară:

1

$ symfony run psql

1

$ docker-compose exec database psql main

Copierea și restaurarea datelor din baza de date

Folosește pg_dump pentru a face o copie de rezervă a datelor din baza de date:

1

$ symfony run pg_dump --data-only > dump.sql

Și restaurează datele:

1

$ symfony run psql < dump.sql

Adăugarea PostgreSQL la SymfonyCloud

Pentru infrastructura de producție de pe SymfonyCloud, adăugarea unui serviciu precum PostgreSQL trebuie făcută în fișierul actualmente gol, .symfony/services.yaml:

1
2
3
4

db:
    type: postgresql:13
    disk: 1024
    size: S

Serviciul db este o bază de date PostgreSQL (aceeași versiunea ca pentru Docker) pe care dorim să o furnizăm pe un container mic cu 1 GB de spațiu disc.

De asemenea, trebuie să „conectăm” baza de date la containerul aplicației, care este descris în .symfony.cloud.yaml:

1
2

relationships:
    database: "db:postgresql"

Serviciul db de tipul postgresql este declarat database în containerul aplicației.

Ultimul pas este să activezi extensia pdo_pgsql în PHP:

1
2
3
4

runtime:
    extensions:
        - pdo_pgsql
        # other extensions here

Iată diferența completă pentru modificările .symfony.cloud.yaml:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

--- a/.symfony.cloud.yaml
+++ b/.symfony.cloud.yaml
@@ -4,6 +4,7 @@ type: php:8.0

 runtime:
     extensions:
+        - pdo_pgsql
         - apcu
         - mbstring
         - sodium
@@ -21,6 +22,9 @@ build:

 disk: 512

+relationships:
+    database: "db:postgresql"
+
 web:
     locations:
         "/":

Salvează aceste modificări și apoi relansează proiectul în SymfonyCloud:

1
2
3

$ git add .
$ git commit -m'Configuring the database'
$ symfony deploy

Accesarea bazei de date din SymfonyCloud

PostgreSQL rulează acum atât local prin Docker, cât și în producție, pe SymfonyCloud.

Așa cum tocmai am văzut, rulând symfony run psql, comanda conectează proiectul automat la baza de date găzduită pe Docker datorită variabilelor de mediu expuse de symfony run.

Dacă dorești să te conectezi la PostgreSQL găzduit pe containerele de producție, poți deschide un tunel SSH între mașina locală și infrastructura SymfonyCloud:

1

$ symfony tunnel:open --expose-env-vars

În mod implicit, serviciile SymfonyCloud nu sunt expuse ca variabile de mediu pe mașina locală. Trebuie să faci acest lucru în mod explicit folosind opțiunea --expose-env-vars. De ce? Conectarea la baza de date de producție este o operațiune periculoasă. Poți modifica date reale. Folosind opțiunea confirmi că asta e ceea ce vrei să faci cu adevărat.

Acum, conectează-te la baza de date PostgreSQL de la distanță prin symfony run psql ca mai înainte:

1

$ symfony run psql

Când ai terminat treaba, nu uita să închizi tunelul:

1

$ symfony tunnel:close

Expunerea variabilelor de mediu

Docker Compose și SymfonyCloud funcționează perfect cu Symfony datorită variabilelor de mediu.

Verifică toate variabilele de mediu expuse de symfony executând symfony var:export:

1
2
3
4
5
6
7
8

$ symfony var:export

PGHOST=127.0.0.1
PGPORT=32781
PGDATABASE=main
PGUSER=main
PGPASSWORD=main
# ...

Variabilele de mediu PG* sunt citite de utilitarul psql. Ce se întâmpla cu celelalte?

Când un tunel este deschis către SymfonyCloud cu opțiunea --expose-env-vars, comanda var:export returnează variabilele de mediu din mediul de lucru de la distanță - de pe producție:

1
2
3

$ symfony tunnel:open --expose-env-vars
$ symfony var:export
$ symfony tunnel:close

Descrierea infrastructurii tale

Poate că nu ți-ai dat seama încă, dar să ai infrastructura stocată în fișiere alături de cod ajută foarte mult. Docker și SymfonyCloud folosesc fișiere de configurare pentru a descrie infrastructura proiectului. Atunci când o nouă caracteristică are nevoie de un serviciu suplimentar, codul se modifică și modificările infrastructurii fac parte din același patch.