सीआई/सीडी श्रृंखला बनाना और डॉकर के साथ काम को स्वचालित करना

मैंने अपनी पहली वेबसाइटें 90 के दशक के अंत में लिखीं। उस समय उन्हें कार्यशील स्थिति में लाना बहुत आसान था। कुछ साझा होस्टिंग पर एक अपाचे सर्वर था, आप कुछ ऐसा लिखकर एफ़टीपी के माध्यम से इस सर्वर में लॉग इन कर सकते हैं ftp://ftp.example.com. फिर आपको अपना नाम और पासवर्ड दर्ज करना होगा और फ़ाइलों को सर्वर पर अपलोड करना होगा। वे अलग-अलग समय थे, तब सब कुछ अब की तुलना में सरल था।

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

मेरे निजी प्रोजेक्ट के लिए मेरे पास एक विशेष कॉन्फ़िगरेशन था। और मुझे पता था कि मुझे केवल एक कार्य करके साइट को उत्पादन में तैनात करने की क्षमता की आवश्यकता है: एक शाखा में कोड लिखना master GitHub पर. इसके अलावा, मुझे पता था कि अपने छोटे वेब एप्लिकेशन के संचालन को सुनिश्चित करने के लिए, मैं एक विशाल कुबेरनेट्स क्लस्टर का प्रबंधन नहीं करना चाहता था, या डॉकर स्वार्म तकनीक का उपयोग नहीं करना चाहता था, या पॉड्स, एजेंटों और अन्य सभी प्रकार के सर्वरों का एक बेड़ा बनाए रखना नहीं चाहता था। जटिलताएँ काम को यथासंभव आसान बनाने के लक्ष्य को प्राप्त करने के लिए, मुझे सीआई/सीडी से परिचित होने की आवश्यकता थी।

यदि आपके पास एक छोटा प्रोजेक्ट है (इस मामले में, एक Node.js प्रोजेक्ट) और आप जानना चाहेंगे कि इस प्रोजेक्ट की तैनाती को स्वचालित कैसे करें, यह सुनिश्चित करते हुए कि रिपॉजिटरी में जो संग्रहीत है वह उत्पादन में काम करने वाले से बिल्कुल मेल खाता है, तो मैं मुझे लगता है कि आपको इस लेख में रुचि हो सकती है।

आवश्यक शर्तें

इस लेख के पाठक से अपेक्षा की जाती है कि उसे कमांड लाइन और बैश स्क्रिप्ट लिखने की बुनियादी समझ हो। इसके अलावा, उसे खातों की आवश्यकता होगी ट्रैविस सीआई и डॉकर हब.

लक्ष्यों

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

मेरा वर्कफ़्लो इसी तरह समाप्त हुआ।

सिवाय किसी भी रिपॉजिटरी शाखा में पोस्ट किए गए कोड के लिए master, निम्नलिखित क्रियाएं की जाती हैं:

• ट्रैविस सीआई पर परियोजना का निर्माण शुरू होता है।
• सभी यूनिट, एकीकरण और एंड-टू-एंड परीक्षण किए जाते हैं।

केवल उस कोड के लिए जो इसमें आता है master, निम्नलिखित कार्य किया जाता है:

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

यदि आप डॉकर, छवियों और कंटेनरों के बारे में बिल्कुल कुछ नहीं जानते हैं, तो चिंता न करें। मैं आपको इसके बारे में सब बताऊंगा.

सीआई/सीडी क्या है?

संक्षिप्त नाम सीआई/सीडी का अर्थ है "निरंतर एकीकरण/निरंतर तैनाती।"

▍निरंतर एकीकरण

सतत एकीकरण एक ऐसी प्रक्रिया है जिसमें डेवलपर्स परियोजना के मुख्य स्रोत कोड रिपॉजिटरी (आमतौर पर एक शाखा) के लिए प्रतिबद्ध होते हैं master). साथ ही, स्वचालित परीक्षण के माध्यम से कोड की गुणवत्ता सुनिश्चित की जाती है।

▍निरंतर तैनाती

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

प्रारंभ करना

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

