🥇डॉकर कंपोज़ के लिए एक शुरुआती मार्गदर्शिका

लेख के लेखक, जिसका अनुवाद हम आज प्रकाशित कर रहे हैं, का कहना है कि यह उन डेवलपर्स के लिए है जो डॉकर कंपोज़ सीखना चाहते हैं और डॉकर का उपयोग करके अपना पहला क्लाइंट-सर्वर एप्लिकेशन बनाने की ओर बढ़ रहे हैं। यह माना जाता है कि इस सामग्री का पाठक डॉकर की मूल बातों से परिचित है। अगर ऐसा नहीं है तो आप देख सकते हैं यह सामग्री की श्रृंखला पर यह कुबेरनेट्स बेसिक्स के साथ डॉकर बेसिक्स को कवर करने वाला पोस्ट, और यह शुरुआती लोगों के लिए लेख.

डॉकर कंपोज़ क्या है?

डॉकर कंपोज़ डॉकर के साथ शामिल एक उपकरण है। इसे प्रोजेक्ट परिनियोजन से संबंधित समस्याओं को हल करने के लिए डिज़ाइन किया गया है।

डॉकर की मूल बातें सीखते समय, आपको सरल अनुप्रयोगों के निर्माण का सामना करना पड़ा होगा जो स्वायत्त रूप से काम करते हैं और निर्भर नहीं होते हैं, उदाहरण के लिए, बाहरी डेटा स्रोतों या कुछ सेवाओं पर। व्यवहार में, ऐसे अनुप्रयोग दुर्लभ हैं। वास्तविक परियोजनाओं में आमतौर पर एक साथ काम करने वाले अनुप्रयोगों का एक पूरा सेट शामिल होता है।

आपको कैसे पता चलेगा कि किसी प्रोजेक्ट को तैनात करते समय आपको डॉकर कंपोज़ का उपयोग करने की आवश्यकता है? यह वास्तव में बहुत सरल है. यदि आप इस प्रोजेक्ट को कार्यान्वित करने के लिए एकाधिक सेवाओं का उपयोग करते हैं, तो डॉकर कंपोज़ काम में आ सकता है। उदाहरण के लिए, ऐसी स्थिति में जहां वे एक वेबसाइट बनाते हैं जिसे उपयोगकर्ताओं को प्रमाणित करने के लिए डेटाबेस से कनेक्ट करने की आवश्यकता होती है। ऐसी परियोजना में दो सेवाएँ शामिल हो सकती हैं - एक जो साइट के संचालन को सुनिश्चित करती है, और एक जो डेटाबेस को बनाए रखने के लिए जिम्मेदार है।

डॉकर कंपोज़ तकनीक, इसे सरल तरीके से वर्णित करने के लिए, आपको एक कमांड के साथ कई सेवाएं लॉन्च करने की अनुमति देती है।

डॉकर और डॉकर कंपोज़ के बीच अंतर

डॉकर का उपयोग उन व्यक्तिगत कंटेनरों (सेवाओं) को प्रबंधित करने के लिए किया जाता है जो एक एप्लिकेशन बनाते हैं।

डॉकर कंपोज़ का उपयोग एक एप्लिकेशन बनाने वाले कई कंटेनरों को एक साथ प्रबंधित करने के लिए किया जाता है। यह टूल डॉकर जैसी ही क्षमताएं प्रदान करता है, लेकिन आपको अधिक जटिल अनुप्रयोगों के साथ काम करने की अनुमति देता है।

डॉकर (एकल कंटेनर) और डॉकर कंपोज़ (एकाधिक कंटेनर)

डॉकर कंपोज़ के लिए विशिष्ट उपयोग का मामला

डॉकर कंपोज़, सही हाथों में, एक बहुत शक्तिशाली उपकरण है जो आपको जटिल आर्किटेक्चर वाले एप्लिकेशन को बहुत तेज़ी से तैनात करने की अनुमति देता है। अब हम डॉकर कंपोज़ के व्यावहारिक उपयोग का एक उदाहरण देखेंगे, जिसके विश्लेषण से आप उन लाभों का मूल्यांकन कर सकेंगे जो डॉकर कंपोज़ का उपयोग करने से आपको मिलेंगे।

