Prijevod transkripcije podcasta pripremljen je uoči početka kursa

Docker Compose je fantastičan alat za kreiranje radnog
okruženja za stog koji se koristi u vašoj aplikaciji. Omogućuje vam da definišete
svaku komponentu vaše aplikacije prateći jasan i jednostavan sintaksu u .
Sa pojavom ove YAML datoteke mogu se koristiti direktno u radnom okruženju, kada radite sa
klasterom .
Ali, da li to znači da možete koristiti istu docker-compose datoteku u
razvojnom procesu i u produkcijskom okruženju? Ili koristiti istu datoteku za
staging? Pa, u suštini — da, ali za tu funkcionalnost nam je potrebno sljedeće:
- Interpolacija varijabli: korištenje varijabli okruženja za određene
vrijednosti koje se mijenjaju u svakom okruženju. - Predefinisanje konfiguracije: mogućnost definisanja druge (ili bilo koje
naredne) 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 proizvodnju
Tokom razvoja, vjerovatno ćete htjeti da provjeravate promjene koda u
vremenskom režimu. Za to, obično se montaža sa izvornih kodom vrši u
kontejner u kojem se nalazi runtime vaše aplikacije. Ali za proizvodno okruženje
takav način nije pogodan.
U produkciji imate klaster sa mnogo čvorova, a montaža je lokalna u odnosu na
čvor na kojem radi 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 da kreiramo sliku sa određenom verzijom vašeg koda.
Uobičajeno je označiti je odgovarajućom oznakom (možete koristiti semantičko
verzioniranje ili neki drugi sistem po vašem izboru).
Predefinisanje konfiguracije
Uzimajući u obzir razlike i to što vaše zavisnosti mogu varirati u scenarijima
razvoja i produkcije, jasno je da će nam biti potrebni različiti konfiguracioni fajlovi.
Docker compose podržava spajanje različitih compose datoteka za
dobijanje konačne konfiguracije. Kako to funkcioniše 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 baš pogodna tokom razvoja, kada će komandu
trebati izvoditi više puta.
Na sreću, docker compose automatski traži posebnu datoteku pod imenom
docker-compose.override.yml za prepisivanje vrednosti docker-compose.yml. Ako
preimenujte drugu datoteku, dobićete isti rezultat, samo koristeći originalnu komandu:
$ 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 se lakše pamti.
Interpolacija promenljivih
Datoteke konfiguracije podržavaju i podrazumevane vrednosti. Dakle, možete učiniti sledeće:
services:
my-service:
build:
context: .
image: private.registry.mine/my-stack/my-service:${MY_SERVICE_VERSION:-latest}
...I ako izvodite docker-compose build (ili push) bez promenljive okruženja
$MY_SERVICE_VERSION, koristiće se vrednost latest, ali ako postavite
vrednost promenljive okruženja pre izgradnje, ona će biti korišćena prilikom izgradnje ili pušenja
u registry private.registry.mine.
Moji principi
Pristupi koji su meni zgodni mogu biti korisni i vama. Pratim ovih
jednostavnih pravila:
- Svi moji stekovi za produkciju, razvoj (ili druge okvire) definišu se preko
docker-compose fajlova. - Fajlovi konfiguracije potrebni za pokrivanje svih mojih okvira maksimalno
izbegavaju dupliciranje. - Potrebna mi je jedna jednostavna komanda za rad u svakom okruženju.
- Osnovna konfiguracija definiše se u fajlu docker-compose.yml.
- Promenljive okruženja koriste se za određivanje oznaka slika ili drugih
promenljivih koje se mogu menjati od okruženja do okruženja (staging, integracija,
produkcija). - Vrednosti promenljivih za produkciju koriste se kao podrazumevane vrednosti,
to minimizuje rizike u slučaju pokretanja steka u produkciji bez
postavljene promenljive okruženja. - Za pokretanje servisa u produkcionom okruženju koristi se komanda docker stack deploy --compose-file docker-compose.yml --with-registry-auth my-stack-name.
- Radno okruženje pokreće se pomoću komande docker-compose up -d.
Pogledajmo jednostavan primer.
# 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), da pokrenem stek u
modu razvoja sa izvornih kodom montiranim u /project/src.
Mogu koristiti iste fajlove na produkciji! I mogao bih koristiti potpuno
isti fajl docker-compose.yml za staging. Da bih to implementirao na
produkciju, jednostavno treba da skupim i pošaljem sliku sa unapred definisanom oznakom
na CI fazi:
export MY_SERVICE_VERSION=1.2.3
docker-compose -f docker-compose.yml build
docker-compose -f docker-compose.yml pushNa produkciji se ovo može pokrenuti sa sledećim komandama:
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, potrebno je samo definisati
neophodne promenljive 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, koristili smo dva različita docker-compose fajla, koja bez
dupliciranja konfiguracija mogu koristiti za bilo koje vaše okruženje!
Saznajte više o kursu
Izvor: habr.com
