Docker Compose: თქვენი მუშაობის გამარტივება Makefiles-ის გამოყენებით

ყოველ რამდენიმე წელიწადში, პროგრამული უზრუნველყოფის განვითარების ინდუსტრია განიცდის პარადიგმის ცვლილებას. ერთ-ერთი ასეთი ფენომენი შეიძლება აღიარებულ იქნას როგორც მიკროსერვისების კონცეფციისადმი მზარდი ინტერესი. მიუხედავად იმისა, რომ მიკროსერვისები არ არის უახლესი ტექნოლოგია, მისი პოპულარობა მხოლოდ ახლახანს გაიზარდა.

დიდი მონოლითური სერვისები ახლა ჩანაცვლებულია დამოუკიდებელი, ავტონომიური მიკროსერვისებით. მიკროსერვისი შეიძლება ჩაითვალოს, როგორც აპლიკაცია, რომელიც ემსახურება ერთ და ძალიან კონკრეტულ მიზანს. მაგალითად, ეს შეიძლება იყოს რელაციური DBMS, Express აპლიკაცია, Solr სერვისი.

ამ დღეებში ძნელი წარმოსადგენია ახალი პროგრამული სისტემის შემუშავება მიკროსერვისების გამოყენების გარეშე. და ეს სიტუაცია, თავის მხრივ, მიგვიყვანს Docker პლატფორმამდე.

docker

პლატფორმა docker, მიკროსერვისების შემუშავებასა და განთავსებაში, გახდა თითქმის ინდუსტრიის სტანდარტი. პროექტის ვებსაიტზე შეგიძლიათ გაიგოთ, რომ Docker არის ერთადერთი დამოუკიდებელი კონტეინერიზაციის პლატფორმა, რომელიც საშუალებას აძლევს ორგანიზაციებს ძალისხმევის გარეშე შექმნან ნებისმიერი აპლიკაცია, ასევე გაავრცელონ და გაუშვან ისინი ნებისმიერ გარემოში - ჰიბრიდული ღრუბლებიდან დაწყებული კიდეების სისტემებამდე.

Docker შედგენა

Технология Docker შედგენა შექმნილია მრავალკონტეინერის აპლიკაციების კონფიგურაციისთვის. Docker Compose პროექტი შეიძლება შეიცავდეს იმდენ Docker კონტეინერს, რამდენიც პროექტის შემქმნელს სჭირდება.

Docker Compose-თან მუშაობისას YAML ფაილი გამოიყენება აპლიკაციის სერვისების კონფიგურაციისა და ერთმანეთთან ურთიერთქმედების ორგანიზებისთვის. ამრიგად, Docker Compose არის ინსტრუმენტი მრავალ კონტეინერის Docker აპლიკაციების აღწერისთვის და გასაშვებად.

ორი კონტეინერი მუშაობს მასპინძელ სისტემაზე

GNU ჩადება

პროგრამა make, არსებითად არის ინსტრუმენტი წყაროს კოდიდან პროგრამებისა და ბიბლიოთეკების აგების ავტომატიზაციისთვის. ზოგადად, შეგვიძლია ვთქვათ make ვრცელდება ნებისმიერ პროცესზე, რომელიც გულისხმობს თვითნებური ბრძანებების შესრულებას ზოგიერთი შეყვანის მასალის გადაქცევის რაღაც გამომავალ ფორმაში, რაღაც მიზნამდე. ჩვენს შემთხვევაში, ბრძანებები docker-compose გარდაიქმნება აბსტრაქტულ მიზნებად (ტელეფონის სამიზნეები).

რომ ვუთხრა პროგრამას make იმის შესახებ, თუ რა გვინდა მისგან, გვჭირდება ფაილი Makefile.

ჩვენს Makefile შეიცავს რეგულარულ ბრძანებებს docker и docker-compose, რომლებიც შექმნილია მრავალი პრობლემის გადასაჭრელად. კერძოდ, საუბარია კონტეინერის აწყობაზე, მის დაწყებაზე, გაჩერებაზე, გადატვირთვაზე, კონტეინერში მომხმარებლის შესვლის ორგანიზებაზე, კონტეინერის ჟურნალებთან მუშაობაზე და სხვა მსგავსი პრობლემების გადაჭრაზე.

ტიპიური გამოყენების შემთხვევები Docker Compose-ისთვის

