सीआय/सीडी साखळी तयार करणे आणि डॉकरसह स्वयंचलित कार्य

मी माझी पहिली वेबसाइट 90 च्या दशकाच्या उत्तरार्धात लिहिली. त्यावेळेस त्यांना कार्यरत क्रमाने ठेवणे खूप सोपे होते. काही सामायिक होस्टिंगवर Apache सर्व्हर होता, तुम्ही FTP द्वारे या सर्व्हरमध्ये असे काहीतरी लिहून लॉग इन करू शकता ftp://ftp.example.com. मग तुम्हाला तुमचे नाव आणि पासवर्ड टाकावा लागेल आणि फाइल्स सर्व्हरवर अपलोड कराव्या लागतील. वेगवेगळ्या वेळा होत्या, तेव्हा सर्व काही आतापेक्षा सोपे होते.

त्यानंतरच्या दोन दशकांत सर्व काही खूप बदलले आहे. वेबसाइट्स अधिक क्लिष्ट झाल्या आहेत; उत्पादनात सोडण्यापूर्वी त्या एकत्र केल्या पाहिजेत. एकच सर्व्हर लोड बॅलन्सर्सच्या मागे चालणारे अनेक सर्व्हर बनले आणि आवृत्ती नियंत्रण प्रणालीचा वापर सामान्य झाला.

माझ्या वैयक्तिक प्रकल्पासाठी माझ्याकडे एक विशेष कॉन्फिगरेशन होते. आणि मला माहित होते की मला फक्त एक कृती करून साइटला उत्पादनात उपयोजित करण्याची क्षमता आवश्यक आहे: शाखेत कोड लिहिणे master GitHub वर. या व्यतिरिक्त, मला माहित होते की माझ्या छोट्या वेब ऍप्लिकेशनच्या ऑपरेशनची खात्री करण्यासाठी, मला कुबर्नेट्सचे एक मोठे क्लस्टर व्यवस्थापित करायचे नव्हते किंवा डॉकर स्वॉर्म तंत्रज्ञान वापरायचे नव्हते किंवा पॉड, एजंट आणि इतर सर्व प्रकारच्या सर्व्हरचा ताफा राखायचा नव्हता. गुंतागुंत काम शक्य तितके सोपे करण्याचे उद्दिष्ट साध्य करण्यासाठी, मला CI/CD शी परिचित होणे आवश्यक होते.

जर तुमच्याकडे एक छोटा प्रकल्प असेल (या प्रकरणात, एक Node.js प्रकल्प) आणि तुम्हाला या प्रकल्पाची तैनाती स्वयंचलित कशी करायची हे जाणून घ्यायचे असेल, तर भांडारात जे साठवले जाते ते उत्पादनात काम करणाऱ्या गोष्टींशी तंतोतंत जुळते याची खात्री करून घ्या, तर मी तुम्हाला या लेखात स्वारस्य असेल असे वाटते.

पूर्वतयारी

या लेखाच्या वाचकाला कमांड लाइन आणि बॅश स्क्रिप्ट लिहिण्याची मूलभूत माहिती असणे अपेक्षित आहे. याव्यतिरिक्त, त्याला खात्यांची आवश्यकता असेल ट्रेविस सीआय и डॉकर हब.

उद्दीष्टे

मी असे म्हणणार नाही की या लेखाला बिनशर्त "ट्यूटोरियल" म्हटले जाऊ शकते. हा एक अधिक दस्तऐवज आहे ज्यामध्ये मी जे शिकलो त्याबद्दल बोलतो आणि एका स्वयंचलित पासमध्ये केलेल्या कोडची चाचणी आणि उपयोजन करण्यासाठी माझ्यासाठी अनुकूल असलेल्या प्रक्रियेचे वर्णन करतो.

माझ्या कार्यप्रवाहाचा शेवट असा झाला.

वगळता कोणत्याही भांडार शाखेत पोस्ट केलेल्या कोडसाठी master, खालील क्रिया केल्या जातात:

• ट्रॅव्हिस सीआय वर प्रकल्प बांधणे सुरू होते.
• सर्व युनिट, इंटिग्रेशन आणि एंड-टू-एंड चाचण्या केल्या जातात.

फक्त मध्ये मोडणाऱ्या कोडसाठी master, खालील केले जाते:

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

जर तुम्हाला डॉकर, प्रतिमा आणि कंटेनरबद्दल काहीही माहित नसेल तर काळजी करू नका. मी तुम्हाला त्याबद्दल सर्व सांगेन.

