Docker Compose სახელმძღვანელო დამწყებთათვის

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

რა არის Docker Compose?

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

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

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

Docker Compose ტექნოლოგია, თუ მას გამარტივებულად აღწერთ, საშუალებას გაძლევთ დაიწყოთ მრავალი სერვისი ერთი ბრძანებით.

განსხვავება Docker-სა და Docker Compose-ს შორის

Docker გამოიყენება ინდივიდუალური კონტეინერების (სერვისების) სამართავად, რომლებიც ქმნიან აპლიკაციას.

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

Docker (ერთი კონტეინერი) და Docker Compose (მრავალჯერადი კონტეინერი)

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

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

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

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

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

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

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

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

გთხოვთ გაითვალისწინოთ, რომ ჩვენ ვივარაუდებთ, რომ თქვენ გაქვთ Docker-ის საფუძვლები და რომ თქვენ უკვე გაქვთ დაინსტალირებული Docker პლატფორმა.

დავიწყოთ პროექტზე მუშაობა.

▍1. შექმენით პროექტი

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

• ფაილი docker-compose.yml. ეს არის Docker Compose ფაილი, რომელიც შეიცავს სერვისების დასაწყებად და კონფიგურაციისთვის საჭირო ინსტრუქციებს.
• საქაღალდე server. ის შეიცავს ფაილებს, რომლებიც აუცილებელია სერვერის მუშაობისთვის.
• საქაღალდე client. აქ განთავსდება კლიენტის აპლიკაციის ფაილები.

შედეგად, თქვენი პროექტის მთავარი საქაღალდის შინაარსი ასე უნდა გამოიყურებოდეს:

.
├── client/
├── docker-compose.yml
└── server/
2 directories, 1 file

▍2. სერვერის შექმნა

აქ ჩვენ, სერვერის შექმნის პროცესში, შევეხებით რამდენიმე ძირითად საკითხს Docker-თან დაკავშირებით.

2ა. ფაილების შექმნა

გადადით საქაღალდეში server და შექმენით მასში შემდეგი ფაილები:

• ფაილი server.py. ის შეიცავს სერვერის კოდს.
• ფაილი index.html. ეს ფაილი შეიცავს ტექსტის ნაწილს, რომელიც უნდა აჩვენოს კლიენტის აპლიკაციამ.
• ფაილი Dockerfile. ეს არის Docker ფაილი, რომელიც შეიცავს სერვერის გარემოს შესაქმნელად საჭირო ინსტრუქციებს.

ასე უნდა გამოიყურებოდეს თქვენი საქაღალდის შიგთავსი server/:

.
├── Dockerfile
├── index.html
└── server.py
0 directories, 3 files

2ბ. პითონის ფაილის რედაქტირება.

ფაილში დამატება server.py შემდეგი კოდი:

#!/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()

ეს კოდი საშუალებას გაძლევთ შექმნათ მარტივი ვებ სერვერი. ის მისცემს კლიენტებს ფაილს index.html, რომლის შინაარსი მოგვიანებით გამოჩნდება ვებ გვერდზე.

2c. HTML ფაილის რედაქტირება

Შეიტანოს index.html დაამატეთ შემდეგი ტექსტი:

Docker-Compose is magic!

ეს ტექსტი გაეგზავნება კლიენტს.

2d. Dockerfile-ის რედაქტირება

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

# На всякий случай напоминаю, что 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/

ახლა მოდით ვიმუშაოთ კლიენტზე.

▍3. შექმენით კლიენტი

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

3ა. ფაილების შექმნა

გადადით თქვენი პროექტის საქაღალდეში client და შექმენით მასში შემდეგი ფაილები:

• ფაილი client.py. კლიენტის კოდი განთავსებული იქნება აქ.
• ფაილი Dockerfile. ეს ფაილი ასრულებს იგივე როლს, როგორც მსგავსი ფაილი სერვერის საქაღალდეში. კერძოდ, ის შეიცავს განცხადებას, რომელიც აღწერს როგორ შევქმნათ გარემო კლიენტის კოდის შესასრულებლად.