कल्पना कीजिए कि आप एक वेब प्रोजेक्ट के डेवलपर हैं। इस परियोजना में दो वेबसाइटें शामिल हैं। पहला व्यवसायिक लोगों को कुछ ही क्लिक के साथ ऑनलाइन स्टोर बनाने की अनुमति देता है। दूसरे का उद्देश्य ग्राहक सहायता है। ये दोनों साइटें एक ही डेटाबेस के साथ इंटरैक्ट करती हैं।

आपका प्रोजेक्ट अधिक से अधिक लोकप्रिय होता जा रहा है, और यह पता चला है कि जिस सर्वर पर यह चलता है उसकी शक्ति अब पर्याप्त नहीं है। परिणामस्वरूप, आप संपूर्ण प्रोजेक्ट को किसी अन्य मशीन पर ले जाने का निर्णय लेते हैं।

दुर्भाग्य से, आपने डॉकर कंपोज़ जैसी किसी चीज़ का उपयोग नहीं किया। इसलिए, आपको एक-एक करके सेवाओं को स्थानांतरित और पुन: कॉन्फ़िगर करना होगा, यह आशा करते हुए कि आप इस प्रक्रिया में कुछ भी नहीं भूलेंगे।

यदि आप डॉकर कंपोज़ का उपयोग करते हैं, तो अपने प्रोजेक्ट को एक नए सर्वर पर ले जाना एक ऐसा मामला है जिसे कुछ कमांड चलाकर हल किया जा सकता है। प्रोजेक्ट को किसी नए स्थान पर स्थानांतरित करने के लिए, आपको केवल कुछ सेटिंग्स करने और डेटाबेस की एक बैकअप प्रतिलिपि नए सर्वर पर अपलोड करने की आवश्यकता है।

डॉकर कंपोज़ का उपयोग करके क्लाइंट-सर्वर एप्लिकेशन विकसित करना

अब जब आप जानते हैं कि हम डॉकर कंपोज़ का उपयोग किस लिए करने जा रहे हैं, तो इस टूल का उपयोग करके अपना पहला क्लाइंट-सर्वर एप्लिकेशन बनाने का समय आ गया है। अर्थात्, हम पायथन में एक छोटी वेबसाइट (सर्वर) विकसित करने के बारे में बात कर रहे हैं जो पाठ के एक टुकड़े के साथ एक फ़ाइल को आउटपुट कर सकती है। यह फ़ाइल एक प्रोग्राम (क्लाइंट) द्वारा सर्वर से अनुरोध की जाती है, जिसे पायथन में भी लिखा गया है। सर्वर से फ़ाइल प्राप्त करने के बाद प्रोग्राम उसमें संग्रहीत टेक्स्ट को स्क्रीन पर प्रदर्शित करता है।

कृपया ध्यान दें कि हम मानते हैं कि आपको डॉकर की बुनियादी समझ है और आपके पास पहले से ही डॉकर प्लेटफ़ॉर्म स्थापित है।

आइए प्रोजेक्ट पर काम करना शुरू करें।

▍1. एक प्रोजेक्ट बनाना

अपना पहला क्लाइंट-सर्वर एप्लिकेशन बनाने के लिए, मेरा सुझाव है कि आप एक प्रोजेक्ट फ़ोल्डर बनाकर शुरुआत करें। इसमें निम्नलिखित फ़ाइलें और फ़ोल्डर्स होने चाहिए:

फ़ाइल docker-compose.yml. यह एक डॉकर कंपोज़ फ़ाइल है जिसमें सेवाओं को शुरू करने और कॉन्फ़िगर करने के लिए आवश्यक निर्देश होंगे।
फोल्डर server. इसमें सर्वर को चालू रखने के लिए आवश्यक फ़ाइलें होंगी।
फोल्डर client. क्लाइंट एप्लिकेशन फ़ाइलें यहां स्थित होंगी।

परिणामस्वरूप, आपके प्रोजेक्ट के मुख्य फ़ोल्डर की सामग्री इस तरह दिखनी चाहिए:

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

▍2. एक सर्वर बनाना

यहां, सर्वर बनाने की प्रक्रिया में, हम डॉकर के संबंध में कुछ बुनियादी बातों पर ध्यान देंगे।

