🥇 डकर कम्पोजको लागि शुरुआती गाइड

लेखका लेखक, जसको अनुवाद हामीले आज प्रकाशित गर्दैछौं, भन्छन् कि यो ती विकासकर्ताहरूका लागि हो जसले डकर कम्पोज सिक्न चाहन्छन् र डकर प्रयोग गरेर आफ्नो पहिलो ग्राहक-सर्भर अनुप्रयोग सिर्जना गर्न तर्फ लागिरहेका छन्। यो सामाग्री को पाठक Docker को आधारभूत संग परिचित छ कि मानिन्छ। यदि यो मामला छैन भने, तपाईं एक नजर हेर्न सक्नुहुन्छ यो सामग्री को श्रृंखला मा यो डकर आधारभूत कुराहरू कभर गर्ने पोस्ट कुबर्नेट्स आधारभूतहरू, र यो शुरुवातका लागि लेख।

डकर कम्पोज भनेको के हो?

डकर कम्पोज डकरसँग समावेश गरिएको उपकरण हो। यो परियोजना परिनियोजन सम्बन्धी समस्याहरू समाधान गर्न डिजाइन गरिएको हो।

डकरको आधारभूत कुराहरू सिक्ने क्रममा, तपाईंले स्वायत्त रूपमा काम गर्ने र निर्भर नहुने, उदाहरणका लागि, बाह्य डेटा स्रोतहरूमा वा निश्चित सेवाहरूमा सरल अनुप्रयोगहरूको सिर्जनाको सामना गर्नु भएको हुन सक्छ। व्यवहारमा, त्यस्ता अनुप्रयोगहरू दुर्लभ छन्। वास्तविक परियोजनाहरूमा सामान्यतया सँगै काम गर्ने अनुप्रयोगहरूको सम्पूर्ण सेट समावेश हुन्छ।

तपाईंले परियोजना प्रयोग गर्दा डकर कम्पोज प्रयोग गर्न आवश्यक छ भने तपाईंलाई कसरी थाहा हुन्छ? यो वास्तवमा धेरै सरल छ। यदि तपाइँ यो परियोजना कार्य गर्न धेरै सेवाहरू प्रयोग गर्नुहुन्छ भने, त्यसपछि डकर रचना काममा आउन सक्छ। उदाहरण को लागी, एक स्थिति मा जहाँ उनिहरु एक वेबसाइट सिर्जना गर्न को लागी एक डेटाबेस मा जडान गर्न को लागी प्रयोगकर्ताहरु लाई प्रमाणीकरण गर्न को लागी आवश्यक छ। यस्तो परियोजनाले दुई सेवाहरू समावेश गर्न सक्छ - एक जसले साइटको सञ्चालन सुनिश्चित गर्दछ, र एक जुन डाटाबेस कायम राख्न जिम्मेवार छ।

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

डकर र डकर कम्पोज बीचको भिन्नता

डकर व्यक्तिगत कन्टेनरहरू (सेवाहरू) प्रबन्ध गर्न प्रयोग गरिन्छ जुन अनुप्रयोग बनाउँछ।

डकर कम्पोज एकै साथ धेरै कन्टेनरहरू प्रबन्ध गर्न प्रयोग गरिन्छ जुन एप्लिकेसन बनाउँछ। यो उपकरणले डकरको रूपमा समान क्षमताहरू प्रदान गर्दछ, तर तपाईंलाई थप जटिल अनुप्रयोगहरूसँग काम गर्न अनुमति दिन्छ।

डकर (एकल कन्टेनर) र डकर कम्पोज (बहु कन्टेनरहरू)

डकर कम्पोजको लागि सामान्य प्रयोग केस

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

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

तपाईंको परियोजना अधिक र अधिक लोकप्रिय हुँदै गइरहेको छ, र यो जान्छ कि यो चलिरहेको सर्भरको शक्ति अब पर्याप्त छैन। नतिजाको रूपमा, तपाइँ सम्पूर्ण परियोजनालाई अर्को मेसिनमा सार्न निर्णय गर्नुहुन्छ।

दुर्भाग्यवश, तपाईंले डकर कम्पोज जस्तो केहि प्रयोग गर्नुभएन। तसर्थ, तपाईंले एक पटकमा सेवाहरू स्थानान्तरण र पुन: कन्फिगर गर्नुपर्नेछ, आशा छ कि तपाईंले प्रक्रियामा केहि पनि बिर्सनुहुने छैन।

यदि तपाइँ डकर कम्पोज प्रयोग गर्नुहुन्छ भने, तपाइँको परियोजनालाई नयाँ सर्भरमा सार्नु एउटा कुरा हो जुन केहि आदेशहरू चलाएर समाधान गर्न सकिन्छ। नयाँ स्थानमा परियोजनाको स्थानान्तरण पूरा गर्नको लागि, तपाईंले केवल केहि सेटिङहरू बनाउन र नयाँ सर्भरमा डाटाबेसको जगेडा प्रतिलिपि अपलोड गर्न आवश्यक छ।

