Preklad transkripcie podcastu bol pripravený pred začiatkom kurzu

Docker Compose je úžasný nástroj na vytváranie pracovného
prostredia pre stack, ktorý sa používa vo vašej aplikácii. Umožňuje vám definovať
každú súčasť vašej aplikácie podľa jasnej a jednoduchej syntaxe v .
S príchodom môžu byť tieto YAML súbory použité priamo v pracovnom prostredí pri práci s
klastrom .
Ale znamená to, že môžete použiť rovnaký docker-compose súbor v
procese vývoja a v produkčnom prostredí? Alebo použiť ten istý súbor na
staging? No, vo všeobecnosti áno, ale pre takúto funkcionalitu potrebujeme nasledujúce:
- Interpolácia premenných: používanie premenných prostredia pre niektoré
hodnoty, ktoré sa menia v každom prostredí. - Prepisovanie konfigurácie: možnosť definovať druhý (alebo akýkoľvek
iný nasledujúci) docker-compose súbor, ktorý niečo zmení na základe
prvého, a docker compose sa postará o zlúčenie oboch súborov.
Rozdiely medzi súbormi pre vývoj a produkciu
Počas vývoja pravdepodobne chcete sledovať zmeny kódu v
reálnom čase. Na to sa zvyčajne mountuje zväzok s pôvodným kódom do
kontajnera, v ktorom je runtime pre vašu aplikáciu. Ale pre produkčné prostredie
takýto spôsob nie je vhodný.
V produkcii máte klaster s mnohými uzlami a zväzok je lokálny vzhľadom
na uzol, na ktorom beží váš kontajner (alebo služba), takže nemôžete mountovať
pôvodný kód bez zložitých operácií, ktoré zahŕňajú
synchronizáciu kódu, signály atď.
Namiesto toho zvyčajne chceme vytvoriť obraz s konkrétnou verziou vášho kódu.
Vhodne ho označujeme zodpovedajúcim tagom (môžete použiť semantické
verzovanie alebo iný systém podľa vášho uváženia).
Prepisovanie konfigurácie
Vzhľadom na rozdiely a to, že vaše závislosti sa môžu líšiť v scénach
vývoja a produkcie, je jasné, že budeme potrebovať rôzne konfiguračné súbory.
Docker compose podporuje zlúčenie rôznych compose súborov na
získanie konečnej konfigurácie. Ako to funguje, môžete vidieť na príklade:
$ 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 0Ako už bolo spomenuté, docker compose podporuje spájanie viacerých compose-
súborov, čo umožňuje predefinovať rôzne parametre v druhom súbore. Napríklad:
$ 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 0Takáto syntax nie je veľmi pohodlná v priebehu vývoja, keď bude potrebné príkaz
vykonávať mnohokrát.
Našťastie, docker compose automaticky hľadá špeciálny súbor s názvom
docker-compose.override.yml na predefinovanie hodnôt docker-compose.yml. Ak
premenujte druhý súbor, potom dostanete ten istý výsledok, len pomocou pôvodného príkazu:
$ 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 0Dobre, tak si to zapamätať bude jednoduchšie.
Interpolácia premenných
Konfiguračné súbory podporujú a hodnoty predvolené. Teda môžete urobiť nasledovné:
services:
my-service:
build:
context: .
image: private.registry.mine/my-stack/my-service:${MY_SERVICE_VERSION:-latest}
...A ak vykonávate docker-compose build (alebo push) bez premennej prostredia
$MY_SERVICE_VERSION, použije sa hodnota latest, ale ak nastavíte
hodnotu premennej prostredia pred zostavením, táto sa použije pri zostavení alebo pushovaní
do registra private.registry.mine.
Moje zásady
Prístupy, ktoré sú pre mňa pohodlné, môžu byť užitočné aj pre vás. Riadený týmito
jednoduchými pravidlami:
- Všetky moje stacky pre produkciu, vývoj (alebo iné prostredia) sú definované cez
súbory docker-compose. - Konfiguračné súbory, potrebné na pokrytie všetkých mojich prostredí, maximálne
minimalizujú duplicity. - Potrebujem jeden jednoduchý príkaz na prácu v každom prostredí.
- Hlavná konfigurácia je definovaná v súbore docker-compose.yml.
- Premenné prostredia sa používajú na definovanie tagov obrazov alebo iných
premenných, ktoré sa môžu meniť od prostredia k prostrediu (staging, integrácia,
produkcia). - Hodnoty premenných pre produkciu sa používajú ako predvolené hodnoty, čo minimalizuje riziká v prípade spustenia stacku v produkcii bez
nastavenej premennej prostredia.
Na spustenie služby v produkčnom prostredí sa používa príkaz - docker stack deploy --compose-file docker-compose.yml --with-registry-auth my-stack-name Pracovné prostredie sa spúšťa pomocou príkazu.
- Pozrime sa na jednoduchý príklad. docker-compose up -d.
Môžem použiť
# 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}
...A
# 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
...docker-compose (docker-compose up) , aby som spustil stack vovývojovom režime so zdrojovým kódom namontovaným v
Môžem použiť tieto isté súbory aj na produkcii! A mohol by som použiť presne /project/src.
taký istý súbor
na staging. Na to, aby som to rozšíril na docker-compose.yml produkciu, stačí zostaviť a odoslať obraz s predom definovaným tagom
v etape CI:
export MY_SERVICE_VERSION=1.2.3 docker-compose -f docker-compose.yml build docker-compose -f docker-compose.yml push
Na produkcii to možno spustiť pomocou nasledujúcich príkazov:export MY_SERVICE_VERSION=1.2.3 docker stack deploy my-stack --compose-file docker-compose.yml --with-registry-auth
A ak chcete spraviť to isté na stagingu, stačí len definovaťnevyhnutné premenné prostredia na prácu v stagingovom prostredí:
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 konci sme použili dva rôzne súbory docker-compose, ktoré bezduplicít konfigurácií môžu byť použité pre akékoľvek vaše prostredie!
Preklad transkripcie podcastu bol pripravený pred spustením kurzu „Správca Linuxu“
Zistiť viac o kurze
Zdroj: habr.com
