सीआई/सीडी चेन सिर्जना गर्दै र डकरको साथ स्वचालित कार्य

मैले मेरो पहिलो वेबसाइटहरू 90 को दशकको अन्तमा लेखें। त्यसबेला तिनीहरूलाई कार्य क्रममा राख्न धेरै सजिलो थियो। त्यहाँ केहि साझा होस्टिंगमा Apache सर्भर थियो, तपाईले FTP मार्फत यस सर्भरमा लग इन गर्न सक्नुहुन्छ जस्तै केहि लेखेर ftp://ftp.example.com। त्यसपछि तपाईंले आफ्नो नाम र पासवर्ड प्रविष्ट गर्नुपर्छ र सर्भरमा फाइलहरू अपलोड गर्न थियो। त्यहाँ विभिन्न समयहरू थिए, सबै कुरा अहिले भन्दा पहिले सरल थियो।

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

मेरो व्यक्तिगत परियोजनाको लागि मसँग विशेष कन्फिगरेसन थियो। र मलाई थाहा थियो कि मलाई केवल एउटा कार्य प्रदर्शन गरेर साइटलाई उत्पादनमा प्रयोग गर्ने क्षमता चाहिन्छ: शाखामा कोड लेख्ने master GitHub मा। थप रूपमा, मलाई थाहा थियो कि मेरो सानो वेब अनुप्रयोगको सञ्चालन सुनिश्चित गर्नको लागि, म ठूलो कुबर्नेट्स क्लस्टर व्यवस्थापन गर्न, वा डकर स्वार्म टेक्नोलोजी प्रयोग गर्न वा पोडहरू, एजेन्टहरू र अन्य सबै प्रकारका सर्भरहरूको फ्लीट कायम गर्न चाहन्न। जटिलताहरू। कामलाई सकेसम्म सजिलो बनाउने लक्ष्य हासिल गर्नको लागि, मलाई CI/CD सँग परिचित हुन आवश्यक थियो।

यदि तपाइँसँग एउटा सानो परियोजना छ (यस अवस्थामा, एक Node.js परियोजना) र तपाइँ यस परियोजनाको डिप्लोइमेन्ट कसरी स्वचालित गर्ने भनेर जान्न चाहानुहुन्छ, भण्डारमा भण्डार गरिएको कुरा उत्पादनमा काम गर्ने कुरासँग ठ्याक्कै मेल खान्छ भनेर सुनिश्चित गर्दै, तब म। सोच्नुहोस् कि तपाइँ यस लेखमा रुचि राख्न सक्नुहुन्छ।

पूर्वापेक्षाहरु

यस लेखको पाठकलाई कमाण्ड लाइन र बास लिपिहरू लेख्ने आधारभूत बुझाइ हुने अपेक्षा गरिएको छ। थप रूपमा, उसलाई खाताहरू चाहिन्छ ट्राभिस सीआई и डकर हब.

उद्देश्यहरू

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

यो मेरो कार्यप्रवाह समाप्त भयो।

बाहेक कुनै पनि भण्डार शाखामा पोस्ट गरिएको कोडको लागि master, निम्न कार्यहरू प्रदर्शन गरिन्छ:

• Travis CI मा निर्माण परियोजना सुरु हुन्छ।
• सबै एकाइ, एकीकरण र अन्त-देखि-अन्त परीक्षणहरू प्रदर्शन गरिन्छ।

केवल कोडको लागि जुन भित्र पर्दछ master, निम्न कार्य गरिन्छ:

• माथि उल्लेखित सबै, प्लस ...
• हालको कोड, सेटिङहरू र वातावरणमा आधारित डकर छवि निर्माण गर्दै।
• डकर हबमा छवि तैनाथ गर्दै।
• उत्पादन सर्भरमा जडान।
• डकर हबबाट सर्भरमा छवि अपलोड गर्दै।
• हालको कन्टेनर रोक्दै र नयाँ छविमा आधारित नयाँ सुरु गर्दै।

यदि तपाईंलाई डकर, छविहरू र कन्टेनरहरूको बारेमा बिल्कुलै थाहा छैन भने, चिन्ता नगर्नुहोस्। म तपाईलाई यसको बारेमा सबै बताउनेछु।

CI/CD भनेको के हो?

संक्षिप्त नाम CI/CD को अर्थ "निरन्तर एकीकरण/निरन्तर तैनाती" हो।

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

निरन्तर एकीकरण एक प्रक्रिया हो जसमा विकासकर्ताहरूले परियोजनाको मुख्य स्रोत कोड भण्डार (सामान्यतया एउटा शाखा) मा प्रतिबद्धता गर्दछ। master)। एकै समयमा, कोडको गुणस्तर स्वचालित परीक्षण मार्फत सुनिश्चित गरिएको छ।

▍ निरन्तर परिनियोजन

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

सुरुवात

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

मेरो मामलामा, अनुप्रयोग Node.js वातावरणमा चलिरहेको एक्सप्रेस सर्भर हो, एकल-पृष्ठ प्रतिक्रिया अनुप्रयोग सेवा गर्दै र सुरक्षित सर्भर-साइड API समर्थन गर्दछ। यो वास्तुकला रणनीति पछ्याउँछ जुन मा पाउन सकिन्छ यो पूर्ण स्ट्याक प्रमाणीकरण गाइड।

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