2ए. फ़ाइलें बनाना

फोल्डर पर जाएं server और इसमें निम्नलिखित फ़ाइलें बनाएं:

फ़ाइल server.py. इसमें सर्वर कोड होगा.
फ़ाइल index.html. इस फ़ाइल में टेक्स्ट का एक टुकड़ा होगा जिसे क्लाइंट एप्लिकेशन को आउटपुट करना चाहिए।
फ़ाइल Dockerfile. यह एक डॉकर फ़ाइल है जिसमें सर्वर वातावरण बनाने के लिए आवश्यक निर्देश होंगे।

आपके फ़ोल्डर की सामग्री इस तरह दिखनी चाहिए 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, जिसकी सामग्री बाद में वेब पेज पर प्रदर्शित की जाएगी।

2सी. HTML फ़ाइल का संपादन

दायर करना index.html निम्नलिखित पाठ जोड़ें:

Docker-Compose is magic!

यह टेक्स्ट क्लाइंट को भेजा जाएगा.

2डी. डॉकरफ़ाइल का संपादन

अब हम एक साधारण फाइल बनाएंगे Dockerfile, जो पायथन सर्वर के लिए रनटाइम वातावरण को व्यवस्थित करने के लिए जिम्मेदार होगा। हम निर्मित छवि के आधार के रूप में उपयोग करेंगे आधिकारिक तरीके से, पायथन में लिखे प्रोग्राम चलाने के लिए डिज़ाइन किया गया। यहाँ 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. एक ग्राहक बनाना

अपने प्रोजेक्ट का क्लाइंट पक्ष बनाते समय, हम रास्ते में कुछ डॉकर मूल बातें याद रखेंगे।

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()

इस कोड के साथ, क्लाइंट एप्लिकेशन सर्वर से डेटा डाउनलोड कर सकता है और उसे स्क्रीन पर प्रदर्शित कर सकता है।

3सी. डॉकरफ़ाइल का संपादन

जैसा कि सर्वर के मामले में होता है, हम एक सरल बनाते हैं Dockerfile, उस वातावरण को बनाने के लिए जिम्मेदार है जिसमें पायथन क्लाइंट एप्लिकेशन चलेगा। यहाँ ग्राहक कोड है Dockerfile:

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

FROM python:latest

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

ADD client.py /client/

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

WORKDIR /client/

▍4. डॉकर कम्पोज़

जैसा कि आपने देखा होगा, हमने दो अलग-अलग प्रोजेक्ट बनाए: एक सर्वर और एक क्लाइंट। उनमें से प्रत्येक की अपनी फ़ाइल है Dockerfile. अब तक, जो कुछ भी हुआ है वह डॉकर के साथ काम करने की बुनियादी बातों से आगे नहीं बढ़ा है। अब हम डॉकर कंपोज़ के साथ शुरुआत करते हैं। ऐसा करने के लिए, फ़ाइल पर जाएँ docker-compose.yml, प्रोजेक्ट रूट फ़ोल्डर में स्थित है।

कृपया ध्यान दें कि यहां हम उन सभी कमांडों को शामिल करने का प्रयास नहीं कर रहे हैं जिनका उपयोग किया जा सकता है docker-compose.yml. हमारा मुख्य लक्ष्य एक व्यावहारिक उदाहरण से गुजरना है जो आपको डॉकर कंपोज़ का बुनियादी ज्ञान देगा।

फ़ाइल में डालने के लिए कोड यहां दिया गया है 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 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

परिणाम

हमने डॉकर कंपोज़ तकनीक के साथ काम करने की बुनियादी बातों पर गौर किया है, जिसका ज्ञान आपको इस तकनीक का उपयोग करने की अनुमति देगा और यदि आप चाहें, तो इसका अधिक गहराई से अध्ययन करना शुरू कर देंगे। यहां जिस प्रोजेक्ट को हमने यहां देखा उसके लिए कोड के साथ एक रिपॉजिटरी।

प्रिय पाठकों! क्या आप अपनी परियोजनाओं में डॉकर कंपोज़ का उपयोग करते हैं?

स्रोत: www.habr.com

डॉकर कंपोज़ के लिए एक शुरुआती मार्गदर्शिका