Prijevod transkripcije podkasta pripremljen je uoči početka tečaja

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 .
S pojavom ove YAML datoteke mogu se koristiti izravno u radnom okruženju, dok radite s
klasterom .
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 0Kao š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 0Ova 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 0Dobro, tako je lakše zapamtiti.
Interpolacija promenljivih
Konfiguracione datoteke podržavaju 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 pushNa 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-authI 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-authNa 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
Izvor: habr.com