मेरे मामले में, एप्लिकेशन Node.js वातावरण में चलने वाला एक एक्सप्रेस सर्वर है, जो एकल-पेज रिएक्ट एप्लिकेशन की सेवा देता है और एक सुरक्षित सर्वर-साइड एपीआई का समर्थन करता है। यह आर्किटेक्चर उस रणनीति का अनुसरण करता है जो इसमें पाई जा सकती है यह पूर्ण स्टैक प्रमाणीकरण मार्गदर्शिका.

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

डाक में काम करनेवाला मज़दूर

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

डॉकर हब लगभग वैसा ही है GitHub गिट रिपॉजिटरी या रजिस्ट्री के लिए NPM जावास्क्रिप्ट पैकेज के लिए। यह डॉकर छवियों के लिए एक ऑनलाइन रिपॉजिटरी है। डॉकर डेस्कटॉप इसी से जुड़ता है।

तो, डॉकर के साथ शुरुआत करने के लिए, आपको दो काम करने होंगे:

• स्थित डॉकटर डेस्कटॉप.
• के लिए पंजीकृत करें डॉकर हब.

इसके बाद, आप डॉकर संस्करण की जांच करने के लिए निम्नलिखित कमांड चलाकर जांच सकते हैं कि डॉकर सीएलआई काम कर रहा है या नहीं:

docker -v

इसके बाद, पूछे जाने पर अपना उपयोगकर्ता नाम और पासवर्ड दर्ज करके डॉकर हब में लॉग इन करें:

docker login

डॉकर का उपयोग करने के लिए, आपको छवियों और कंटेनरों की अवधारणाओं को समझना होगा।

▍छवियाँ

एक छवि एक ब्लूप्रिंट की तरह होती है जिसमें कंटेनर को असेंबल करने के निर्देश होते हैं। यह एप्लिकेशन के फ़ाइल सिस्टम और सेटिंग्स का एक अपरिवर्तनीय स्नैपशॉट है। डेवलपर्स आसानी से छवियां साझा कर सकते हैं।

# Вывод сведений обо всех образах
docker images

यह कमांड निम्नलिखित हेडर के साथ एक तालिका आउटपुट करेगा:

REPOSITORY     TAG     IMAGE ID     CREATED     SIZE
---

आगे हम समान प्रारूप में कमांड के कुछ उदाहरण देखेंगे - पहले एक टिप्पणी के साथ एक कमांड है, और फिर यह क्या आउटपुट दे सकता है इसका एक उदाहरण है।

▍कंटेनर

कंटेनर एक निष्पादन योग्य पैकेज है जिसमें किसी एप्लिकेशन को चलाने के लिए आवश्यक सभी चीजें शामिल होती हैं। इस दृष्टिकोण वाला एक एप्लिकेशन बुनियादी ढांचे की परवाह किए बिना हमेशा एक ही तरह से काम करेगा: एक अलग वातावरण में और एक ही वातावरण में। मुद्दा यह है कि एक ही छवि के उदाहरण विभिन्न वातावरणों में लॉन्च किए जाते हैं।

# Перечисление всех контейнеров
docker ps -a
CONTAINER ID     IMAGE     COMMAND     CREATED     STATUS     PORTS     NAMES
---

▍टैग

टैग किसी छवि के विशिष्ट संस्करण का संकेत है।

▍डॉकर कमांड का एक त्वरित संदर्भ

यहां आमतौर पर उपयोग किए जाने वाले कुछ डॉकर कमांड का अवलोकन दिया गया है।

टीम

प्रसंग

कार्य

डोकर निर्माण

छवि

Dockerfile से एक छवि बनाना

डोकर टैग

छवि

छवि टैगिंग

डॉकर छवियां

छवि

छवियों की सूची बनाना

डॉकर रन

कंटेनर

एक छवि के आधार पर एक कंटेनर चलाना

डॉकटर पुश

छवि

रजिस्ट्री में एक छवि अपलोड करना

डॉकर पुल

छवि

रजिस्ट्री से एक छवि लोड हो रही है

डॉकर पीए

कंटेनर

कंटेनरों की सूची बनाना

डॉकर सिस्टम प्रून

छवि/कंटेनर

अप्रयुक्त कंटेनरों और छवियों को हटाना

▍डॉकरफ़ाइल

