Docker Compose: od razvoja do produkcije

Prijevod transkripcije podkasta pripremljen je uoči početka tečaja „Administrator Linuxa“

Docker Compose: od razvoja do produkcije

Docker Compose je nevjerojatan alat za izgradnju radnog
okruženja za stog koji se koristi u vašoj aplikaciji. Omogućuje vam definiranje
svake komponente vaše aplikacije slijedeći jasan i jednostavan sintaksu u YAML-
datotekama
.

S pojavom docker compose v3 ove YAML datoteke mogu se koristiti izravno u radnom okruženju, dok radite s
klasterom Docker Swarm.

Ali znači li to da možete koristiti istu docker-compose datoteku u
razvojnim procesima i u produkcijskom okruženju? Ili koristiti istu datoteku za
staging? Pa, općenito - da, ali za tu funkcionalnost trebamo sljedeće:

  • Interpolacija varijabli: korištenje varijabli okruženja za neke
    vrijednosti koje se mijenjaju u svakom okruženju.
  • Prepisivanje konfiguracije: mogućnost definiranja druge (ili bilo koje
    sljedeće) docker-compose datoteke koja će nešto promijeniti u odnosu na
    prvu, a docker compose će se pobrinuti za spajanje obje datoteke.

Razlike između datoteka za razvoj i produkciju

Tijekom razvoja, najvjerojatnije ćete željeti pratiti promjene koda u
stvarnom vremenu. Za to se obično, volumen s izvorni kod montira u
konteineru u kojem se nalazi runtime vaše aplikacije. No za produkcijsko okruženje
takav način nije prikladan.

U produkciji imate klaster s mnogim čvorovima, a volumen je lokalni prema
čvoru na kojem se izvodi vaš kontejner (ili usluga), stoga ne
možete montirati izvorni kod bez složenih operacija koje uključuju
synchronizaciju koda, signale itd.

Umjesto toga, obično želimo izraditi sliku s određenom verzijom vašeg koda.
Obično se označava odgovarajućom oznakom (možete koristiti semantičko
verzioniranje ili drugi sustav po vašem izboru).

Prepisivanje konfiguracije

Uzimajući u obzir razlike i to da se vaše ovisnosti mogu razlikovati u scenarijima
razvoja i produkcije, jasno je da će nam trebati različite konfiguracijske datoteke.

Docker compose podržava spajanje različitih compose datoteka za
dobivanje konačne konfiguracije. Kako to funkcionira može se vidjeti na primjeru:

$ cat docker-compose.yml
version: "3.2"

services:
  whale:
    image: docker/whalesay
    command: ["cowsay", "hello!"]
$ docker-compose up
Creating network "composeconfigs_default" with the default driver
Starting composeconfigs_whale_1
Attaching to composeconfigs_whale_1
whale_1  |  ________
whale_1  | 
whale_1  |  --------
whale_1  |     
whale_1  |      
whale_1  |       
whale_1  |                     ##        .
whale_1  |               ## ## ##       ==
whale_1  |            ## ## ## ##      ===
whale_1  |        /""""""""""""""""___/ ===
whale_1  |   ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ /  ===- ~~~
whale_1  |        ______ o          __/
whale_1  |                     __/
whale_1  |           __________/
composeconfigs_whale_1 exited with code 0

Kao što je rečeno, docker compose podržava kombinovanje više compose-
datoteka, što omogućava prepisivanje različitih parametara u drugoj datoteci. Na primer:

$ cat docker-compose.second.yml
version: "3.2"
services:
  whale:
    command: ["cowsay", "bye!"]

$ docker-compose -f docker-compose.yml -f docker-compose.second.yml up
Creating composeconfigs_whale_1
Attaching to composeconfigs_whale_1
whale_1  |  ______
whale_1  | 
whale_1  |  ------
whale_1  |     
whale_1  |      
whale_1  |       
whale_1  |                     ##        .
whale_1  |               ## ## ##       ==
whale_1  |            ## ## ## ##      ===
whale_1  |        /""""""""""""""""___/ ===
whale_1  |   ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ /  ===- ~~~
whale_1  |        ______ o          __/
whale_1  |                     __/
whale_1  |           __________/
composeconfigs_whale_1 exited with code 0

Ova sintaksa nije veoma pogodna u procesu razvoja, kada će biti potrebno izvršiti komandu
više puta.

Na sreću, docker compose automatski traži poseban fajl imenom
docker-compose.override.yml za prepisivanje vrednosti docker-compose.yml. Ako
preimenujte drugu datoteku, dobićete isti rezultat, samo pomoću izvorne komande:

