Docker Compose: frÄn utveckling till produktion

ÖversĂ€ttningen av podkasttranskriptionen förbereds inför starten av kursen «Linuxadministratör»

Docker Compose: frÄn utveckling till produktion

Docker Compose Àr ett fantastiskt verktyg för att skapa en arbetsmiljö
för stacken som anvÀnds i din applikation. Det lÄter dig definiera
varje komponent av din applikation, enligt en tydlig och enkel syntax i YAML-
filer.
.

Med framkomsten av docker compose v3 kan dessa YAML-filer anvÀndas direkt i produktionsmiljön nÀr du arbetar med
klustret. Docker Swarm.

Men betyder det att du kan anvÀnda samma docker-compose-fil i
utvecklingsprocessen och i produktionsmiljön? Eller anvÀnda samma fil för
staging? Ja, generellt sett — men för sĂ„dan funktionalitet behöver vi följande:

  • Variabel interpolering: anvĂ€ndning av miljövariabler för vissa
    vÀrden som Àndras i varje miljö.
  • Överskrivning av konfiguration: möjligheten att definiera en andra (eller nĂ„gon
    annan efterföljande) docker-compose-fil som Àndrar nÄgot i förhÄllande till
    den första, och docker compose tar hand om sammanslagningen av bÄda filerna.

Skillnader mellan filer för utveckling och produktion

Under utvecklingen vill du förmodligen kontrollera kodförÀndringar i
real-tid. För detta monteras vanligtvis volymen med kÀllkoden i
containern som har runtime för din applikation. Men för produktionsmiljö
Àr denna metod inte lÀmplig.

I produktionen har du ett kluster med mÄnga noder, och volymen Àr lokal i
förhÄllande till noden dÀr din container (eller tjÀnst) körs, sÄ du kan inte
montera kÀllkoden utan komplexa operationer som innebÀr
kodsynkronisering, signaler etc.

IstÀllet vill vi vanligtvis skapa en bild med en specifik version av din kod.
Denna brukar mÀrkas med en passande tagg (du kan anvÀnda semantisk
versionering eller ett annat system efter eget val).

Överskrivning av konfiguration

Med hÀnsyn till skillnaderna och att dina beroenden kan skilja sig Ät i scenarier
för utveckling och produktion, Àr det klart att vi behöver olika konfigurationsfiler.

Docker compose stöder sammanslagning av olika compose-filer för
att fÄ den slutgiltiga konfigurationen. Hur detta fungerar kan ses i exemplet:

$ 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

Som sagt, docker compose stöder sammanslagning av flera compose-filer,
detta gör att man kan överskrida olika parametrar i den andra filen. Till exempel:

$ 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

Denna syntax Àr inte sÀrskilt bekvÀm under utveckling, nÀr kommandot
mÄste köras flera gÄnger.

Som tur Àr, letar docker compose automatiskt efter en speciell fil med namnet
docker-compose.override.yml för att överskrida vÀrden docker-compose.yml. Om
om du byter namn pÄ den andra filen, fÄr du samma resultat, men med det ursprungliga kommandot:

$ 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

Bra, det Àr enklare att komma ihÄg.

Variabelinterpolering

Konfigurationsfiler stöder interpolering
av variabler
och standardvÀrden. Det betyder att du kan göra följande:

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

Och om du kör docker-compose build (eller push) utan miljövariabeln
$MY_SERVICE_VERSION, kommer vÀrdet latest, att anvÀndas, men om du sÀtter
miljövariabelvÀrdet före byggnationen, kommer det att anvÀndas vid byggandet eller pushen
till registret private.registry.mine.

Mina principer

Metoder som passar mig kan ocksÄ vara anvÀndbara för dig. Jag följer dessa
enkla regler:

  • Alla mina stackar för produktion, utveckling (eller andra miljöer) definieras genom
    docker-compose-filer.
  • Konfigurationsfilerna som behövs för att tĂ€cka alla mina miljöer undviker
    duplicering sÄ mycket som möjligt.
  • Jag behöver ett enkelt kommando för att arbeta i varje miljö.
  • Huvudkonfigurationen definieras i filen docker-compose.yml.
  • Miljövariabler anvĂ€nds för att definiera bildtaggar eller andra
    variabler som kan Àndras frÄn miljö till miljö (staging, integration,
    produktion).
  • VĂ€rdena för variablerna i produktionen anvĂ€nds som standardvĂ€rden, detta
    minimerar riskerna om stacken körs i produktion utan
    instÀllda miljövariabler.
  • För att köra tjĂ€nsten i produktionsmiljön anvĂ€nds kommandot docker stack deploy --compose-file docker-compose.yml --with-registry-auth my-stack-name.
  • Utvecklingsmiljön startas med kommandot docker-compose up -d.

LÄt oss titta pÄ ett enkelt exempel.

# 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}
...

Och

# 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
...

Jag kan anvÀnda docker-compose (docker-compose up), för att starta stacken i
utvecklingslÀge med kÀllkoden monterad i /project/src.

Jag kan anvÀnda dessa samma filer i produktionen! Och jag skulle kunna anvÀnda exakt
samma fil docker-compose.yml för staging. För att distribuera detta till
produktion behöver jag bara bygga och skicka bilden med en fördefinierad tagg
under CI-stadiet:

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

I produktionen kan detta köras med följande kommandon:

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

Och om du vill göra samma sak pÄ staging, behöver du bara definiera
de nödvÀndiga miljövariablerna för att fungera i staging-miljön:

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

Som ett resultat anvÀnde vi tvÄ olika docker-compose-filer, som utan
duplicering av konfigurationer kan anvÀndas för vilken av dina miljöer som helst!

LÀs mer om kursen «Linuxadministratör»

KĂ€lla: habr.com

Köp pĂ„litlig webbhotell med DDoS-skydd, VPS VDS-servrar đŸ”„ Köp pĂ„litlig webbhotell med DDoS-skydd, VPS VDS-servrar | ProHoster