შედეგად, თქვენი საქაღალდე client/ ამ ეტაპზე ის ასე უნდა გამოიყურებოდეს:

.
├── client.py
└── Dockerfile
0 directories, 2 files

3ბ. პითონის ფაილის რედაქტირება

ფაილში დამატება client.py შემდეგი კოდი:

#!/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()

ამ კოდით კლიენტის აპლიკაციას შეუძლია სერვერიდან მონაცემების ჩამოტვირთვა და ეკრანზე ჩვენება.

3c. Dockerfile-ის რედაქტირება

როგორც სერვერის შემთხვევაში, კლიენტისთვისაც ვქმნით მარტივს Dockerfile, პასუხისმგებელი გარემოს ფორმირებაზე, რომელშიც Python კლიენტის აპლიკაცია იმუშავებს. აქ არის კლიენტის კოდი Dockerfile:

# То же самое, что и в серверном Dockerfile.

FROM python:latest

# Импортируем 'client.py' в папку '/client/'.

ADD client.py /client/

# Устанавливаем в качестве рабочей директории '/client/'.

WORKDIR /client/

▍4. Docker Compose

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

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

აქ არის ფაილში ჩასაწერი კოდი 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. პროექტის აშენება

შესვლის შემდეგ docker-compose.yml ყველა საჭირო ინსტრუქცია გაკეთდა, პროექტი უნდა აწყობილიყო. ჩვენი მუშაობის ეს ნაბიჯი წააგავს ბრძანების გამოყენებას docker build, მაგრამ შესაბამისი ბრძანება დაკავშირებულია რამდენიმე სერვისთან:

$ docker-compose build

▍6. პროექტის გაშვება

ახლა, როდესაც პროექტი აშენდა, მისი გაშვების დროა. ჩვენი მუშაობის ეს ეტაპი შეესაბამება იმ საფეხურს, რომლის დროსაც ინდივიდუალურ კონტეინერებთან მუშაობისას შესრულებულია ბრძანება docker run:

$ docker-compose up

ამ ბრძანების შესრულების შემდეგ, კლიენტის მიერ სერვერიდან დატვირთული ტექსტი უნდა გამოჩნდეს ტერმინალში: Docker-Compose is magic!.

როგორც უკვე აღვნიშნეთ, სერვერი იყენებს კომპიუტერის პორტს 1234 მომხმარებელთა მოთხოვნების დასაკმაყოფილებლად. ამიტომ, თუ ბრაუზერში მიდიხარ მისამართზე http://localhost:1234/, ის აჩვენებს გვერდს ტექსტით Docker-Compose is magic!.

სასარგებლო ბრძანებები

მოდით გადავხედოთ რამდენიმე ბრძანებას, რომელიც შეიძლება გამოგადგებათ Docker Compose-თან მუშაობისას.

ეს ბრძანება საშუალებას გაძლევთ შეაჩეროთ და წაშალოთ ბრძანებით შექმნილი კონტეინერები და სხვა რესურსები docker-compose up:

$ docker-compose down

ეს ბრძანება ბეჭდავს სერვისის ჟურნალებს:

$ docker-compose logs -f [service name]

მაგალითად, ჩვენს პროექტში ის შეიძლება გამოყენებულ იქნას ამ ფორმით: $ docker-compose logs -f [service name].

ამ ბრძანების გამოყენებით შეგიძლიათ აჩვენოთ კონტეინერების სია:

$ docker-compose ps

ეს ბრძანება საშუალებას გაძლევთ შეასრულოთ ბრძანება გაშვებულ კონტეინერში:

$ docker-compose exec [service name] [command]

მაგალითად, შეიძლება ასე გამოიყურებოდეს: docker-compose exec server ls.

ეს ბრძანება საშუალებას გაძლევთ აჩვენოთ სურათების სია:

$ docker-compose images

შედეგები

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

ძვირფასო მკითხველს! იყენებთ Docker Compose-ს თქვენს პროექტებში?

წყარო: www.habr.com