$ mv docker-compose.second.yml docker-compose.override.yml
$ docker-compose up
Starting composeconfigs_whale_1
Attaching to composeconfigs_whale_1
whale_1  |  ______
whale_1  | 
whale_1  |  ------
whale_1  |     
whale_1  |      
whale_1  |       
whale_1  |                     ##        .
whale_1  |               ## ## ##       ==
whale_1  |            ## ## ## ##      ===
whale_1  |        /""""""""""""""""___/ ===
whale_1  |   ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ /  ===- ~~~
whale_1  |        ______ o          __/
whale_1  |                     __/
whale_1  |           __________/
composeconfigs_whale_1 exited with code 0

Dobro, tako je lakše zapamtiti.

Interpolacija promenljivih

Konfiguracione datoteke podržavaju interpolaciju
promenljivih
i podrazumevanih vrednosti. To jest, možete uraditi sledeće:

services:
  my-service:
    build:
      context: .
    image: private.registry.mine/my-stack/my-service:${MY_SERVICE_VERSION:-latest}
...

I ako izvršavate docker-compose build (ili push) bez promenljive okruženja
$MY_SERVICE_VERSION, koristiće se vrednost najnovije, ali ako postavite
vrednost promenljive okruženja pre gradnje, koristiće se prilikom gradnje ili pušenja
u registar private.registry.mine.

Moji principi

Pristupi koji su mi korisni mogu biti korisni i za vas. Slijedim ova
jednostavna pravila:

  • Svi moji stackovi za produkciju, razvoj (ili druge okruženja) definiraju se kroz
    docker-compose datoteke.
  • Datoteke s konfiguracijom, potrebne za pokrivanje svih mojih okruženja, maksimalno
    izbjegavaju dupliciranje.
  • Trebam jedan jednostavan naredbu za rad u svakom okruženju.
  • Osnovna konfiguracija definira se u datoteci docker-compose.yml.
  • Varijable okruženja koriste se za definiranje oznaka slika ili drugih
    varijabli koje se mogu mijenjati od okruženja do okruženja (staging, integracija,
    produkcija).
  • Vrijednosti varijabli za produkciju koriste se kao zadane vrijednosti,
    to minimalizira rizike u slučaju pokretanja stacka u produkciji bez
    postavljene varijable okruženja.
  • Za pokretanje usluge u produkcijskom okruženju koristi se naredba docker stack deploy --compose-file docker-compose.yml --with-registry-auth my-stack-name.
  • Radno okruženje pokreće se pomoću naredbe docker-compose up -d.

Pogledajmo jednostavan primjer.

# docker-compose.yml
...
services:
  my-service:
    build:
      context: .
    image: private.registry.mine/my-stack/my-service:${MY_SERVICE_VERSION:-latest}
    environment:
      API_ENDPOINT: ${API_ENDPOINT:-https://production.my-api.com}
...

I

# docker-compose.override.yml
...
services:
  my-service:
    ports: # This is needed for development!
      - 80:80
    environment:
      API_ENDPOINT: https://devel.my-api.com
    volumes:
      - ./:/project/src
...

Mogu koristiti docker-compose (docker-compose up), za pokretanje stacka u
modu razvoja s izvorom montiranim u /project/src.

Mogu koristiti iste datoteke na produkciji! I mogao bih koristiti potpuno
isti datoteku docker-compose.yml za staging. Da bih to implementirao na
produkciju, jednostavno trebam izgraditi i poslati sliku s unaprijed definiranim oznakom
na CI koraku:

export MY_SERVICE_VERSION=1.2.3
docker-compose -f docker-compose.yml build
docker-compose -f docker-compose.yml push

Na produkciji može se pokrenuti s pomoću sljedećih naredbi:

export MY_SERVICE_VERSION=1.2.3
docker stack deploy my-stack --compose-file docker-compose.yml --with-registry-auth

I ako želite učiniti isto na stagingu, jednostavno trebate definirati
potrebne varijable okruženja za rad u staging okruženju:

export MY_SERVICE_VERSION=1.2.3
export API_ENDPOINT=http://staging.my-api.com
docker stack deploy my-stack --compose-file docker-compose.yml --with-registry-auth

Na kraju smo koristili dvije različite docker-compose datoteke, koje bez
dupliciranja konfiguracija mogu koristiti za bilo koje vaše okruženje!

Saznajte više o tečaju „Administrator Linuxa“

Izvor: habr.com

Kupite pouzdan hosting za web stranice s DDoS zaštitom, VPS VDS servere 🔥 Kupite pouzdan hosting za web stranice s DDoS zaštitom, VPS VDS servere | ProHoster