मैं जानता हूं कि स्थानीय स्तर पर उत्पादन एप्लिकेशन कैसे चलाया जाता है। मेरे पास एक वेबपैक कॉन्फ़िगरेशन है जिसे रेडी-मेड रिएक्ट एप्लिकेशन बनाने के लिए डिज़ाइन किया गया है। इसके बाद, मेरे पास एक कमांड है जो पोर्ट पर Node.js आधारित सर्वर शुरू करता है 5000. यह इस तरह दिख रहा है:

npm i         # установка зависимостей
npm run build # сборка React-приложения
npm run start # запуск Node-сервера

यह ध्यान दिया जाना चाहिए कि मेरे पास इस सामग्री के लिए कोई उदाहरण एप्लिकेशन नहीं है। लेकिन यहां, प्रयोगों के लिए, कोई भी सरल नोड एप्लिकेशन उपयुक्त होगा।

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

लेकिन इसमें जो कुछ है वह केवल विशेष आदेशों के साथ, कामकाजी माहौल स्थापित करने जैसा कुछ वर्णन करता है। इनमें से कुछ आदेश यहां दिए गए हैं:

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

Dockerfile कुछ इस तरह दिख सकता है:

# Загрузить базовый образ
FROM node:12-alpine

# Скопировать файлы из текущей директории в директорию app/
COPY . app/

# Использовать app/ в роли рабочей директории
WORKDIR app/

# Установить зависимости (команда npm ci похожа npm i, но используется для автоматизированных сборок)
RUN npm ci --only-production

# Собрать клиентское React-приложение для продакшна
RUN npm run build

# Прослушивать указанный порт
EXPOSE 5000

# Запустить Node-сервер
ENTRYPOINT npm run start

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

▍कंटेनर बनाना, टैग करना और चलाना

कंटेनर की स्थानीय असेंबली और लॉन्चिंग हमारे पास है Dockerfile, कार्य काफी सरल हैं। इससे पहले कि आप छवि को डॉकर हब पर धकेलें, आपको इसका स्थानीय स्तर पर परीक्षण करना होगा।

▍विधानसभा

सबसे पहले आपको इकट्ठा करने की जरूरत है छवि, एक नाम निर्दिष्ट करना और, वैकल्पिक रूप से, एक टैग (यदि कोई टैग निर्दिष्ट नहीं है, तो सिस्टम स्वचालित रूप से छवि को एक टैग निर्दिष्ट करेगा) latest).

# Сборка образа
docker build -t <image>:<tag> .

इस कमांड को चलाने के बाद, आप डॉकर को छवि बनाते हुए देख सकते हैं।

Sending build context to Docker daemon   2.88MB
Step 1/9 : FROM node:12-alpine
 ---> ...выполнение этапов сборки...
Successfully built 123456789123
Successfully tagged <image>:<tag>

निर्माण में कुछ मिनट लग सकते हैं - यह सब इस बात पर निर्भर करता है कि आपके पास कितनी निर्भरताएँ हैं। एक बार निर्माण पूरा हो जाने पर, आप कमांड चला सकते हैं docker images और अपनी नई छवि का विवरण देखें.

REPOSITORY          TAG               IMAGE ID            CREATED              SIZE
<image>             latest            123456789123        About a minute ago   x.xxGB

▍लॉन्च

छवि बनाई गई है. इसका मतलब है कि आप इसके आधार पर एक कंटेनर चला सकते हैं। क्योंकि मैं कंटेनर में चल रहे एप्लिकेशन तक पहुंचने में सक्षम होना चाहता हूं localhost:5000, मैं, जोड़ी के बाईं ओर 5000:5000 अगले आदेश में स्थापित 5000. दाहिनी ओर कंटेनर पोर्ट है।

# Запуск с использованием локального порта 5000 и порта контейнера 5000
docker run -p 5000:5000 <image>:<tag>

अब जब कंटेनर बन गया है और चल रहा है, तो आप कमांड का उपयोग कर सकते हैं docker ps इस कंटेनर के बारे में जानकारी देखने के लिए (या आप कमांड का उपयोग कर सकते हैं docker ps -a, जो सभी कंटेनरों के बारे में जानकारी प्रदर्शित करता है, न कि केवल चालू कंटेनरों के बारे में)।