डकर

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

डकर हब लगभग उस्तै कुरा हो GitHub git भण्डार, वा रजिस्ट्री को लागी npm JavaScript प्याकेजहरूको लागि। यो डकर छविहरूको लागि अनलाइन भण्डार हो। यो के हो डकर डेस्कटप जडान हुन्छ।

त्यसोभए, डकरको साथ सुरू गर्न, तपाईंले दुई चीजहरू गर्न आवश्यक छ:

• सेट डकर डेस्कटप.
• लागि दर्ता गर्नुहोस् डकर हब.

यस पछि, तपाईंले डकर संस्करण जाँच गर्न निम्न आदेश चलाएर डकर CLI काम गरिरहेको छ कि छैन भनेर जाँच गर्न सक्नुहुन्छ:

docker -v

अर्को, सोध्दा तपाईंको प्रयोगकर्ता नाम र पासवर्ड प्रविष्ट गरेर डकर हबमा लग इन गर्नुहोस्:

docker login

डकर प्रयोग गर्न, तपाईंले छविहरू र कन्टेनरहरूको अवधारणाहरू बुझ्नुपर्छ।

▍ छविहरू

एउटा छवि एउटा खाका जस्तो चीज हो जसमा कन्टेनर भेला गर्न निर्देशनहरू समावेश हुन्छन्। यो एपको फाइल प्रणाली र सेटिङहरूको अपरिवर्तनीय स्न्यापसट हो। विकासकर्ताहरूले सजिलै छविहरू साझेदारी गर्न सक्छन्।

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

यो आदेशले निम्न हेडरको साथ तालिका आउटपुट गर्नेछ:

REPOSITORY     TAG     IMAGE ID     CREATED     SIZE
---

अर्को हामी एउटै ढाँचामा आदेशहरूको केही उदाहरणहरू हेर्नेछौं - पहिले त्यहाँ टिप्पणीको साथ आदेश छ, र त्यसपछि यसले के आउटपुट गर्न सक्छ भन्ने उदाहरण।

▍ कन्टेनरहरू

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

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

▍ट्यागहरू

एक ट्याग छवि को एक विशिष्ट संस्करण को एक संकेत हो।

▍ डकर आदेशहरूको द्रुत सन्दर्भ

यहाँ केहि सामान्य रूपमा प्रयोग हुने डकर आदेशहरूको सिंहावलोकन छ।

टोली

प्रस्ग

प्रभाव

डकर निर्माण

छवि

डकरफाइलबाट छवि निर्माण गर्दै

डकर ट्याग

छवि

छवि ट्यागिङ

डकर तस्बिरहरू

छवि

छविहरू सूचीबद्ध गर्दै

डकर रन

कंटेनर

छविमा आधारित कन्टेनर चलाउँदै

डकर धक्का

छवि

रजिस्ट्रीमा छवि अपलोड गर्दै

डकर पुल

छवि

रजिस्ट्रीबाट छवि लोड गर्दै

docker PS

कंटेनर

कन्टेनरहरू सूचीबद्ध गर्दै

डकर प्रणाली प्रुन

छवि/कन्टेनर

प्रयोग नगरिएका कन्टेनर र छविहरू हटाउँदै

▍डकरफाइल

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

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

यो ध्यान दिनुपर्छ कि मसँग यस सामग्रीको लागि उदाहरण अनुप्रयोग छैन। तर यहाँ, प्रयोगहरूको लागि, कुनै पनि साधारण नोड अनुप्रयोगले गर्नेछ।

कन्टेनर प्रयोग गर्नको लागि, तपाईंले डकरलाई निर्देशन दिन आवश्यक छ। यो भनिन्छ फाइल मार्फत गरिन्छ Dockerfile, परियोजनाको मूल डाइरेक्टरीमा अवस्थित छ। यो फाइल, सुरुमा, एकदम अबोध देखिन्छ।

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

• देखि - यो आदेशले फाइल सुरु गर्छ। यसले आधार छवि निर्दिष्ट गर्दछ जसमा कन्टेनर बनाइएको छ।
• कापी - स्थानीय स्रोतबाट कन्टेनरमा फाइलहरू प्रतिलिपि गर्दै।
• WORKDIR - निम्न आदेशहरूको लागि कार्य निर्देशिका सेट गर्दै।
• RUN - चलिरहेको आदेशहरू।
• ExposE - पोर्ट सेटिङहरू।
• 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 कार्यहरू प्रयोग गर्न सक्नुहुन्छ। र DigitalOcean को सट्टा - AWS वा Linode।

हामीले Travis CI सँग काम गर्ने निर्णय गर्यौं, र मसँग पहिले नै यो सेवामा कन्फिगर गरिएको छ। त्यसकारण, अब म यसलाई कसरी कामको लागि तयार गर्ने बारे छोटकरीमा कुरा गर्नेछु।

ट्राभिस सीआई

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

