Docker Compose: pojednostavljenje rada uz korištenje Makefile-a

Svake nekoliko godina u industriji razvoja softvera dešava se promjena paradigme. Jedan od takvih fenomena može se smatrati porastom interesa za koncept mikroservisa. Iako mikroservisi nisu nova tehnologija, njihova popularnost je nedavno dosegla neviđene visine.

Veliki monolitni servisi danas se zamjenjuju neovisnim autonomnim mikroservisima. Mikroservis se može smatrati aplikacijom koja služi jedinstvenoj i vrlo specifičnoj svrsi. Na primjer, to može biti relacijska DBMS, Express aplikacija, Solr servis.

Docker Compose: pojednostavljenje rada uz korištenje Makefile-a

Teško je zamisliti razvoj novog softverskog sistema bez korištenja mikroservisa. Ova situacija, zauzvrat, vodi nas do platforme Docker.

Docker

Platforma Docker, u razvoju i implementaciji mikroservisa, postala je praktički industrijski standard. Na web stranici projekta može se saznati da je Docker jedina neovisna platforma za kontejnerizaciju koja omogućava organizacijama da bez većih poteškoća kreiraju bilo koje aplikacije, kao i da ih distribuiraju i pokreću u svim okruženjima — od hibridnih oblaka do rubnih sistema.

Docker Compose

Tehnologija Docker Compose namijenjena je konfiguraciji višekontejnerskih aplikacija. U Docker Compose projektu može se nalaziti onoliko Docker kontejnera koliko je potrebno stvoritelju tog projekta.

Kada radimo s Docker Compose-om za postavljanje servisa aplikacije i organizaciju njihove međusobne interakcije, koristi se YAML datoteka. Docker Compose je, stoga, alat za opisivanje i pokretanje višekontejnerskih Docker aplikacija.

Docker Compose: pojednostavljenje rada uz korištenje Makefile-a
Dva kontejnera rade na host sistemu

GNU Make

Program make, suštinski predstavlja alat za automatizaciju izgradnje programa i biblioteka iz izvornih kodova. U cjelini, može se reći da make primjenjiva na bilo koji proces koji uključuje izvođenje proizvoljnih komandi za transformaciju nekih početnih materijala u neki rezultantni oblik, u neku svrhu. U našem slučaju, komande docker-compose će se transformisati u apstraktne ciljeve (Phony targets).

Da bismo programu make rekli šta od njega želimo, potrebna nam je datoteka Makefile.

U našem Makefile u kojoj će se nalaziti obične komande docker i docker-compose, koji su namijenjeni rješavanju mnogih zadataka. Naime, ovdje se radi o izradi kontejnera, njegovom pokretanju, zaustavljanju, ponovnom pokretanju, organizaciji korisničkog pristupa u kontejner, radu s logovima kontejnera i rješavanju drugih sličnih zadataka.

Tipični načini korištenja Docker Compose

Zamislimo uobičajenu web aplikaciju koja ima sljedeće komponente:

  • Baza podataka TimescaleDB (Postgres).
  • Express.js aplikacija.
  • Ping (samo kontejner koji ne radi ništa posebno).

Ovoj aplikaciji bit će potrebna 3 Docker kontejnera i datoteka docker-compose, koja sadrži upute za upravljanje tim kontejnerima. Svaki od kontejnera imat će različite tačke interakcije. Na primjer, s kontejnerom timescale može se raditi otprilike onako kako se radi s drugim bazama podataka. Naime, omogućuje sljedeće radnje:

  • Prijavu u Postgres ljusku.
  • Uvoz i izvoz tablica.
  • Kreiranje pg_dump tablica ili baza podataka.

Kontejner Express.js aplikacije, expressjs, može imati sljedeće mogućnosti:

  • Dostavljanje svježih podataka iz sistemskog dnevnika.
  • Prijava u ljusku za izvršavanje određenih komandi.

Interakcija s kontejnerima