CI/CD म्हणजे काय?

CI/CD चा संक्षेप म्हणजे “सतत एकीकरण/सतत तैनाती”.

▍सतत एकीकरण

सतत एकत्रीकरण ही एक प्रक्रिया आहे ज्यामध्ये विकासक प्रकल्पाच्या मुख्य स्त्रोत कोड रेपॉजिटरी (सामान्यत: एक शाखा) साठी कमिट करतात master). त्याच वेळी, कोडची गुणवत्ता स्वयंचलित चाचणीद्वारे सुनिश्चित केली जाते.

▍सतत तैनाती

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

प्रारंभ करणे

हे सर्व शिकण्यासाठी मी वापरलेले ॲप म्हणतात नोंद घ्या. हा एक वेब प्रकल्प आहे ज्यावर मी काम करत आहे, नोट्स घेण्यासाठी डिझाइन केलेले आहे. सुरुवातीला मी करण्याचा प्रयत्न केला JAMStack-प्रोजेक्ट, किंवा सर्व्हरशिवाय फक्त फ्रंट-एंड ॲप्लिकेशन, ते ऑफर करत असलेल्या मानक होस्टिंग आणि प्रोजेक्ट डिप्लॉयमेंट क्षमतांचा लाभ घेण्यासाठी नेटलिफाई करा. अनुप्रयोगाची जटिलता जसजशी वाढत गेली, तसतसे मला त्याचा सर्व्हर भाग तयार करणे आवश्यक होते, ज्याचा अर्थ असा होतो की मला प्रकल्पाच्या स्वयंचलित एकत्रीकरणासाठी आणि स्वयंचलित उपयोजनासाठी माझी स्वतःची रणनीती तयार करावी लागेल.

माझ्या बाबतीत, ॲप्लिकेशन हा एक एक्सप्रेस सर्व्हर आहे जो Node.js वातावरणात चालतो, सिंगल-पेज रिॲक्ट ॲप्लिकेशनला सेवा देतो आणि सुरक्षित सर्व्हर-साइड API ला सपोर्ट करतो. हे आर्किटेक्चर ज्या रणनीतीमध्ये आढळू शकते त्याचे अनुसरण करते दिले पूर्ण स्टॅक प्रमाणीकरण मार्गदर्शक.

मी सल्लामसलत केली मित्र, जो एक ऑटोमेशन तज्ञ आहे आणि त्याला विचारले की हे सर्व मला हवे तसे कार्य करण्यासाठी मला काय करावे लागेल. त्याने मला या लेखाच्या गोल विभागात वर्णन केलेल्या स्वयंचलित वर्कफ्लो कसा असावा याची कल्पना दिली. ही उद्दिष्टे असण्याचा अर्थ असा आहे की मला डॉकर कसे वापरायचे हे शोधणे आवश्यक आहे.

गोदी कामगार

डॉकर हे एक साधन आहे जे कंटेनरायझेशन तंत्रज्ञानामुळे, ॲप्लिकेशन्सचे वितरण, उपयोजित आणि एकाच वातावरणात सहजतेने करण्यास अनुमती देते, जरी डॉकर प्लॅटफॉर्म स्वतः वेगवेगळ्या वातावरणात चालत असला तरीही. प्रथम, मला डॉकर कमांड लाइन टूल्स (सीएलआय) वर हात मिळवणे आवश्यक आहे. सूचना डॉकर इन्स्टॉलेशन गाइडला अगदी स्पष्ट आणि समजण्यासारखे म्हटले जाऊ शकत नाही, परंतु त्यातून तुम्ही हे शिकू शकता की प्रथम इंस्टॉलेशन चरण घेण्यासाठी, तुम्हाला डॉकर डेस्कटॉप डाउनलोड करणे आवश्यक आहे (मॅक किंवा विंडोजसाठी).

डॉकर हब हे अंदाजे समान गोष्ट आहे GitHub git रेपॉजिटरीज किंवा रेजिस्ट्रीसाठी npm JavaScript पॅकेजेससाठी. हे डॉकर प्रतिमांसाठी ऑनलाइन भांडार आहे. डॉकर डेस्कटॉप याला जोडतो.

तर, डॉकरसह प्रारंभ करण्यासाठी, आपल्याला दोन गोष्टी करण्याची आवश्यकता आहे:

• सेट डॉकर डेस्कटॉप.
• साठी नोंदणी करा डॉकर हब.

