Доцкер Цомпосе: Поједностављивање вашег рада помоћу Макефилес-а

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

Велике монолитне услуге сада се замењују независним, аутономним микросервисима. Микросервис се може сматрати апликацијом која служи једној и веома специфичној сврси. На пример, то може бити релациони ДБМС, Екпресс апликација, Солр сервис.

Ових дана је тешко замислити развој новог софтверског система без коришћења микросервиса. А ова ситуација нас, заузврат, води до Доцкер платформе.

лучки радник

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

Доцкер Цомпосе

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

Када радите са Доцкер Цомпосе, ИАМЛ датотека се користи за конфигурисање услуга апликације и организовање њихове међусобне интеракције. Доцкер Цомпосе је стога алатка за описивање и покретање Доцкер апликација са више контејнера.

Два контејнера раде на хост систему

ГНУ Маке

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

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

У нашем Makefile садржаће редовне команде docker и docker-compose, који су дизајнирани да реше многе проблеме. Наиме, говоримо о састављању контејнера, о његовом покретању, заустављању, поновном покретању, о организовању пријављивања корисника у контејнер, о раду са евиденцијама контејнера и о решавању других сличних проблема.

Типични случајеви употребе за Доцкер Цомпосе

Замислимо обичну веб апликацију која има следеће компоненте:

• ТимесцалеДБ база података (Постгрес).
• Екпресс.јс апликација.
• Пинг (само контејнер, не ради ништа посебно).

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

• Пријављивање у Постгрес схелл.
• Увоз и извоз табела.
• стварање pg_dump табеле или базе података.

Екпресс.јс контејнер апликације, expressjs, може имати следеће могућности:

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

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

Када успоставимо комуникацију између контејнера користећи Доцкер Цомпосе, време је да комуницирамо са тим контејнерима. У оквиру система Доцкер Цомпосе постоји команда 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

За управљање конфигурацијом Доцкер Цомпосе и интеракцију са контејнерима које описује, креираћемо следећу датотеку 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 желимо да прикупљамо локално. Управо то ће бити урађено након извршења ове команде.

Прављење Доцкер контејнера

• make start — лансирање свих контејнера. Да бисте покренули само један контејнер, можете користити команду попут make start c=timescale.

Покретање контејнера временског оквира

Покретање пинг контејнера

• make login-timescale — пријавите се на басх сесију контејнера timescale.

Покретање басх-а у контејнеру временске скале

• make db-shell - улаз у psql у контејнеру timescale за извршавање СКЛ упита према бази података.

Покретање пскл-а у контејнеру са временским ограничењем

• make stop — заустављање контејнера.

Заустављање контејнера временске скале

• make down — заустављање и уклањање контејнера. Да бисте уклонили одређени контејнер, можете користити ову наредбу која наводи жељени контејнер. На пример - make down c=timescale или make down c=api.

Заустављање и брисање свих контејнера

Резултати

Иако нам Доцкер Цомпосе даје богат скуп команди за управљање контејнерима, понекад ове команде могу постати дугачке и тешко их је запамтити.

Начин употребе Makefile помогла нам је да успоставимо брзу и лаку интеракцију са контејнерима из датотеке docker-compose.yml. Наиме, говоримо о следећем:

• Програмер комуницира само са пројектним контејнерима описаним у docker-compose.yml, рад не ометају други покретни контејнери.
• У случају да је одређена команда заборављена, можете је извршити make help и добити помоћ за доступне команде.
• Не морате да памтите дугачке листе аргумената да бисте извршили радње као што су добијање најновијих уноса у евиденцији или пријављивање у систем. На пример, команда попут docker-compose -f docker-compose.yml exec timescale psql -Upostgres претвара у make db-shell.
• фајл Makefile Можете му се флексибилно прилагодити како пројекат расте. На пример, лако је додати команду за креирање резервне копије базе података или обављање било које друге радње.
• Ако велики тим програмера користи исто Makefile, ово поједностављује сарадњу и смањује грешке.

ПС У нашем маркетплаце постоји слика лучки радник, који се може инсталирати једним кликом. Можете проверити рад контејнера на ВПС. Свим новим клијентима се даје 3 дана тестирања бесплатно.

Драги читаоци! Како аутоматизујете Доцкер Цомпосе?

Извор: ввв.хабр.цом