Nakon što smo postavili vezu između kontejnera koristeći Docker Compose, došlo je vrijeme za uspostavljanje interakcije s tim kontejnerima. U okviru Docker Compose sustava postoji komanda docker-compose, koja podržava opciju -f, koja omogućava prosljeđivanje datoteke docker-compose.yml.

Korištenjem mogućnosti ove opcije možemo ograničiti interakciju sa sustavom samo na one kontejnere koji su spomenuti u datoteci docker-compose.yml.

Pogledajmo kako izgledaju interakcije s kontejnerima prilikom korištenja komandi docker-compose. Ako zamislimo da trebamo ući u ljusku psql, odgovarajuće komande mogu izgledati ovako:

docker-compose -f docker-compose.yml exec timescale psql -Upostgres

Ista komanda, koja se koristi bez docker-compose, dok docker, može izgledati ovako:

docker exec -it edp_timescale_1 psql -Upostgres

Obratite pažnju da je u takvim slučajevima uvijek bolje koristiti komandu docker, nego komandu docker-compose, jer ovo omogućava izbjegavanje potrebe da se pamte imena kontejnera.

Obje navedene komande nisu previše složene. No da smo koristili 'omot' u obliku Makefile, koji bi nam dao sučelje u obliku jednostavnih komandi i sam bi pozivao slične dugačke komande, tako bismo mogli postići iste rezultate ovako:

make db-shell

Potpuno je očigledno da korištenje Makefile značajno olakšava rad s kontejnerima!

Radni primjer

Na temelju gore opisane sheme projekta, kreirat ćemo sljedeću datoteku docker-compose.yml:

version: '3.3'
services:
    api:
        build: .
        image: mywebimage:0.0.1
        ports:
            - 8080:8080
        volumes:
            - /app/node_modules/
        depends_on:
            - timescale
        command: npm run dev
        networks:
            - webappnetwork
    timescale:
        image: timescale/timescaledb-postgis:latest-pg11
        environment:
          - POSTGRES_USER=postgres
          - POSTGRES_PASSWORD=postgres
        command: ["postgres", "-c", "log_statement=all", "-c", "log_destination=stderr"]
        volumes:
          - ./create_schema.sql:/docker-entrypoint-initdb.d/create_schema.sql
        networks:
           - webappnetwork
    ping:
       image: willfarrell/ping
       environment:
           HOSTNAME: "localhost"
           TIMEOUT: 300
networks:
   webappnetwork:
       driver: bridge

Za upravljanje konfiguracijom Docker Compose i za interakciju s kontejnerima koje ona opisuje, kreirat ćemo sljedeću datoteku Makefile:

THIS_FILE := $(lastword $(MAKEFILE_LIST))
.PHONY: help build up start down destroy stop restart logs logs-api ps login-timescale login-api db-shell
help:
        make -pRrq  -f $(THIS_FILE) : 2>/dev/null | awk -v RS= -F: '/^# File/, /^# Finished Make data base/ {if ($$1 !~ "^[#.]") {print $$1}}' | sort | egrep -v -e '^[^[:alnum:]]' -e '^$@$$'
build:
        docker-compose -f docker-compose.yml build $(c)
up:
        docker-compose -f docker-compose.yml up -d $(c)
start:
        docker-compose -f docker-compose.yml start $(c)
down:
        docker-compose -f docker-compose.yml down $(c)
destroy:
        docker-compose -f docker-compose.yml down -v $(c)
stop:
        docker-compose -f docker-compose.yml stop $(c)
restart:
        docker-compose -f docker-compose.yml stop $(c)
        docker-compose -f docker-compose.yml up -d $(c)
logs:
        docker-compose -f docker-compose.yml logs --tail=100 -f $(c)
logs-api:
        docker-compose -f docker-compose.yml logs --tail=100 -f api
ps:
        docker-compose -f docker-compose.yml ps
login-timescale:
        docker-compose -f docker-compose.yml exec timescale /bin/bash