यानंतर, डॉकर आवृत्ती तपासण्यासाठी खालील कमांड चालवून तुम्ही डॉकर सीएलआय कार्य करत आहे का ते तपासू शकता:

docker -v

पुढे, विचारल्यावर तुमचे वापरकर्तानाव आणि पासवर्ड टाकून डॉकर हबमध्ये लॉग इन करा:

docker login

डॉकर वापरण्यासाठी, तुम्हाला प्रतिमा आणि कंटेनरच्या संकल्पना समजून घेणे आवश्यक आहे.

▍ प्रतिमा

प्रतिमा ही ब्लूप्रिंटसारखी असते ज्यामध्ये कंटेनर एकत्र करण्याच्या सूचना असतात. हा अनुप्रयोगाच्या फाइल सिस्टम आणि सेटिंग्जचा अपरिवर्तनीय स्नॅपशॉट आहे. विकसक सहजपणे प्रतिमा सामायिक करू शकतात.

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

ही आज्ञा खालील शीर्षलेखासह टेबल आउटपुट करेल:

REPOSITORY     TAG     IMAGE ID     CREATED     SIZE
---

पुढे आपण त्याच फॉरमॅटमधील कमांड्सची काही उदाहरणे पाहू - प्रथम टिप्पणीसह कमांड असते आणि नंतर ते काय आउटपुट करू शकते याचे उदाहरण.

▍कंटेनर

कंटेनर एक एक्झिक्युटेबल पॅकेज आहे ज्यामध्ये ऍप्लिकेशन चालविण्यासाठी आवश्यक असलेल्या सर्व गोष्टी असतात. पायाभूत सुविधांकडे दुर्लक्ष करून या दृष्टिकोनासह अनुप्रयोग नेहमी समान कार्य करेल: वेगळ्या वातावरणात आणि समान वातावरणात. मुद्दा असा आहे की समान प्रतिमेची उदाहरणे वेगवेगळ्या वातावरणात लॉन्च केली जातात.

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

▍टॅग

टॅग हे प्रतिमेच्या विशिष्ट आवृत्तीचे संकेत आहे.

▍डॉकर कमांडचा एक द्रुत संदर्भ

येथे काही सामान्यतः वापरल्या जाणाऱ्या डॉकर कमांडचे विहंगावलोकन आहे.

संघ

संदर्भ

परिणाम

डॉकर बिल्ड

प्रतिमा

डॉकरफाइलवरून प्रतिमा तयार करणे

डॉकर टॅग

प्रतिमा

प्रतिमा टॅगिंग

डॉकर प्रतिमा

प्रतिमा

सूची प्रतिमा

डॉकर रन

कंटेनर

प्रतिमेवर आधारित कंटेनर चालवणे

डॉकर पुश

प्रतिमा

रेजिस्ट्रीमध्ये प्रतिमा अपलोड करत आहे

डॉकर पुल

प्रतिमा

रेजिस्ट्रीमधून प्रतिमा लोड करत आहे

डॉकर पीएस

कंटेनर

कंटेनर सूचीबद्ध करणे

डॉकर प्रणाली छाटणी

प्रतिमा/कंटेनर

न वापरलेले कंटेनर आणि प्रतिमा काढून टाकणे

▍डॉकरफाइल

मला स्थानिक पातळीवर उत्पादन अनुप्रयोग कसा चालवायचा हे माहित आहे. माझ्याकडे वेबपॅक कॉन्फिगरेशन रेडीमेड रिॲक्ट ॲप्लिकेशन तयार करण्यासाठी डिझाइन केलेले आहे. पुढे, माझ्याकडे एक कमांड आहे जी पोर्टवर Node.js आधारित सर्व्हर सुरू करते 5000. हे असे दिसते:

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

हे लक्षात घ्यावे की माझ्याकडे या सामग्रीसाठी उदाहरण अर्ज नाही. परंतु येथे, प्रयोगांसाठी, कोणताही साधा नोड अनुप्रयोग करेल.

कंटेनर वापरण्यासाठी, तुम्हाला डॉकरला सूचना द्याव्या लागतील. नावाच्या फाईलद्वारे हे केले जाते Dockerfile, प्रकल्पाच्या मूळ निर्देशिकेत स्थित आहे. ही फाइल, सुरुवातीला, अगदी अनाकलनीय दिसते.

परंतु त्यात जे आहे ते केवळ विशेष आदेशांसह, कार्य वातावरण सेट करण्यासारखे काहीतरी वर्णन करते. यापैकी काही आज्ञा येथे आहेत:

• प्रेषक — ही कमांड फाइल सुरू करते. हे बेस इमेज निर्दिष्ट करते ज्यावर कंटेनर बांधला आहे.
• कॉपी करा — स्थानिक स्त्रोताकडून कंटेनरमध्ये फाइल्स कॉपी करणे.
• WORKDIR — खालील आदेशांसाठी कार्यरत निर्देशिका सेट करणे.
• धावू - आदेश चालवा.
• उघड करा - पोर्ट सेटिंग्ज.
• ENTRYPOINT - कार्यान्वित करण्याच्या आदेशाचे संकेत.

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

सर्वकाही व्यवस्थित राहिल्यास, प्रतिमा डॉकर हबवर उपलब्ध असेल आणि ती सहजपणे सर्व्हरवर अपलोड केली जाऊ शकते किंवा इतर विकसकांकडे हस्तांतरित केली जाऊ शकते.

पुढील पायऱ्या

आत्तापर्यंत आम्ही हे सत्यापित केले आहे की डॉकर कंटेनरच्या रूपात अनुप्रयोग स्थानिक पातळीवर चालत आहे. आम्ही कंटेनर डॉकर हबवर अपलोड केला आहे. या सर्वांचा अर्थ असा आहे की आम्ही आमच्या ध्येयाकडे खूप चांगली प्रगती केली आहे. आता आपल्याला आणखी दोन प्रश्न सोडवायचे आहेत:

• कोडची चाचणी आणि उपयोजित करण्यासाठी CI टूल सेट करणे.
• प्रॉडक्शन सर्व्हर सेट करत आहे जेणेकरून तो आमचा कोड डाउनलोड करू शकेल आणि चालवू शकेल.

आमच्या बाबतीत, आम्ही वापरतो ट्रेविस सीआय. सर्व्हर म्हणून - DitigalOcean.

हे लक्षात घ्यावे की येथे आपण सेवांचे दुसरे संयोजन वापरू शकता. उदाहरणार्थ, Travis CI ऐवजी, तुम्ही CircleCI किंवा Github Actions वापरू शकता. आणि त्याऐवजी DigitalOcean - AWS किंवा Linode.

आम्ही Travis CI सह काम करण्याचा निर्णय घेतला आणि या सेवेमध्ये माझ्याकडे आधीपासूनच काहीतरी कॉन्फिगर केलेले आहे. म्हणून, आता मी कामासाठी ते कसे तयार करावे याबद्दल थोडक्यात बोलेन.

ट्रेविस सीआय

ट्रॅव्हिस सीआय हे कोडची चाचणी आणि उपयोजन करण्याचे साधन आहे. मला ट्रॅव्हिस सीआयच्या स्थापनेच्या गुंतागुंतीमध्ये जायला आवडणार नाही, कारण प्रत्येक प्रकल्प अद्वितीय आहे आणि यामुळे फारसा फायदा होणार नाही. परंतु तुम्ही ट्रॅव्हिस सीआय वापरण्याचे ठरविल्यास मी तुम्हाला प्रारंभ करण्यासाठी मूलभूत गोष्टी कव्हर करेन. तुम्ही Travis CI, CircleCI, Jenkins किंवा इतर काही निवडले तरीही, समान कॉन्फिगरेशन पद्धती सर्वत्र वापरल्या जातील.