Travis CI को साथ सुरू गर्न, जानुहोस् परियोजना परियोजना र खाता सिर्जना गर्नुहोस्। त्यसपछि तपाइँको GitHub खाता संग Travis CI एकीकृत गर्नुहोस्। प्रणाली सेटअप गर्दा, तपाईंले भण्डार निर्दिष्ट गर्न आवश्यक छ जसको साथ तपाईं काम स्वचालित गर्न र यसलाई पहुँच सक्षम गर्न चाहनुहुन्छ। (म GitHub प्रयोग गर्दछु, तर म पक्का छु कि Travis CI BitBucket, र GitLab, र अन्य समान सेवाहरूसँग एकीकृत हुन सक्छ)।

प्रत्येक पटक Travis CI सुरु हुन्छ, सर्भर सुरु हुन्छ, कन्फिगरेसन फाइलमा निर्दिष्ट आदेशहरू कार्यान्वयन गर्दै, सम्बन्धित भण्डार शाखाहरू तैनाती सहित।

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

Travis CI कन्फिगरेसन फाइल बोलाइयो .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

▍परीक्षण

कन्फिगरेसन फाइलमा म स्थानीय Travis CI सर्भर कन्फिगर गर्न जाँदैछु। मैले भाषाको रूपमा नोड 12 चयन गरें र प्रणालीलाई डकर प्रयोग गर्न आवश्यक निर्भरताहरू स्थापना गर्न भने।

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

यदि तपाइँ तपाइँको भण्डारले परीक्षण कभरेज संकेत गर्ने ब्याजहरू प्रदर्शन गर्न चाहनुहुन्छ भने, यहाँ तपाईंले यो जानकारी सङ्कलन र प्रदर्शन गर्न 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

डिप्लोइमेन्ट स्क्रिप्टले दुई समस्या समाधान गर्छ:

• सीआई उपकरण (हाम्रो अवस्थामा, ट्राभिस CI) प्रयोग गरेर छविलाई डकर हबमा बनाउनुहोस्, ट्याग गर्नुहोस् र पठाउनुहोस्।
• सर्भरमा छवि लोड गर्दै, पुरानो कन्टेनर रोक्दै र नयाँ सुरु गर्दै (हाम्रो अवस्थामा, सर्भर DigitalOcean प्लेटफर्ममा चल्छ)।

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

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

यहाँ स्क्रिप्टको पहिलो भाग हो 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, र यस्तै।

सर्भर सेटअप गर्न विशेष गाह्रो थिएन। त्यसोभए, मैले आधार छविमा आधारित ड्रपलेट सेट अप गरें। यो ध्यान दिनुपर्छ कि मैले रोजेको प्रणालीलाई डकरको एक-पटक म्यानुअल स्थापना र डकरको एक-पटक म्यानुअल सुरुवात चाहिन्छ। मैले डकर स्थापना गर्न Ubuntu 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

र यहाँ यसले के उत्पादन गर्छ - एक base64 एन्कोड गरिएको स्ट्रिङ:

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 मा रेकर्ड गरें। DigitalOcean को मामला मा, उदाहरण को लागी, लोड ब्यालेन्सर मा एक स्वत: नवीकरण स्व-हस्ताक्षरित प्रमाणपत्र सिर्जना एक सरल, नि: शुल्क र छिटो प्रक्रिया हो। यस दृष्टिकोणको थप लाभ छ कि यसले आवश्यक भएमा लोड ब्यालेन्सर पछाडि चलिरहेको बहु सर्भरहरूमा SSL सेटअप गर्न धेरै सजिलो बनाउँछ। यसले सर्भरहरूलाई SSL को बारेमा "सोच्न" नदिने अनुमति दिन्छ, तर एकै समयमा पोर्टलाई सामान्य रूपमा प्रयोग गर्नुहोस्। 80। त्यसैले लोड ब्यालेन्सरमा SSL सेटअप गर्नु SSL सेटअप गर्ने वैकल्पिक विधिहरू भन्दा धेरै सजिलो र अधिक सुविधाजनक छ।

अब तपाइँ सर्भरमा सबै पोर्टहरू बन्द गर्न सक्नुहुन्छ जुन आगमन जडानहरू स्वीकार गर्दछ - पोर्ट बाहेक 80, लोड ब्यालेन्सर र पोर्टसँग सञ्चार गर्न प्रयोग गरिन्छ 22 SSH को लागी। नतिजाको रूपमा, यी दुई बाहेक अन्य कुनै पनि पोर्टहरूमा सर्भर पहुँच गर्ने प्रयास असफल हुनेछ।

परिणामहरू

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

PS हाम्रोमा बजार त्यहाँ एक छवि छ डकर, जुन एक क्लिकमा स्थापित गर्न सकिन्छ। तपाईं कन्टेनर को सञ्चालन मा जाँच गर्न सक्नुहुन्छ VPS। सबै नयाँ ग्राहकहरूलाई 3 दिनको परीक्षण निःशुल्क दिइन्छ।

प्रिय पाठकहरु! के तपाइँ तपाइँको परियोजनाहरूमा CI/CD प्रविधिहरू प्रयोग गर्नुहुन्छ?

स्रोत: www.habr.com