CONTAINER ID        IMAGE               COMMAND                  CREATED              STATUS                      PORTS                    NAMES
987654321234        <image>             "/bin/sh -c 'npm run…"   6 seconds ago        Up 6 seconds                0.0.0.0:5000->5000/tcp   stoic_darwin

यदि आप अब पते पर जाते हैं localhost:5000 — आप एक चल रहे एप्लिकेशन का एक पेज देख सकते हैं जो बिल्कुल उत्पादन परिवेश में चल रहे एप्लिकेशन के पेज जैसा ही दिखता है।

▍टैगिंग और प्रकाशन

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

अब आप नए नाम से छवि बना सकते हैं और कमांड चला सकते हैं docker push इसे डॉकर हब रिपॉजिटरी में धकेलने के लिए।

docker build -t <username>/<repository>:<tag> .
docker tag <username>/<repository>:<tag> <username>/<repository>:latest
docker push <username>/<repository>:<tag>

# На практике это может выглядеть, например, так:
docker build -t user/app:v1.0.0 .
docker tag user/app:v1.0.0 user/app:latest
docker push user/app:v1.0.0

यदि सब कुछ ठीक रहा, तो छवि डॉकर हब पर उपलब्ध होगी और आसानी से सर्वर पर अपलोड की जा सकती है या अन्य डेवलपर्स को स्थानांतरित की जा सकती है।

अगले चरण

अब तक हमने सत्यापित कर लिया है कि एप्लिकेशन, डॉकर कंटेनर के रूप में, स्थानीय रूप से चल रहा है। हमने कंटेनर को डॉकर हब पर अपलोड कर दिया है। इसका मतलब यह है कि हम पहले ही अपने लक्ष्य की दिशा में बहुत अच्छी प्रगति कर चुके हैं। अब हमें दो और प्रश्न हल करने होंगे:

• कोड के परीक्षण और तैनाती के लिए सीआई उपकरण स्थापित करना।
• उत्पादन सर्वर स्थापित करना ताकि वह हमारे कोड को डाउनलोड और चला सके।

हमारे मामले में, हम उपयोग करते हैं ट्रैविस सीआई. एक सर्वर के रूप में - DitigalOcean.

यह ध्यान दिया जाना चाहिए कि यहां आप सेवाओं के दूसरे संयोजन का उपयोग कर सकते हैं। उदाहरण के लिए, ट्रैविस सीआई के बजाय, आप सर्किलसीआई या जीथब एक्शन का उपयोग कर सकते हैं। और DigitalOcean के बजाय - AWS या Linode।

हमने ट्रैविस सीआई के साथ काम करने का फैसला किया, और मेरे पास पहले से ही इस सेवा में कुछ कॉन्फ़िगर है। इसलिए, अब मैं संक्षेप में बात करूंगा कि इसे काम के लिए कैसे तैयार किया जाए।

ट्रैविस सीआई

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

ट्रैविस सीआई के साथ आरंभ करने के लिए, यहां जाएं उत्तर दीजिए और एक अकाउंट बनाएं. फिर ट्रैविस सीआई को अपने GitHub खाते के साथ एकीकृत करें। सिस्टम स्थापित करते समय, आपको उस रिपॉजिटरी को निर्दिष्ट करना होगा जिसके साथ आप काम को स्वचालित करना चाहते हैं और उस तक पहुंच सक्षम करना चाहते हैं। (मैं GitHub का उपयोग करता हूं, लेकिन मुझे यकीन है कि ट्रैविस CI BitBucket, और GitLab और अन्य समान सेवाओं के साथ एकीकृत हो सकता है)।

हर बार ट्रैविस सीआई शुरू होने पर, सर्वर लॉन्च किया जाता है, जो संबंधित रिपॉजिटरी शाखाओं को तैनात करने सहित कॉन्फ़िगरेशन फ़ाइल में निर्दिष्ट आदेशों को निष्पादित करता है।

▍कार्य जीवन चक्र

ट्रैविस सीआई कॉन्फ़िगरेशन फ़ाइल को बुलाया गया .travis.yml और प्रोजेक्ट रूट निर्देशिका में संग्रहीत, घटनाओं की अवधारणा का समर्थन करता है जीवन चक्र कार्य. इन घटनाओं को उनके घटित होने के क्रम में सूचीबद्ध किया गया है:

• apt addons
• cache components
• before_install
• install
• before_script
• script
• before_cache
• after_success или after_failure
• before_deploy
• deploy
• after_deploy
• after_script

▍परीक्षण

कॉन्फ़िगरेशन फ़ाइल में मैं स्थानीय ट्रैविस सीआई सर्वर को कॉन्फ़िगर करने जा रहा हूं। मैंने भाषा के रूप में नोड 12 का चयन किया और सिस्टम को डॉकर का उपयोग करने के लिए आवश्यक निर्भरताएँ स्थापित करने के लिए कहा।

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

यदि आप चाहते हैं कि आपका भंडार परीक्षण कवरेज आइकन प्रदर्शित करे, यहां आप इस जानकारी को एकत्र करने और प्रदर्शित करने के लिए जेस्ट, ट्रैविस सीआई और कवरॉल्स का उपयोग करने पर संक्षिप्त निर्देश पा सकते हैं।

तो यहाँ फ़ाइल की सामग्री है .travis.yml:

# Установить язык
language: node_js

# Установить версию Node.js
node_js:
  - '12'

services:
  # Использовать командную строку Docker
  - docker

install:
  # Установить зависимости для тестов
  - npm ci

before_script:
  # Запустить сервер и клиент для тестов
  - npm run dev &

script:
  # Запустить тесты
  - npm run test

यहीं पर रिपॉजिटरी की सभी शाखाओं और पुल अनुरोधों के लिए की जाने वाली क्रियाएं समाप्त होती हैं।

▍तैनाती

इस धारणा के आधार पर कि सभी स्वचालित परीक्षण सफलतापूर्वक पूरे हो गए हैं, हम, जो वैकल्पिक है, उत्पादन सर्वर पर कोड तैनात कर सकते हैं। चूँकि हम ऐसा केवल शाखा के कोड के लिए करना चाहते हैं master, हम सिस्टम को परिनियोजन सेटिंग्स में उचित निर्देश देते हैं। इससे पहले कि आप उस कोड का उपयोग करने का प्रयास करें जिसे हम आपके प्रोजेक्ट में देखेंगे, मैं आपको चेतावनी देना चाहूंगा कि आपके पास तैनाती के लिए एक वास्तविक स्क्रिप्ट होनी चाहिए।

deploy:
  # Собрать Docker-контейнер и отправить его на Docker Hub
  provider: script
  script: bash deploy.sh
  on:
    branch: master

परिनियोजन स्क्रिप्ट दो समस्याओं का समाधान करती है:

• सीआई टूल (हमारे मामले में, ट्रैविस सीआई) का उपयोग करके छवि बनाएं, टैग करें और डॉकर हब को भेजें।
• सर्वर पर छवि लोड करना, पुराने कंटेनर को रोकना और एक नया शुरू करना (हमारे मामले में, सर्वर DigitalOcean प्लेटफ़ॉर्म पर चलता है)।

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

तो, स्क्रिप्ट का पहला भाग छवि को डॉकर हब पर अपलोड कर रहा है। ऐसा करना काफी आसान है. मेरे द्वारा उपयोग की गई टैगिंग योजना में एक गिट हैश और एक गिट टैग का संयोजन शामिल है, यदि कोई मौजूद है। यह सुनिश्चित करता है कि टैग अद्वितीय है और उस असेंबली की पहचान करना आसान बनाता है जिस पर यह आधारित है। DOCKER_USERNAME и DOCKER_PASSWORD उपयोगकर्ता पर्यावरण चर हैं जिन्हें ट्रैविस सीआई इंटरफ़ेस का उपयोग करके सेट किया जा सकता है। ट्रैविस सीआई संवेदनशील डेटा को स्वचालित रूप से संसाधित करेगा ताकि यह गलत हाथों में न पड़े।

यहाँ स्क्रिप्ट का पहला भाग है deploy.sh.

#!/bin/sh
set -e # Остановить скрипт при наличии ошибок

IMAGE="<username>/<repository>"                             # Образ Docker
GIT_VERSION=$(git describe --always --abbrev --tags --long) # Git-хэш и теги

# Сборка и тегирование образа
docker build -t ${IMAGE}:${GIT_VERSION} .
docker tag ${IMAGE}:${GIT_VERSION} ${IMAGE}:latest