Travis CI सह प्रारंभ करण्यासाठी, येथे जा प्रकल्प आणि खाते तयार करा. नंतर आपल्या GitHub खात्यासह Travis CI समाकलित करा. सिस्टम सेट अप करताना, तुम्हाला रिपॉजिटरी निर्दिष्ट करणे आवश्यक आहे ज्यासह तुम्ही कार्य स्वयंचलित करू इच्छिता आणि त्यात प्रवेश सक्षम करू इच्छिता. (मी GitHub वापरतो, परंतु मला खात्री आहे की Travis 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, आणि ते प्रकल्प बांधण्याची प्रक्रिया खंडित करेल की नाही. या जागतिक कॉन्फिगरेशनमध्ये, मी सर्व काही स्थानिकरित्या स्थापित करतो, पार्श्वभूमीमध्ये वेबपॅक डेव्ह सर्व्हर चालवतो (हे माझ्या वर्कफ्लोचे वैशिष्ट्य आहे), आणि चाचण्या चालवतो.

तुम्हाला तुमच्या भांडारात चाचणी कव्हरेज दर्शवणारे बॅज दाखवायचे असल्यास, येथे ही माहिती संकलित करण्यासाठी आणि प्रदर्शित करण्यासाठी तुम्हाला Jest, Travis CI आणि Coveralls वापरण्याबाबत लहान सूचना मिळू शकतात.

तर फाईलची सामग्री येथे आहे .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

उपयोजन स्क्रिप्ट दोन समस्यांचे निराकरण करते:

• सीआय टूल (आमच्या बाबतीत, ट्रॅव्हिस सीआय) वापरून प्रतिमा तयार करा, टॅग करा आणि डॉकर हबवर पाठवा.
• सर्व्हरवर प्रतिमा लोड करणे, जुना कंटेनर थांबवणे आणि नवीन सुरू करणे (आमच्या बाबतीत, सर्व्हर डिजिटल ओशन प्लॅटफॉर्मवर चालतो).

प्रथम, तुम्हाला प्रतिमा तयार करणे, टॅग करणे आणि डॉकर हबवर ढकलणे यासाठी स्वयंचलित प्रक्रिया सेट करणे आवश्यक आहे. हे सर्व आम्ही आधीच मॅन्युअली केलेल्या गोष्टींसारखेच आहे, त्याशिवाय आम्हाला प्रतिमांना अनन्य टॅग नियुक्त करण्यासाठी आणि स्वयंचलित लॉगिनसाठी धोरण आवश्यक आहे. मला डिप्लॉयमेंट स्क्रिप्टच्या काही तपशीलांमध्ये अडचण आली, जसे की टॅगिंग धोरण, लॉगिन, SSH की एन्कोडिंग, SSH कनेक्शन स्थापना. पण सुदैवाने माझा बॉयफ्रेंड इतर बऱ्याच गोष्टींप्रमाणे बॅशमध्ये खूप चांगला आहे. त्यांनी मला ही स्क्रिप्ट लिहिण्यास मदत केली.

तर, स्क्रिप्टचा पहिला भाग डॉकर हबवर प्रतिमा अपलोड करत आहे. हे करणे अगदी सोपे आहे. मी वापरलेल्या टॅगिंग स्कीममध्ये गीट हॅश आणि गिट टॅग असल्यास, एक अस्तित्वात असल्यास एकत्र करणे समाविष्ट आहे. हे सुनिश्चित करते की टॅग अद्वितीय आहे आणि ते ज्यावर आधारित आहे ते ओळखणे सोपे करते. 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 वापरले, म्हणून जर तुम्ही देखील तेच करण्यासाठी उबंटू वापरत असाल तर तुम्ही फक्त अनुसरण करू शकता हे साधे मार्गदर्शक.

मी येथे सेवेसाठी विशिष्ट आदेशांबद्दल बोलत नाही, कारण हा पैलू वेगवेगळ्या प्रकरणांमध्ये मोठ्या प्रमाणात बदलू शकतो. ज्या सर्व्हरवर प्रकल्प तैनात केला जाईल त्या सर्व्हरशी SSH द्वारे कनेक्ट केल्यानंतर केल्या जाणाऱ्या कृतीची मी फक्त एक सामान्य योजना देईन:

• सध्या चालू असलेला कंटेनर शोधून तो थांबवावा लागेल.
• नंतर आपल्याला पार्श्वभूमीत एक नवीन कंटेनर लॉन्च करण्याची आवश्यकता आहे.
• तुम्हाला सर्व्हरचे स्थानिक पोर्ट सेट करावे लागेल 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

लक्ष देण्यासारख्या काही गोष्टी

हे शक्य आहे की जेव्हा तुम्ही Travis CI वरून SSH द्वारे सर्व्हरशी कनेक्ट कराल, तेव्हा तुम्हाला एक चेतावणी दिसेल जी तुम्हाला इंस्टॉलेशन सुरू ठेवण्यापासून प्रतिबंधित करेल कारण सिस्टम वापरकर्त्याच्या प्रतिसादाची प्रतीक्षा करेल.

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

कनेक्शन स्थापित करताना खाजगी कीसह समान दृष्टीकोन वापरला जाऊ शकतो, कारण सर्व्हरमध्ये प्रवेश करण्यासाठी तुम्हाला खाजगी की आवश्यक असू शकते. की सोबत काम करताना, तुम्हाला ते ट्रॅव्हिस CI पर्यावरण व्हेरिएबलमध्ये सुरक्षितपणे साठवले आहे आणि ते कुठेही प्रदर्शित केले जात नाही याची खात्री करणे आवश्यक आहे.

आणखी एक गोष्ट लक्षात घेण्यासारखी आहे की तुम्हाला संपूर्ण डिप्लॉयमेंट स्क्रिप्ट एक ओळ म्हणून चालवावी लागेल, उदाहरणार्थ - सह doctl. यासाठी काही अतिरिक्त प्रयत्न करावे लागतील.

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

TLS/SSL आणि लोड बॅलन्सिंग

मी वर नमूद केलेले सर्व काही केल्यानंतर, मला शेवटची समस्या आली ती म्हणजे सर्व्हरकडे SSL नाही. सक्ती करण्यासाठी मी Node.js सर्व्हर वापरत असल्याने काम करणे रिव्हर्स प्रॉक्सी Nginx आणि चला एन्क्रिप्ट करा, तुम्हाला खूप टिंकर करावे लागेल.

मला हे सर्व SSL कॉन्फिगरेशन मॅन्युअली करायचे नव्हते, म्हणून मी फक्त लोड बॅलन्सर तयार केला आणि त्याचे तपशील DNS मध्ये रेकॉर्ड केले. डिजिटल ओशनच्या बाबतीत, उदाहरणार्थ, लोड बॅलन्सरवर स्वयं-नूतनीकरण स्वयं-स्वाक्षरी केलेले प्रमाणपत्र तयार करणे ही एक सोपी, विनामूल्य आणि जलद प्रक्रिया आहे. या दृष्टिकोनाचा अतिरिक्त फायदा आहे की आवश्यक असल्यास लोड बॅलन्सरच्या मागे चालणाऱ्या एकाधिक सर्व्हरवर SSL सेट करणे खूप सोपे आहे. हे सर्व्हरना स्वतःला SSL बद्दल अजिबात "विचार" करू शकत नाही, परंतु त्याच वेळी नेहमीप्रमाणे पोर्ट वापरतात. 80. त्यामुळे लोड बॅलन्सरवर SSL सेट करणे SSL सेट करण्याच्या पर्यायी पद्धतींपेक्षा खूप सोपे आणि अधिक सोयीचे आहे.

आता तुम्ही सर्व्हरवरील सर्व पोर्ट बंद करू शकता जे येणारे कनेक्शन स्वीकारतात - पोर्ट वगळता 80, लोड बॅलन्सर आणि पोर्टशी संवाद साधण्यासाठी वापरला जातो 22 SSH साठी. परिणामी, या दोन व्यतिरिक्त इतर कोणत्याही पोर्टवरील सर्व्हरवर थेट प्रवेश करण्याचा प्रयत्न अयशस्वी होईल.

परिणाम

मी या सामग्रीमध्ये जे काही बोललो ते सर्व केल्यानंतर, डॉकर प्लॅटफॉर्म किंवा स्वयंचलित CI/CD चेनच्या संकल्पनांनी मला घाबरवले नाही. मी सतत एकीकरण साखळी सेट करू शकलो, ज्या दरम्यान कोड उत्पादनात जाण्यापूर्वी त्याची चाचणी केली जाते आणि कोड स्वयंचलितपणे सर्व्हरवर तैनात केला जातो. हे सर्व माझ्यासाठी अजूनही तुलनेने नवीन आहे आणि मला खात्री आहे की माझे स्वयंचलित कार्यप्रवाह सुधारण्याचे आणि ते अधिक कार्यक्षम बनवण्याचे मार्ग आहेत. त्यामुळे या विषयावर तुमच्या काही कल्पना असतील तर कृपया मला कळवा. मला माहित आहे मला आशा आहे की या लेखाने तुम्हाला तुमच्या प्रयत्नांमध्ये मदत केली आहे. मला विश्वास ठेवायचा आहे की ते वाचल्यानंतर, मी त्यात जे काही बोललो ते शोधून काढताना मी जितके शिकलो तितकेच तुम्ही शिकलात.

PS आमच्या मध्ये बाजारपेठ एक प्रतिमा आहे गोदी कामगार, जे एका क्लिकवर स्थापित केले जाऊ शकते. येथे आपण कंटेनरचे ऑपरेशन तपासू शकता VPS. सर्व नवीन ग्राहकांना 3 दिवसांची चाचणी मोफत दिली जाते.

प्रिय वाचक! तुम्ही तुमच्या प्रकल्पांमध्ये CI/CD तंत्रज्ञान वापरता?

स्त्रोत: www.habr.com