डकर कम्पोज प्रयोग गरेर क्लाइन्ट-सर्भर अनुप्रयोग विकास गर्दै

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

कृपया ध्यान दिनुहोस् कि हामी मान्दछौं कि तपाइँसँग डकरको आधारभूत बुझाइ छ र तपाइँसँग पहिले नै डकर प्लेटफर्म स्थापित छ।

परियोजनामा काम सुरु गरौं।

▍१। परियोजना सिर्जना गर्दै

तपाइँको पहिलो क्लाइन्ट-सर्भर अनुप्रयोग निर्माण गर्न, म तपाइँलाई एक परियोजना फोल्डर सिर्जना गरेर सुरु गर्न सुझाव दिन्छु। यसले निम्न फाइलहरू र फोल्डरहरू समावेश गर्नुपर्छ:

फाइल docker-compose.yml। यो एक डकर कम्पोज फाइल हो जसले सेवाहरू सुरु गर्न र कन्फिगर गर्न आवश्यक निर्देशनहरू समावेश गर्दछ।
फोल्डर server। यसले सर्भर चलाउन आवश्यक फाइलहरू समावेश गर्दछ।
फोल्डर client। ग्राहक अनुप्रयोग फाइलहरू यहाँ स्थित हुनेछन्।

नतिजाको रूपमा, तपाईंको परियोजनाको मुख्य फोल्डरको सामग्रीहरू यस्तो देखिनु पर्छ:

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

▍२। सर्भर सिर्जना गर्दै

यहाँ, सर्भर सिर्जना गर्ने प्रक्रियामा, हामी डकर सम्बन्धी केही आधारभूत कुराहरूमा छुनेछौं।

2a। फाइलहरू सिर्जना गर्दै

फोल्डरमा जानुहोस् server र यसमा निम्न फाइलहरू सिर्जना गर्नुहोस्:

फाइल server.py। यसमा सर्भर कोड समावेश हुनेछ।
फाइल index.html। यो फाइलले पाठको टुक्रा समावेश गर्दछ जुन क्लाइन्ट अनुप्रयोगले आउटपुट गर्नुपर्छ।
फाइल Dockerfile। यो एक डकर फाइल हो जसले सर्भर वातावरण सिर्जना गर्न आवश्यक निर्देशनहरू समावेश गर्दछ।

यो तपाईको फोल्डरको सामग्री जस्तो देखिनु पर्छ server/:

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

२ ख। पाइथन फाइल सम्पादन गर्दै।

फाइलमा थप्नुहोस् 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, जो पाइथन सर्भरको लागि रनटाइम वातावरण व्यवस्थित गर्न जिम्मेवार हुनेछ। सिर्जना गरिएको छविको आधारको रूपमा, हामी प्रयोग गर्नेछौं आधिकारिक रूपमा, 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/

अब ग्राहक मा काम सुरु गरौं।

▍३। ग्राहक सिर्जना गर्दै

हाम्रो परियोजनाको ग्राहक पक्ष सिर्जना गर्दा, हामी बाटोमा केही डकर आधारभूत कुराहरू सम्झनेछौं।

3a। फाइलहरू सिर्जना गर्दै

आफ्नो परियोजना फोल्डरमा जानुहोस् client र यसमा निम्न फाइलहरू सिर्जना गर्नुहोस्:

फाइल client.py। ग्राहक कोड यहाँ स्थित हुनेछ।
फाइल Dockerfile। यो फाइलले सर्भर फोल्डरमा उस्तै फाइल जस्तै भूमिका खेल्छ। अर्थात्, यसले क्लाइन्ट कोड कार्यान्वयन गर्नको लागि वातावरण कसरी सिर्जना गर्ने भनेर वर्णन गर्ने निर्देशनहरू समावेश गर्दछ।

नतिजाको रूपमा, तपाईंको फोल्डर client/ काम को यो चरण मा यो यस्तो देखिनु पर्छ:

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

३ ख। पाइथन फाइल सम्पादन गर्दै

फाइलमा थप्नुहोस् 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:

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

FROM python:latest

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

ADD client.py /client/

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

WORKDIR /client/

▍४। डकर रचना

तपाईंले याद गर्नु भएको हुनसक्छ, हामीले दुई फरक परियोजनाहरू सिर्जना गरेका छौं: सर्भर र ग्राहक। तिनीहरूमध्ये प्रत्येकको आफ्नै फाइल छ 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

▍५। आयोजना निर्माण गर्ने

भित्र पछि 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

डकर कम्पोजको लागि एक शुरुआती गाइड