Autor članka čiji prevod danas objavljujemo tvrdi da je on namenjen onim programerima koji žele da nauče Docker Compose i teže ka tome da kreiraju svoju prvu klijentsko-server aplikaciju koristeći Docker. Pretpostavlja se da je čitalac ovog materijala upoznat sa osnovama Docker-a. Ako nije — možete pogledati seriju materijala na objavu, gde su osnove Docker-a obrađene zajedno sa osnovama Kubernetes-a, i na članak za početnike.
Šta je Docker Compose?
Docker Compose je alat koji je deo Docker-a. Namenjen je rešavanju zadataka vezanih za implementaciju projekata.
Proučavajući osnove Docker-a, mogli ste se susresti sa kreiranjem najosnovnijih aplikacija koje funkcionišu autonomno, nezavisno, na primer, od spoljašnjih izvora podataka ili nekih servisa. U praksi, takve aplikacije su retkost. Stvarni projekti obično uključuju ceo niz aplikacija koje rade zajedno.
Kako znati da li vam je, prilikom implementacije određenog projekta, potreban Docker Compose? U stvari — vrlo je jednostavno. Ako za funkcionisanje tog projekta koristi više servisa, Docker Compose može biti od pomoći. Na primer, u situaciji kada se kreira veb-sajt koji, za realizaciju autentifikacije korisnika, treba da se poveže sa bazom podataka. Takav projekat može da se sastoji od dva servisa — onog koji obezbeđuje rad sajta i onog koji je zadužen za održavanje baze podataka.
Tehnologija Docker Compose, pojednostavljeno rečeno, omogućava, pomoću jedne komande, pokretanje više servisa.
Razlika između Docker-a i Docker Compose-a
Docker se koristi za upravljanje pojedinačnim kontejnerima (servisima) od kojih se sastoji aplikacija.
Docker Compose se koristi za simultano upravljanje više kontejnera koji su deo aplikacije. Ovaj alat nudi iste mogućnosti kao i Docker, ali omogućava rad sa složenijim aplikacijama.