წარმოვიდგინოთ ჩვეულებრივი ვებ აპლიკაცია, რომელსაც აქვს შემდეგი კომპონენტები:

• TimescaleDB მონაცემთა ბაზა (Postgres).
• Express.js აპლიკაცია.
• Ping (უბრალოდ კონტეინერი, არაფერს განსაკუთრებულს არ აკეთებს).

ამ აპლიკაციას დასჭირდება 3 Docker კონტეინერი და ფაილი docker-compose, რომელიც შეიცავს ამ კონტეინერების მართვის ინსტრუქციას. თითოეულ კონტეინერს ექნება სხვადასხვა შეხების წერტილი. მაგალითად, კონტეინერით timescale შესაძლებელი იქნება მუშაობა დაახლოებით ისე, როგორც ისინი მუშაობენ მონაცემთა ბაზებთან. კერძოდ, ის საშუალებას გაძლევთ შეასრულოთ შემდეგი მოქმედებები:

• შესვლა პოსტგრესის გარსში.
• მაგიდების იმპორტი და ექსპორტი.
• შექმნა pg_dump ცხრილები ან მონაცემთა ბაზები.

Express.js განაცხადის კონტეინერი, expressjs, შეიძლება ჰქონდეს შემდეგი შესაძლებლობები:

• ახალი მონაცემების მიწოდება სისტემის ჟურნალიდან.
• შედით shell-ში გარკვეული ბრძანებების შესასრულებლად.

კონტეინერებთან ურთიერთობა

მას შემდეგ რაც დავამყარებთ კომუნიკაციას კონტეინერებს შორის Docker Compose-ის გამოყენებით, დროა ამ კონტეინერებთან კომუნიკაცია. Docker Compose სისტემაში არის ბრძანება docker-compose, დამხმარე ვარიანტი -f, რომელიც საშუალებას გაძლევთ გადაიტანოთ ფაილი სისტემაში docker-compose.yml.

ამ პარამეტრის შესაძლებლობების გამოყენებით, თქვენ შეგიძლიათ შეზღუდოთ სისტემასთან ურთიერთქმედება მხოლოდ იმ კონტეინერებით, რომლებიც მითითებულია ფაილში docker-compose.yml.

მოდით შევხედოთ როგორ გამოიყურება კონტეინერებთან ურთიერთქმედება ბრძანებების გამოყენებისას docker-compose. თუ წარმოვიდგენთ, რომ ჩვენ გვჭირდება შესვლა shell-ში psql, მაშინ შესაბამისი ბრძანებები შეიძლება ასე გამოიყურებოდეს:

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

იგივე ბრძანება, რომელიც არ გამოიყენება შესასრულებლად docker-composeხოლო docker, შეიძლება ასე გამოიყურებოდეს:

docker exec -it  edp_timescale_1 psql -Upostgres

გთხოვთ გაითვალისწინოთ, რომ ასეთ შემთხვევებში ყოველთვის სასურველია ბრძანების გამოყენება dockerდა გუნდი docker-compose, რადგან ეს გამორიცხავს კონტეინერის სახელების დამახსოვრების აუცილებლობას.

ზემოთ ჩამოთვლილი ორივე ბრძანება არც ისე რთულია. მაგრამ თუ გამოვიყენებდით „შეფუთვას“ ფორმაში Makefile, რომელიც მოგვცემდა ინტერფეისს მარტივი ბრძანებების სახით და თავად უწოდებდა მსგავს გრძელ ბრძანებებს, მაშინ იგივე შედეგების მიღწევა შეიძლება ასე:

make db-shell

სავსებით აშკარაა, რომ გამოყენება Makefile გაცილებით აადვილებს კონტეინერებთან მუშაობას!

სამუშაო მაგალითი

ზემოაღნიშნული პროექტის დიაგრამაზე დაყრდნობით ჩვენ შევქმნით შემდეგ ფაილს 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

Docker Compose-ის კონფიგურაციის სამართავად და მის მიერ აღწერილ კონტეინერებთან ურთიერთობისთვის, ჩვენ შევქმნით შემდეგ ფაილს 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

აქ აღწერილი ბრძანებების უმეტესობა ვრცელდება ყველა კონტეინერზე, მაგრამ ამ ოფციის გამოყენებით c= საშუალებას გაძლევთ შეზღუდოთ ბრძანების ფარგლები ერთი კონტეინერით.