# Вход в Docker Hub и выгрузка образа
echo "${DOCKER_PASSWORD}" | docker login -u "${DOCKER_USERNAME}" --password-stdin
docker push ${IMAGE}:${GIT_VERSION}

स्क्रिप्ट का दूसरा भाग क्या होगा यह पूरी तरह से इस बात पर निर्भर करता है कि आप किस होस्ट का उपयोग कर रहे हैं और उससे कनेक्शन कैसे व्यवस्थित है। मेरे मामले में, चूंकि मैं डिजिटल ओशन का उपयोग करता हूं, मैं सर्वर से कनेक्ट करने के लिए कमांड का उपयोग करता हूं doctl. AWS के साथ काम करते समय उपयोगिता का उपयोग किया जाएगा aws, आदि।

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

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

• हमें उस कंटेनर को ढूंढना होगा जो वर्तमान में चल रहा है और उसे रोकना है।
• फिर आपको पृष्ठभूमि में एक नया कंटेनर लॉन्च करना होगा।
• आपको सर्वर का स्थानीय पोर्ट सेट करना होगा 80 - यह आपको इस पते पर साइट में प्रवेश करने की अनुमति देगा example.comजैसे किसी पते का उपयोग करने के बजाय, पोर्ट निर्दिष्ट किए बिना example.com:5000.
• अंत में, आपको सभी पुराने कंटेनर और छवियों को हटाना होगा।

यहाँ स्क्रिप्ट की निरंतरता है.

# Найти ID работающего контейнера
CONTAINER_ID=$(docker ps | grep takenote | cut -d" " -f1)

# Остановить старый контейнер, запустить новый, очистить систему
docker stop ${CONTAINER_ID}
docker run --restart unless-stopped -d -p 80:5000 ${IMAGE}:${GIT_VERSION}
docker system prune -a -f

ध्यान देने योग्य कुछ बातें

यह संभव है कि जब आप ट्रैविस सीआई से एसएसएच के माध्यम से सर्वर से कनेक्ट होते हैं, तो आपको एक चेतावनी दिखाई देगी जो आपको इंस्टॉलेशन जारी रखने से रोक देगी क्योंकि सिस्टम उपयोगकर्ता की प्रतिक्रिया की प्रतीक्षा करेगा।

The authenticity of host '<hostname> (<IP address>)' can't be established.
RSA key fingerprint is <key fingerprint>.
Are you sure you want to continue connecting (yes/no)?

मैंने सीखा कि एक स्ट्रिंग कुंजी को ऐसे रूप में सहेजने के लिए बेस64 में एन्कोड किया जा सकता है जिसमें इसके साथ सुविधाजनक और विश्वसनीय रूप से काम किया जा सकता है। इंस्टॉलेशन चरण में, आप सार्वजनिक कुंजी को डीकोड कर सकते हैं और इसे एक फ़ाइल में लिख सकते हैं known_hosts उपरोक्त त्रुटि से छुटकारा पाने के लिए।

echo <public key> | base64 # выводит <публичный ключ, закодированный в base64>

व्यवहार में, यह आदेश इस तरह दिख सकता है:

echo "123.45.67.89 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAklOUpkDHrfHY17SbrmTIpNLTGK9Tjom/BWDSU
GPl+nafzlHDTYW7hdI4yZ5ew18JH4JW9jbhUFrviQzM7xlELEVf4h9lFX5QVkbPppSwg0cda3
Pbv7kOdJ/MTyBlWXFCR+HAo3FXRitBqxiX1nKhXpHAZsMciLq8V6RjsNAQwdsdMFvSlVK/7XA
t3FaoJoAsncM1Q9x5+3V0Ww68/eIFmb1zuUFljQJKprrX88XypNDvjYNby6vw/Pb0rwert/En
mZ+AW4OZPnTPI89ZPmVMLuayrD2cE86Z/il8b+gw3r3+1nKatmIkjn2so1d01QraTlMqVSsbx
NrRFi9wrf+M7Q== [email protected]" | base64

और यहाँ बताया गया है कि यह क्या उत्पन्न करता है - एक बेस64 एन्कोडेड स्ट्रिंग:

MTIzLjQ1LjY3Ljg5IHNzaC1yc2EgQUFBQUIzTnphQzF5YzJFQUFBQUJJd0FBQVFFQWtsT1Vwa0RIcmZIWTE3U2JybVRJcE5MVEdLOVRqb20vQldEU1UKR1BsK25hZnpsSERUWVc3aGRJNHlaNWV3MThKSDRKVzlqYmhVRnJ2aVF6TTd4bEVMRVZmNGg5bEZYNVFWa2JQcHBTd2cwY2RhMwpQYnY3a09kSi9NVHlCbFdYRkNSK0hBbzNGWFJpdEJxeGlYMW5LaFhwSEFac01jaUxxOFY2UmpzTkFRd2RzZE1GdlNsVksvN1hBCnQzRmFvSm9Bc25jTTFROXg1KzNWMFd3NjgvZUlGbWIxenVVRmxqUUpLcHJyWDg4WHlwTkR2allOYnk2dncvUGIwcndlcnQvRW4KbVorQVc0T1pQblRQSTg5WlBtVk1MdWF5ckQyY0U4NlovaWw4YitndzNyMysxbkthdG1Ja2puMnNvMWQwMVFyYVRsTXFWU3NieApOclJGaTl3cmYrTTdRPT0geW91QGV4YW1wbGUuY29tCg==

यहाँ ऊपर उल्लिखित आदेश है

install:
  - echo < публичный ключ, закодированный в base64> | base64 -d >> $HOME/.ssh/known_hosts

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

ध्यान देने योग्य एक और बात यह है कि आपको संपूर्ण परिनियोजन स्क्रिप्ट को एक पंक्ति के रूप में चलाने की आवश्यकता हो सकती है, उदाहरण के लिए - के साथ doctl. इसके लिए कुछ अतिरिक्त प्रयास की आवश्यकता हो सकती है.

doctl compute ssh <droplet> --ssh-command "все команды будут здесь && здесь"

टीएलएस/एसएसएल और लोड संतुलन

ऊपर बताई गई सभी चीजें करने के बाद, मुझे जो आखिरी समस्या आई वह यह थी कि सर्वर में एसएसएल नहीं था। चूँकि मैं बाध्य करने के लिए Node.js सर्वर का उपयोग करता हूँ काम करना रिवर्स प्रॉक्सी Nginx और Let's Encrypt, आपको बहुत अधिक छेड़छाड़ करने की आवश्यकता है।

मैं वास्तव में यह सब एसएसएल कॉन्फ़िगरेशन मैन्युअल रूप से नहीं करना चाहता था, इसलिए मैंने बस एक लोड बैलेंसर बनाया और उसका विवरण डीएनएस में दर्ज किया। उदाहरण के लिए, DigitalOcean के मामले में, लोड बैलेंसर पर एक स्वतः-नवीनीकरण स्व-हस्ताक्षरित प्रमाणपत्र बनाना एक सरल, मुफ़्त और तेज़ प्रक्रिया है। इस दृष्टिकोण का अतिरिक्त लाभ यह है कि जरूरत पड़ने पर लोड बैलेंसर के पीछे चलने वाले कई सर्वरों पर एसएसएल स्थापित करना बहुत आसान हो जाता है। यह सर्वरों को एसएसएल के बारे में बिल्कुल भी "सोचने" की अनुमति नहीं देता है, लेकिन साथ ही हमेशा की तरह पोर्ट का उपयोग करता है 80. इसलिए लोड बैलेंसर पर एसएसएल स्थापित करना एसएसएल स्थापित करने के वैकल्पिक तरीकों की तुलना में बहुत आसान और अधिक सुविधाजनक है।

अब आप सर्वर पर आने वाले कनेक्शन स्वीकार करने वाले सभी पोर्ट बंद कर सकते हैं - पोर्ट को छोड़कर 80, लोड बैलेंसर और पोर्ट के साथ संचार करने के लिए उपयोग किया जाता है 22 एसएसएच के लिए. परिणामस्वरूप, इन दोनों के अलावा किसी अन्य पोर्ट पर सर्वर तक सीधे पहुंचने का प्रयास विफल हो जाएगा।

परिणाम

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

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

प्रिय पाठकों! क्या आप अपनी परियोजनाओं में सीआई/सीडी प्रौद्योगिकियों का उपयोग करते हैं?

स्रोत: www.habr.com