Docker (pojedinačni kontejner) i Docker Compose (više kontejnera)
Tipičan scenario korišćenja Docker Compose-a
Docker Compose — u veštim rukama veoma moćan alat koji omogućava brzo postavljanje aplikacija sa složenom arhitekturom. Sada ćemo razmotriti primer praktične upotrebe Docker Compose, čija analiza će vam pomoći da uočite prednosti koje donosi korišćenje Docker Compose.
Zamislite da ste programer nekog veb projekta. Ovaj projekat sadrži dva veb sajta. Prvi omogućava ljudima koji se bave biznisom da kreiraju internet prodavnice u samo nekoliko klikova. Drugi je fokusiran na podršku korisnicima. Ova dva sajta interaguju sa istom bazom podataka.
Vaš projekat postaje sve popularniji i shvatate da snaga servera na kojem radi više nije dovoljna. Kao rezultat toga, odlučujete da prebacite ceo projekat na drugu mašinu.
Nažalost, sličan Docker Compose nikada niste koristili. Zato ćete morati da premeštate i rekonfigurirate servise jedan po jedan, nadajući se da ništa nećete zaboraviti tokom ovog procesa.
Međutim, ako koristite Docker Compose, prebacivanje vašeg projekta na novi server pitanje je koje se rešava izvršavanjem nekoliko komandi. Da biste završili prebacivanje projekta na novo mesto, treba da izvršite samo neke konfiguracije i prenesete rezervnu kopiju baze podataka na novi server.
Razvoj klijent-server aplikacije koristeći Docker Compose
Sada kada znate za šta ćemo koristiti Docker Compose, došlo je vreme da kreirate svoju prvu klijent-server aplikaciju koristeći ovaj alat. Naime, reč je o razvoju malog veb sajta (servera) na Pythonu koji može da izda datoteku sa delom teksta. Ovu datoteku zahteva program (klijent), takođe napisan na Pythonu. Nakon što primi datoteku sa servera, program ispisuje tekst koji se u njoj nalazi na ekranu.
Imajte na umu da očekujemo da znate osnove Dockera i da ste već instalirali Docker platformu.
Hajde da započnemo rad na projektu.
▍1. Kreiranje projekta
Da biste izgradili svoju prvu klijent-server aplikaciju, predlažem da počnete sa kreiranjem mape projekta. Ona treba da sadrži sledeće datoteke i mape:
- Datoteka
docker-compose.ymlOvo je Docker Compose datoteka koja će sadržavati upute potrebne za pokretanje i konfiguraciju usluga. - Mapa
serverOna će sadržavati datoteke potrebne za rad poslužitelja. - Mapa
clientOvdje će se nalaziti datoteke klijentske aplikacije.
Kao rezultat, sadržaj glavne mape vašeg projekta trebao bi izgledati ovako:
.
├── client/
├── docker-compose.yml
└── server/
2 direktorija, 1 datoteka▍2. Kreiranje poslužitelja
Ovde ćemo, tokom kreiranja poslužitelja, obraditi neke osnovne stvari vezane za Docker.
2a. Kreiranje datoteka
Pređite u mapu server i kreirajte u njoj sljedeće datoteke:
- Datoteka
server.py. U njoj će biti kod poslužitelja. - Datoteka
index.html. U ovoj datoteci će se nalaziti deo teksta koji će klijentska aplikacija prikazati. - Datoteka
Dockerfile. Ovo je Docker datoteka koja će sadržavati upute potrebne za kreiranje okruženja poslužitelja.
Evo kako bi trebalo izgledati sadržaj vaše mape server/:
.
├── Dockerfile
├── index.html
└── server.py
0 direktorija, 3 datoteke2b. Uređivanje Python datoteke.
Dodajmo u datoteku server.py sljedeći kod:
#!/usr/bin/env python3
# Импорт системных библиотек python.
# Эти библиотеки будут использоваться для создания веб-сервера.
# Вам не нужно устанавливать что-то особенное, эти библиотеки устанавливаются вместе с Python.
import http.server
import socketserver
# Эта переменная нужна для обработки запросов клиента к серверу.
handler = http.server.SimpleHTTPRequestHandler
# Тут мы указываем, что сервер мы хотим запустить на порте 1234.
# Постарайтесь запомнить эти сведения, так как они нам очень пригодятся в дальнейшем, при работе с docker-compose.
with socketserver.TCPServer(("", 1234), handler) as httpd:
# Благодаря этой команде сервер будет выполняться постоянно, ожидая запросов от клиента.
httpd.serve_forever() Ovaj kod omogućava kreiranje jednostavnog web poslužitelja. On će klijentima slati datoteku index.html, čiji sadržaj će kasnije biti prikazan na web stranici.
2c. Uređivanje HTML datoteke
U datoteku index.html dodajmo sljedeći tekst:
Docker-Compose je čarolija!Ovaj tekst će biti poslat klijentu.
2d. Uređivanje datoteke Dockerfile
Sada ćemo kreirati jednostavnu datoteku Dockerfile, koja će biti odgovorna za organizaciju radnog okruženja za Python poslužitelj. Kao osnovu za stvoreni sliku koristićemo , koja je namenjena za pokretanje programa pisanih u Pythonu. Evo sadržaja Dockerfile-a:
# На всякий случай напоминаю, что Dockerfile всегда должен начинаться с импорта базового образа.
# Для этого используется ключевое слово 'FROM'.
# Здесь нам нужно импортировать образ python (с DockerHub).
# В результате мы, в качестве имени образа, указываем 'python', а в качестве версии - 'latest'.
FROM python:latest
# Для того чтобы запустить в контейнере код, написанный на Python, нам нужно импортировать файлы 'server.py' и 'index.html'.
# Для того чтобы это сделать, мы используем ключевое слово 'ADD'.
# Первый параметр, 'server.py', представляет собой имя файла, хранящегося на компьютере.
# Второй параметр, '/server/', это путь, по которому нужно разместить указанный файл в образе.
# Здесь мы помещаем файл в папку образа '/server/'.
ADD server.py /server/
ADD index.html /server/
# Здесь мы воспользуемся командой 'WORKDIR', возможно, новой для вас.
# Она позволяет изменить рабочую директорию образа.
# В качестве такой директории, в которой будут выполняться все команды, мы устанавливаем '/server/'.
WORKDIR /server/Sada se možemo posvetiti radu na klijentu.
▍3. Kreiranje klijenta
Kreirajući klijentski deo našeg projekta, takođe ćemo se prisetiti nekih osnova Dockera.
3a. Kreiranje datoteka
Pređite u mapu vašeg projekta client i kreirajte u njoj sljedeće datoteke:
- Datoteka
client.py. Ovdje će se nalaziti kod klijenta. - Datoteka
Dockerfile. Ova datoteka ima istu ulogu kao i odgovarajuća datoteka u mapi poslužitelja. Naime, ona sadrži instrukciju koja opisuje kreiranje okruženja za izvršavanje klijentskog koda.
Kao rezultat, vaša mapa client/ u ovoj fazi rada trebala bi izgledati ovako:
.
├── client.py
└── Dockerfile
0 direktorija, 2 datoteke3b. Uređivanje Python datoteke
Dodajmo u datoteku client.py sljedeći kod:
#!/usr/bin/env python3
# Импортируем системную библиотеку Python.
# Она используется для загрузки файла 'index.html' с сервера.
# Ничего особенного устанавливать не нужно, эта библиотека устанавливается вместе с Python.
import urllib.request
# Эта переменная содержит запрос к 'http://localhost:1234/'.
# Возможно, сейчас вы задаётесь вопросом о том, что такое 'http://localhost:1234'.
# localhost указывает на то, что программа работает с локальным сервером.
# 1234 - это номер порта, который вам предлагалось запомнить при настройке серверного кода.
fp = urllib.request.urlopen("http://localhost:1234/")
# 'encodedContent' соответствует закодированному ответу сервера ('index.html').
# 'decodedContent' соответствует раскодированному ответу сервера (тут будет то, что мы хотим вывести на экран).
encodedContent = fp.read()
decodedContent = encodedContent.decode("utf8")
# Выводим содержимое файла, полученного с сервера ('index.html').
print(decodedContent)
# Закрываем соединение с сервером.
fp.close()Zahvaljujući ovom kodu, klijentska aplikacija može učitati podatke sa servera i prikazati ih na ekranu.
3c. Uređivanje datoteke Dockerfile
Kao i u slučaju servera, kreiramo za klijenta jednostavno Dockerfile, odgovoran za formiranje okruženja u kojem će raditi klijentska Python aplikacija. Evo koda klijenta Dockerfile:
# То же самое, что и в серверном Dockerfile.
FROM python:latest
# Импортируем 'client.py' в папку '/client/'.
ADD client.py /client/
# Устанавливаем в качестве рабочей директории '/client/'.
WORKDIR /client/▍4. Docker Compose
Kao što ste mogli primetiti, kreirali smo dva različita projekta: server i klijent. Svaki od njih ima svoju datoteku Dockerfile. Do sada, sve što se dešavalo ne izlazi iz osnovnog rada sa Docker-om. Sada prelazimo na rad sa Docker Compose-om. U tu svrhu pozivamo datoteku docker-compose.yml, smeštenu u root folderu projekta.
Obratite pažnju na to da ovde ne pokušavamo da razmotrimo apsolutno sve komande koje se mogu koristiti u docker-compose.yml. Naš glavni cilj je razraditi praktičan primer, koji vam pruža osnovno znanje o Docker Compose-u.
Evo koda koji treba staviti u datoteku docker-compose.yml:
# Файл docker-compose должен начинаться с тега версии.
# Мы используем "3" так как это - самая свежая версия на момент написания этого кода.
version: "3"
# Следует учитывать, что docker-composes работает с сервисами.
# 1 сервис = 1 контейнер.
# Сервисом может быть клиент, сервер, сервер баз данных...
# Раздел, в котором будут описаны сервисы, начинается с 'services'.
services:
# Как уже было сказано, мы собираемся создать клиентское и серверное приложения.
# Это означает, что нам нужно два сервиса.
# Первый сервис (контейнер): сервер.
# Назвать его можно так, как нужно разработчику.
# Понятное название сервиса помогает определить его роль.
# Здесь мы, для именования соответствующего сервиса, используем ключевое слово 'server'.
server:
# Ключевое слово "build" позволяет задать
# путь к файлу Dockerfile, который нужно использовать для создания образа,
# который позволит запустить сервис.
# Здесь 'server/' соответствует пути к папке сервера,
# которая содержит соответствующий Dockerfile.
build: server/
# Команда, которую нужно запустить после создания образа.
# Следующая команда означает запуск "python ./server.py".
command: python ./server.py
# Вспомните о том, что в качестве порта в 'server/server.py' указан порт 1234.
# Если мы хотим обратиться к серверу с нашего компьютера (находясь за пределами контейнера),
# мы должны организовать перенаправление этого порта на порт компьютера.
# Сделать это нам поможет ключевое слово 'ports'.
# При его использовании применяется следующая конструкция: [порт компьютера]:[порт контейнера]
# В нашем случае нужно использовать порт компьютера 1234 и организовать его связь с портом
# 1234 контейнера (так как именно на этот порт сервер
# ожидает поступления запросов).
ports:
- 1234:1234
# Второй сервис (контейнер): клиент.
# Этот сервис назван 'client'.
client:
# Здесь 'client/ соответствует пути к папке, которая содержит
# файл Dockerfile для клиентской части системы.
build: client/
# Команда, которую нужно запустить после создания образа.
# Следующая команда означает запуск "python ./client.py".
command: python ./client.py
# Ключевое слово 'network_mode' используется для описания типа сети.
# Тут мы указываем то, что контейнер может обращаться к 'localhost' компьютера.
network_mode: host
# Ключевое слово 'depends_on' позволяет указывать, должен ли сервис,
# прежде чем запуститься, ждать, когда будут готовы к работе другие сервисы.
# Нам нужно, чтобы сервис 'client' дождался бы готовности к работе сервиса 'server'.
depends_on:
- server▍5. Izgradnja projekta
Nakon što su u docker-compose.yml unete sve potrebne instrukcije, projekat treba izgraditi. Ovaj korak naše posla podseća na korišćenje komande docker build, ali odgovarajuća komanda se odnosi na nekoliko servisa:
$ docker-compose build▍6. Pokretanje projekta
Sada, kada je projekat izgrađen, došlo je vreme da ga pokrenemo. Ovaj korak naše posla odgovara koraku u kojem, prilikom rada sa pojedinačnim kontejnerima, izvršavamo komandu docker run:
$ docker-compose up Nakon izvršenja ove komande, u terminalu bi trebao da se prikaže tekst koji je klijent učitao sa servera: Docker-Compose je čarolija!.
Kao što je već rečeno, server koristi port računara 1234 za posluživanje zahteva klijenta. Zato, ako pređete u pregledaču na adresu , prikazaće se stranica sa tekstom Docker-Compose je čarolija!.
Korisne komande
Razmotrićemo neke komande koje vam mogu biti od pomoći pri radu sa Docker Compose-om.
Ova komanda omogućava zaustavljanje i uklanjanje kontejnera i drugih resursa koje je kreirala komanda docker-compose up:
$ docker-compose downOva komanda prikazuje logove servisa:
$ docker-compose logs -f [service name] Na primer, u našem projektu može se koristiti ovako: $ docker-compose logs -f [service name].
Pomoću ove komande možete da prikažete listu kontejnera:
$ docker-compose psOva komanda omogućava izvršenje komande u aktivnom kontejneru:
$ docker-compose exec [service name] [command] Na primer, može izgledati ovako: docker-compose exec server ls.
Ova komanda omogućava prikazivanje liste slika:
$ docker-compose imagesZaključci
Istražili smo osnove rada s tehnologijom Docker Compose, čije znanje će vam omogućiti da koristite ovu tehnologiju i, ako želite, započnete dublje proučavanje. repozitorij sa kodom projekta koji smo ovdje razmatrali.
Poštovani čitatelji! Koristite li Docker Compose u svojim projektima?
Izvor: habr.com