login-api:
        docker-compose -f docker-compose.yml exec api /bin/bash
db-shell:
        docker-compose -f docker-compose.yml exec timescale psql -Upostgres

Većina ovdje navedenih komandi primjenjuje se na sve kontejnere, ali korištenje opcije c= omogućava ograničenje područja primjene komande na jedan kontejner.

Nakon što Makefile spreman je, može se koristiti ovako:

  • make help — ispis popisa svih komandi dostupnih za make.

Docker Compose: pojednostavljenje rada uz korištenje Makefile-a
Pomoć za dostupne komande

  • make build — izgradnja slike iz Dockerfile. U našem primjeru koristili smo postojeće slike timescale i ping. Ali slika api koju želimo sastaviti lokalno. To će biti učinjeno nakon izvršavanja ove komande.

Docker Compose: pojednostavljenje rada uz korištenje Makefile-a
Sastavljanje Docker kontejnera

  • make start — pokretanje svih kontejnera. Za pokretanje samo jednog kontejnera možete koristiti komandu oblika make start c=timescale.

Docker Compose: pojednostavljenje rada uz korištenje Makefile-a
Pokretanje kontejnera timescale

Docker Compose: pojednostavljenje rada uz korištenje Makefile-a
Pokretanje kontejnera ping

  • make login-timescale — ulazak u bash sesiju kontejnera timescale.

Docker Compose: pojednostavljenje rada uz korištenje Makefile-a
Pokretanje bash u kontejneru timescale

  • make db-shell — ulazak u psql u kontejneru timescale radi izvršavanja SQL upita na bazi podataka.

Docker Compose: pojednostavljenje rada uz korištenje Makefile-a
Pokretanje psql u kontejneru timescaledb

  • make stop — zaustavljanje kontejnera.

Docker Compose: pojednostavljenje rada uz korištenje Makefile-a
Zaustavljanje kontejnera timescale

  • make down — zaustavljanje i uklanjanje kontejnera. Za uklanjanje određenog kontejnera možete koristiti ovu komandu s navođenjem potrebnog kontejnera. Na primjer — make down c=timescale ili make down c=api.

Docker Compose: pojednostavljenje rada uz korištenje Makefile-a
Zaustavljanje i uklanjanje svih kontejnera

Zaključci

Iako sistem Docker Compose pruža opsežan skup komandi za upravljanje kontejnerima, ponekad te komande postaju duge, što otežava njihovo pamćenje.

Metodologija korištenja Makefile pomogla nam je da uspostavimo brzu i jednostavnu interakciju s kontejnerima iz datoteke docker-compose.yml. Naime, radi se o sljedećem:

  • Programer se interaktivno povezuje samo s kontejnerima projekta opisanim u docker-compose.yml, a ostali pokrenuti kontejneri ne ometaju rad.
  • U slučaju da je zaboravljena neka komanda, možete izvršiti komandu make help i dobiti pomoć o dostupnim komandama.
  • Nema potrebe pamtiti duge liste argumenata za izvršavanje takvih radnji, kao što su preuzimanje svježih unosa iz dnevnika ili prijava. Na primjer, komanda oblika docker-compose -f docker-compose.yml exec timescale psql -Upostgres pretvara se u make db-shell.
  • Datoteka Makefile može se, kako projekat raste, fleksibilno prilagoditi. Na primjer, lako je dodati komandu za izradu rezervne kopije baze podataka ili za izvršavanje bilo koje druge radnje.
  • Ako velika ekipa programera koristi isti Makefile, to organizira saradnju i smanjuje broj grešaka.

P.S. U našem marketplaces ima slika Docker, koja se instalira jednim klikom. Možete provjeriti rad kontejnera na VPS. Svim novim klijentima se besplatno pruža 3 dana za testiranje.

Poštovani čitatelji! Kako automatizujete rad s Docker Compose?

Docker Compose: pojednostavljenje rada uz korištenje Makefile-a

Izvor: habr.com

Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere 🔥 Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere | ProHoster