Docker Compose: Поедноставување на вашата работа со помош на Makefiles

На секои неколку години, индустријата за развој на софтвер претрпува промена на парадигмата. Еден од овие феномени може да се препознае како зголемениот интерес за концептот на микроуслуги. Иако микросервисите не се најновата технологија, дури неодамна нејзината популарност буквално вртоглаво порасна.

Големите монолитни услуги сега се заменуваат со независни, автономни микросервиси. Микросервис може да се смета како апликација која служи за единствена и многу специфична цел. На пример, тоа може да биде релациона DBMS, Express апликација, услуга Solr.

Деновиве, тешко е да се замисли развој на нов софтверски систем без користење на микросервиси. И оваа ситуација, пак, нè води до платформата Docker.

пристанишен работник

Платформа пристанишен работник, во развојот и распоредувањето на микросервисите, стана речиси индустриски стандард. На веб-локацијата на проектот можете да дознаете дека Docker е единствената независна платформа за контејнеризација која им овозможува на организациите без напор да креираат каква било апликација, како и да ги дистрибуираат и стартуваат во која било средина - од хибридни облаци до рабни системи.

Докер Компонирај

Технология Докер Компонирај дизајниран за конфигурирање на апликации со повеќе контејнери. Проектот Docker Compose може да содржи онолку Docker контејнери колку што му треба на креаторот на проектот.

Кога работите со Docker Compose, датотеката YAML се користи за конфигурирање на апликативните услуги и организирање на нивната интеракција едни со други. Затоа, Docker Compose е алатка за опишување и извршување на апликациите Docker со повеќе контејнери.

Два контејнери работат на систем домаќин

Направете ГНУ

Програма make, во суштина е алатка за автоматизирање на градењето на програми и библиотеки од изворниот код. Во принцип, можеме да го кажеме тоа make се однесува на секој процес кој вклучува извршување на произволни команди за трансформирање на некои влезни материјали во некоја излезна форма, до некоја цел. Во нашиот случај, командите docker-compose ќе се трансформираат во апстрактни цели (Телефонски цели).

Да ја кажам програмата make за тоа што сакаме од него, ни треба датотека Makefile.

Во нашата Makefile ќе содржи редовни команди docker и docker-compose, кои се дизајнирани да решаваат многу проблеми. Имено, зборуваме за склопување на контејнер, за негово стартување, запирање, рестартирање, за организирање на најавување на корисникот во контејнерот, за работа со дневници на контејнери и за решавање на други слични проблеми.

Типични случаи за употреба за Docker Compose

Ајде да замислиме обична веб-апликација која ги има следните компоненти:

• TimescaleDB база на податоци (Postgres).
• Апликација Express.js.
• Пинг (само контејнер, не прави ништо посебно).

На оваа апликација ќе ѝ бидат потребни 3 контејнери за Docker и датотека docker-compose, кој содржи упатства за управување со овие контејнери. Секој контејнер ќе има различни точки на допир. На пример, со контејнер timescale ќе може да се работи приближно на ист начин како што работат со бази на податоци. Имено, ви овозможува да ги извршите следните дејства:

• Најавување во школка Postgres.
• Увоз и извоз на табели.
• создавање pg_dump табели или бази на податоци.

Контејнер за апликација Express.js, expressjs, може да ги има следните способности:

• Обезбедување свежи податоци од системскиот дневник.
• Пријавете се во школка за да извршите одредени команди.

Интеракција со контејнери

Откако ќе поставиме комуникација помеѓу контејнерите користејќи Docker Compose, време е да комуницираме со тие контејнери. Во рамките на системот Docker Compose постои команда docker-compose, опција за поддршка -f, кој ви овозможува да префрлите датотека во системот docker-compose.yml.

Користејќи ги можностите на оваа опција, можете да ја ограничите интеракцијата со системот само на оние контејнери што се споменати во датотеката docker-compose.yml.

Ајде да погледнеме како изгледаат интеракциите со контејнерите при користење на команди docker-compose. Ако замислиме дека треба да се најавиме во школка 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 — најавете се на баш сесијата на контејнерот 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 Во нашата пазар има слика пристанишен работник, кој се инсталира со еден клик. Можете да проверите на кои контејнерите работат VPS. Сите нови клиенти добиваат 3 дена тестирање бесплатно.

Почитувани читатели! Како се автоматизира Docker Compose?

Извор: www.habr.com