შემდეგ Makefile მზადაა, შეგიძლიათ გამოიყენოთ ეს ასე:

• make help - ყველა ბრძანების სიის გაცემა, რომელიც ხელმისაწვდომია make.

დახმარება ხელმისაწვდომი ბრძანებების შესახებ

• make build - სურათის აწყობა Dockerfile. ჩვენს მაგალითში გამოვიყენეთ არსებული სურათები timescale и ping. მაგრამ გამოსახულება api ჩვენ გვინდა ადგილობრივად შეგროვება. ეს არის ზუსტად ის, რაც გაკეთდება ამ ბრძანების შესრულების შემდეგ.

Docker კონტეინერის აშენება

• make start - ყველა კონტეინერის გაშვება. მხოლოდ ერთი კონტეინერის გასაშვებად, შეგიძლიათ გამოიყენოთ ბრძანება, როგორიცაა make start c=timescale.

დროის მასშტაბის კონტეინერის გაშვება

პინგ კონტეინერის გაშვება

• make login-timescale — შედით კონტეინერის bash სესიაზე timescale.

ბაშის გაშვება დროის მასშტაბის კონტეინერში

• make db-shell - შესასვლელი psql კონტეინერში timescale მონაცემთა ბაზის წინააღმდეგ SQL მოთხოვნების შესასრულებლად.

psql-ის გაშვება timescaledb კონტეინერში

• make stop - შესაჩერებელი კონტეინერები.

დროის მასშტაბის კონტეინერის გაჩერება

• make down - კონტეინერების შეჩერება და ამოღება. კონკრეტული კონტეინერის ამოსაღებად, შეგიძლიათ გამოიყენოთ ეს ბრძანება სასურველი კონტეინერის მითითებით. Მაგალითად - make down c=timescale ან make down c=api.

ყველა კონტეინერის შეჩერება და წაშლა

შედეგები

მიუხედავად იმისა, რომ Docker Compose გვაძლევს ბრძანებების მდიდარ კომპლექტს კონტეინერების მართვისთვის, ზოგჯერ ეს ბრძანებები შეიძლება გახდეს ხანგრძლივი და რთული დასამახსოვრებელი.

გამოყენების მეთოდი Makefile დაგვეხმარა ფაილიდან კონტეინერებთან სწრაფი და მარტივი ურთიერთქმედების დამყარებაში docker-compose.yml. კერძოდ, საუბარია შემდეგზე:

• დეველოპერი ურთიერთქმედებს მხოლოდ პროექტში აღწერილ კონტეინერებთან docker-compose.yml, მუშაობას ხელს არ უშლის სხვა გაშვებული კონტეინერები.
• იმ შემთხვევაში, თუ გარკვეული ბრძანება დავიწყებულია, შეგიძლიათ შეასრულოთ ბრძანება make help და მიიღეთ დახმარება ხელმისაწვდომი ბრძანებების შესახებ.
• თქვენ არ გჭირდებათ არგუმენტების გრძელი სიების დამახსოვრება ისეთი მოქმედებების შესასრულებლად, როგორიცაა ჟურნალის უახლესი ჩანაწერების მიღება ან სისტემაში შესვლა. მაგალითად, ბრძანება, როგორიცაა docker-compose -f docker-compose.yml exec timescale psql -Upostgres გარდაიქმნება, გადაიქცევა make db-shell.
• ფაილი Makefile თქვენ შეგიძლიათ მოქნილად მოერგოთ მას, როგორც პროექტი იზრდება. მაგალითად, მარტივია ბრძანების დამატება მონაცემთა ბაზის სარეზერვო ასლის შესაქმნელად ან რაიმე სხვა მოქმედების შესასრულებლად.
• თუ დეველოპერების დიდი გუნდი იყენებს იგივეს Makefile, ეს აუმჯობესებს თანამშრომლობას და ამცირებს შეცდომებს.

PS ჩვენს ბაზარი არის სურათი docker, რომლის დაყენება შესაძლებელია ერთი დაწკაპუნებით. კონტეინერების მუშაობის შემოწმება შეგიძლიათ აქ VPS. ყველა ახალ კლიენტს ეძლევა 3 დღიანი ტესტირება უფასოდ.

ძვირფასო მკითხველს! როგორ ავტომატიზირებთ Docker Compose-ს?

წყარო: www.habr.com