CI/CD સાંકળ બનાવવી અને ડોકર સાથે સ્વચાલિત કાર્ય

મેં મારી પ્રથમ વેબસાઇટ્સ 90 ના દાયકાના અંતમાં લખી હતી. તે સમયે તેમને કાર્યકારી ક્રમમાં મૂકવું ખૂબ જ સરળ હતું. કેટલાક શેર કરેલ હોસ્ટિંગ પર અપાચે સર્વર હતું, તમે FTP દ્વારા આ સર્વર પર કંઈક લખીને લોગ ઇન કરી શકો છો ftp://ftp.example.com. પછી તમારે તમારું નામ અને પાસવર્ડ દાખલ કરવો પડશે અને ફાઇલોને સર્વર પર અપલોડ કરવી પડશે. ત્યાં જુદા જુદા સમય હતા, બધું હવે કરતાં તે સમયે સરળ હતું.

ત્યારપછીના બે દાયકામાં બધું ઘણું બદલાઈ ગયું છે. વેબસાઈટ વધુ જટિલ બની ગઈ છે; પ્રોડક્શનમાં રીલીઝ થતા પહેલા તેને એસેમ્બલ કરવી જોઈએ. એક જ સર્વર લોડ બેલેન્સર પાછળ ચાલતા ઘણા સર્વર બની ગયું અને વર્ઝન કંટ્રોલ સિસ્ટમનો ઉપયોગ સામાન્ય બની ગયો.

મારા અંગત પ્રોજેક્ટ માટે મારી પાસે ખાસ ગોઠવણી હતી. અને હું જાણતો હતો કે મારે માત્ર એક ક્રિયા કરીને સાઈટને પ્રોડક્શનમાં જમાવવાની ક્ષમતાની જરૂર છે: શાખામાં કોડ લખવા master GitHub પર. વધુમાં, હું જાણતો હતો કે મારી નાની વેબ એપ્લિકેશનના સંચાલનને સુનિશ્ચિત કરવા માટે, હું વિશાળ કુબરનેટ્સ ક્લસ્ટરનું સંચાલન કરવા, અથવા ડોકર સ્વોર્મ ટેક્નોલોજીનો ઉપયોગ કરવા, અથવા પોડ્સ, એજન્ટો અને અન્ય તમામ પ્રકારના સર્વર્સનો કાફલો જાળવવા માંગતો નથી. જટિલતાઓ કાર્યને શક્ય તેટલું સરળ બનાવવાનું લક્ષ્ય હાંસલ કરવા માટે, મારે CI/CD સાથે પરિચિત થવું જરૂરી હતું.

જો તમારી પાસે એક નાનો પ્રોજેક્ટ છે (આ કિસ્સામાં, એક Node.js પ્રોજેક્ટ) અને તમે આ પ્રોજેક્ટના જમાવટને કેવી રીતે સ્વચાલિત કરવું તે જાણવા માગો છો, જ્યારે તમે ખાતરી કરો કે રિપોઝીટરીમાં જે સંગ્રહિત છે તે ઉત્પાદનમાં જે કાર્ય કરે છે તેનાથી બરાબર મેળ ખાય છે, તો હું લાગે છે કે તમને આ લેખમાં રસ હોઈ શકે છે.

પૂર્વજરૂરીયાતો

આ લેખના વાચકને આદેશ વાક્ય અને બેશ સ્ક્રિપ્ટો લખવાની મૂળભૂત સમજ હોય ​​તેવી અપેક્ષા છે. વધુમાં, તેને એકાઉન્ટ્સની જરૂર પડશે ટ્રેવિસ સીઆઈ и ડોકર હબ.

ઉદ્દેશો

હું એમ નહીં કહું કે આ લેખને બિનશરતી "ટ્યુટોરીયલ" કહી શકાય. આ એક વધુ દસ્તાવેજ છે જેમાં હું જે શીખ્યો છું તેના વિશે વાત કરું છું અને એક સ્વયંસંચાલિત પાસમાં કરવામાં આવેલ કોડના પરીક્ષણ અને અમલીકરણ માટે મને અનુકૂળ પ્રક્રિયાનું વર્ણન કરું છું.

આ જ મારા વર્કફ્લોનો અંત આવ્યો.

સિવાય કોઈપણ રીપોઝીટરી શાખામાં પોસ્ટ કરાયેલ કોડ માટે master, નીચેની ક્રિયાઓ કરવામાં આવે છે:

• ટ્રેવિસ સીઆઈ પર પ્રોજેક્ટ બિલ્ડ શરૂ થાય છે.
• તમામ એકમ, એકીકરણ અને એન્ડ-ટુ-એન્ડ ટેસ્ટ કરવામાં આવે છે.

માત્ર કોડ માટે કે જે માં આવે છે master, નીચે મુજબ કરવામાં આવે છે:

• ઉપર જણાવેલ દરેક વસ્તુ ઉપરાંત...
• વર્તમાન કોડ, સેટિંગ્સ અને પર્યાવરણના આધારે ડોકર ઇમેજ બનાવવી.
• છબીને ડોકર હબ પર જમાવી રહ્યું છે.
• ઉત્પાદન સર્વર સાથે જોડાણ.
• ડોકર હબથી સર્વર પર એક છબી અપલોડ કરી રહ્યું છે.
• વર્તમાન કન્ટેનરને રોકવું અને નવી છબીના આધારે નવું શરૂ કરવું.

જો તમે ડોકર, છબીઓ અને કન્ટેનર વિશે બિલકુલ કંઈ જાણતા નથી, તો ચિંતા કરશો નહીં. હું તમને તેના વિશે બધું કહીશ.

CI/CD શું છે?

સંક્ષિપ્ત CI/CD નો અર્થ "સતત એકીકરણ/સતત જમાવટ" છે.

▍સતત એકીકરણ

સતત એકીકરણ એ એવી પ્રક્રિયા છે જેમાં વિકાસકર્તાઓ પ્રોજેક્ટના મુખ્ય સ્ત્રોત કોડ રિપોઝીટરી (સામાન્ય રીતે એક શાખા) માટે કમિટ કરે છે master). તે જ સમયે, કોડની ગુણવત્તા સ્વચાલિત પરીક્ષણ દ્વારા સુનિશ્ચિત કરવામાં આવે છે.

▍સતત જમાવટ

સતત જમાવટ એ ઉત્પાદનમાં કોડની વારંવાર, સ્વયંસંચાલિત જમાવટ છે. CI/CD ટૂંકાક્ષરનો બીજો ભાગ કેટલીકવાર "સતત વિતરણ" તરીકે જોડવામાં આવે છે. આ મૂળભૂત રીતે "સતત જમાવટ" જેવું જ છે, પરંતુ "સતત ડિલિવરી" એ પ્રોજેક્ટ ડિપ્લોયમેન્ટ પ્રક્રિયા શરૂ કરતા પહેલા ફેરફારોને મેન્યુઅલી પુષ્ટિ કરવાની જરૂરિયાત સૂચવે છે.

પ્રારંભ

આ બધું શીખવા માટે મેં જે એપનો ઉપયોગ કર્યો તેને કહેવાય છે નોંધ લો. આ એક વેબ પ્રોજેક્ટ છે જેના પર હું કામ કરી રહ્યો છું, નોંધ લેવા માટે રચાયેલ છે. શરૂઆતમાં મેં કરવાનો પ્રયાસ કર્યો JAMStack-પ્રોજેક્ટ, અથવા સર્વર વિના ફક્ત ફ્રન્ટ-એન્ડ એપ્લિકેશન, તે ઓફર કરે છે તે પ્રમાણભૂત હોસ્ટિંગ અને પ્રોજેક્ટ ડિપ્લોયમેન્ટ ક્ષમતાઓનો લાભ લેવા માટે નેટલાઈફ કરો. જેમ જેમ એપ્લિકેશનની જટિલતા વધતી ગઈ તેમ, મારે તેનો સર્વર ભાગ બનાવવાની જરૂર પડી, જેનો અર્થ એ થયો કે મારે સ્વયંસંચાલિત એકીકરણ અને પ્રોજેક્ટના સ્વચાલિત જમાવટ માટે મારી પોતાની વ્યૂહરચના ઘડવાની જરૂર પડશે.

મારા કિસ્સામાં, એપ્લિકેશન એ Node.js પર્યાવરણમાં ચાલતું એક એક્સપ્રેસ સર્વર છે, જે સિંગલ-પેજ રિએક્ટ એપ્લિકેશનને સેવા આપે છે અને સુરક્ષિત સર્વર-સાઇડ API ને સપોર્ટ કરે છે. આ આર્કિટેક્ચર વ્યૂહરચનાને અનુસરે છે જે શોધી શકાય છે આપેલ સંપૂર્ણ સ્ટેક પ્રમાણીકરણ માર્ગદર્શિકા.

સાથે મેં સલાહ લીધી મિત્ર, જે ઓટોમેશન નિષ્ણાત છે, અને તેમને પૂછ્યું કે હું ઈચ્છું છું તે રીતે બધું કામ કરવા માટે મારે શું કરવાની જરૂર છે. તેણે મને આ લેખના ગોલ્સ વિભાગમાં દર્શાવેલ સ્વચાલિત વર્કફ્લો કેવો હોવો જોઈએ તેનો વિચાર આપ્યો. આ લક્ષ્યો રાખવાનો અર્થ એ છે કે મારે ડોકરનો ઉપયોગ કેવી રીતે કરવો તે શોધવાની જરૂર છે.

Docker

ડોકર એ એક સાધન છે જે કન્ટેનરાઈઝેશન ટેક્નોલોજીને આભારી છે, એપ્લીકેશનને સરળતાથી વિતરિત, જમાવટ અને સમાન વાતાવરણમાં ચલાવવાની મંજૂરી આપે છે, પછી ભલે ડોકર પ્લેટફોર્મ પોતે અલગ-અલગ વાતાવરણમાં ચાલતું હોય. પ્રથમ, મારે ડોકર કમાન્ડ લાઇન ટૂલ્સ (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
---

▍ટેગ્સ

ટેગ એ ઇમેજના ચોક્કસ વર્ઝનનો સંકેત છે.

▍ડોકર આદેશોનો ઝડપી સંદર્ભ

અહીં કેટલાક સામાન્ય રીતે ઉપયોગમાં લેવાતા ડોકર આદેશોનું વિહંગાવલોકન છે.

ટીમ

સંદર્ભ

અસર

ડોકર બિલ્ડ

છબી

ડોકરફાઇલમાંથી છબી બનાવવી

ડોકર ટેગ

છબી

છબી ટેગીંગ

ડોકર છબીઓ

છબી

સૂચિ છબીઓ

ડોકર રન

કન્ટેનર

છબીના આધારે કન્ટેનર ચલાવવું

ડોકર દબાણ

છબી

રજિસ્ટ્રી પર એક છબી અપલોડ કરી રહ્યું છે

ડોકર ખેંચો

છબી

રજિસ્ટ્રીમાંથી એક છબી લોડ કરી રહ્યું છે

ડોકર પી

કન્ટેનર

લિસ્ટિંગ કન્ટેનર

ડોકર સિસ્ટમ કાપણી

છબી/કન્ટેનર

ન વપરાયેલ કન્ટેનર અને છબીઓ દૂર કરી રહ્યા છીએ

▍ડોકરફાઈલ

હું જાણું છું કે સ્થાનિક રીતે ઉત્પાદન એપ્લિકેશન કેવી રીતે ચલાવવી. મારી પાસે એક વેબપેક રૂપરેખાંકન છે જે તૈયાર રીએક્ટ એપ્લિકેશન બનાવવા માટે રચાયેલ છે. આગળ, મારી પાસે એક આદેશ છે જે પોર્ટ પર 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

જો બધું બરાબર ચાલે છે, તો છબી ડોકર હબ પર ઉપલબ્ધ હશે અને તેને સર્વર પર સરળતાથી અપલોડ કરી શકાય છે અથવા અન્ય વિકાસકર્તાઓને ટ્રાન્સફર કરી શકાય છે.

આગામી પગલાં

અત્યાર સુધીમાં અમે ચકાસી લીધું છે કે એપ્લિકેશન, ડોકર કન્ટેનરના રૂપમાં, સ્થાનિક રીતે ચાલી રહી છે. અમે કન્ટેનર ડોકર હબ પર અપલોડ કર્યું છે. આ બધાનો અર્થ એ છે કે અમે અમારા લક્ષ્ય તરફ ખૂબ જ સારી પ્રગતિ કરી છે. હવે આપણે વધુ બે પ્રશ્નો હલ કરવાની જરૂર છે:

• કોડના પરીક્ષણ અને જમાવટ માટે CI ટૂલ સેટ કરવું.
• ઉત્પાદન સર્વર સુયોજિત કરી રહ્યા છીએ જેથી કરીને તે અમારા કોડને ડાઉનલોડ અને ચલાવી શકે.

અમારા કિસ્સામાં, અમે ઉપયોગ કરીએ છીએ ટ્રેવિસ સીઆઈ. સર્વર તરીકે - ડીટીગલ મહાસાગર.

એ નોંધવું જોઈએ કે અહીં તમે સેવાઓના અન્ય સંયોજનનો ઉપયોગ કરી શકો છો. ઉદાહરણ તરીકે, Travis CI ને બદલે, તમે CircleCI અથવા Github Actions નો ઉપયોગ કરી શકો છો. અને તેના બદલે DigitalOcean - AWS અથવા Linode.

અમે Travis CI સાથે કામ કરવાનું નક્કી કર્યું છે, અને મારી પાસે આ સેવામાં પહેલેથી જ કંઈક ગોઠવેલું છે. તેથી, હવે હું તેને કામ માટે કેવી રીતે તૈયાર કરવું તે વિશે ટૂંકમાં વાત કરીશ.

ટ્રેવિસ સીઆઈ

ટ્રેવિસ CI એ કોડના પરીક્ષણ અને જમાવટ માટેનું એક સાધન છે. હું ટ્રેવિસ સીઆઈની સ્થાપનાની જટિલતાઓમાં જવા માંગતો નથી, કારણ કે દરેક પ્રોજેક્ટ અનન્ય છે, અને આનાથી વધુ ફાયદો થશે નહીં. પરંતુ જો તમે ટ્રેવિસ સીઆઈનો ઉપયોગ કરવાનું નક્કી કરો છો તો હું તમને પ્રારંભ કરવા માટે મૂળભૂત બાબતોને આવરી લઈશ. ભલે તમે Travis CI, CircleCI, Jenkins અથવા બીજું કંઈક પસંદ કરો, સમાન રૂપરેખાંકન પદ્ધતિઓ દરેક જગ્યાએ ઉપયોગમાં લેવાશે.

ટ્રેવિસ CI સાથે પ્રારંભ કરવા માટે, પર જાઓ સાઇટ પ્રોજેક્ટ અને એકાઉન્ટ બનાવો. પછી ટ્રેવિસ CI ને તમારા GitHub એકાઉન્ટ સાથે એકીકૃત કરો. સિસ્ટમ સેટ કરતી વખતે, તમારે રીપોઝીટરીનો ઉલ્લેખ કરવાની જરૂર પડશે કે જેની સાથે તમે કાર્યને સ્વચાલિત કરવા માંગો છો અને તેની ઍક્સેસ સક્ષમ કરો. (હું GitHub નો ઉપયોગ કરું છું, પરંતુ મને ખાતરી છે કે ટ્રેવિસ CI BitBucket, અને GitLab અને અન્ય સમાન સેવાઓ સાથે એકીકૃત થઈ શકે છે).

દરેક વખતે જ્યારે ટ્રેવિસ CI શરૂ થાય છે, સર્વર લોંચ થાય છે, રૂપરેખાંકન ફાઇલમાં ઉલ્લેખિત આદેશોને અમલમાં મૂકે છે, જેમાં અનુરૂપ રિપોઝીટરી શાખાઓને જમાવવાનો સમાવેશ થાય છે.

▍નોકરી જીવન ચક્ર

ટ્રેવિસ 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

▍પરીક્ષણ

રૂપરેખાંકન ફાઈલમાં હું સ્થાનિક ટ્રેવિસ સીઆઈ સર્વરને ગોઠવવા જઈ રહ્યો છું. મેં નોડ 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

જમાવટ સ્ક્રિપ્ટ બે સમસ્યાઓ હલ કરે છે:

• CI ટૂલ (અમારા કિસ્સામાં, ટ્રેવિસ CI) નો ઉપયોગ કરીને છબીને ડોકર હબ પર બનાવો, ટેગ કરો અને મોકલો.
• સર્વર પર ઇમેજ લોડ કરી રહ્યું છે, જૂના કન્ટેનરને બંધ કરી રહ્યું છે અને એક નવું શરૂ કરી રહ્યું છે (અમારા કિસ્સામાં, સર્વર DigitalOcean પ્લેટફોર્મ પર ચાલે છે).

સૌપ્રથમ, તમારે ઈમેજને ડોકર હબ પર બિલ્ડ કરવા, ટેગ કરવા અને ધકેલવા માટે ઓટોમેટિક પ્રક્રિયા સેટ કરવાની જરૂર છે. આ બધું અમે પહેલાથી જ જાતે કર્યું છે તેના જેવું જ છે, સિવાય કે અમને છબીઓને અનન્ય ટૅગ્સ સોંપવા અને સ્વચાલિત લૉગિન માટે વ્યૂહરચના જોઈએ. મને ડિપ્લોયમેન્ટ સ્ક્રિપ્ટની કેટલીક વિગતો, જેમ કે ટેગિંગ વ્યૂહરચના, લોગિન, SSH કી એન્કોડિંગ, SSH કનેક્શન સ્થાપના સાથે મુશ્કેલી હતી. પરંતુ સદભાગ્યે મારો બોયફ્રેન્ડ બેશ સાથે ખૂબ જ સારો છે, જેમ કે અન્ય ઘણી વસ્તુઓ સાથે. તેણે મને આ સ્ક્રિપ્ટ લખવામાં મદદ કરી.

તેથી, સ્ક્રિપ્ટનો પ્રથમ ભાગ છબીને ડોકર હબ પર અપલોડ કરી રહ્યો છે. આ કરવું એકદમ સરળ છે. મેં જે ટેગીંગ સ્કીમનો ઉપયોગ કર્યો છે તેમાં ગિટ હેશ અને ગિટ ટેગ જો અસ્તિત્વમાં હોય તો તેને જોડવાનો સમાવેશ થાય છે. આ સુનિશ્ચિત કરે છે કે ટેગ અનન્ય છે અને તે જે એસેમ્બલી પર આધારિત છે તેને ઓળખવાનું સરળ બનાવે છે. DOCKER_USERNAME и DOCKER_PASSWORD વપરાશકર્તા પર્યાવરણ ચલો છે જે ટ્રેવિસ સીઆઈ ઈન્ટરફેસનો ઉપયોગ કરીને સેટ કરી શકાય છે. ટ્રેવિસ 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, અને તેથી વધુ.

સર્વર સેટ કરવું ખાસ મુશ્કેલ ન હતું. તેથી, મેં બેઝ ઇમેજ પર આધારિત એક ટીપું સેટ કર્યું. એ નોંધવું જોઈએ કે મેં પસંદ કરેલી સિસ્ટમ માટે ડોકરનું વન-ટાઇમ મેન્યુઅલ ઇન્સ્ટોલેશન અને ડોકરનું વન-ટાઇમ મેન્યુઅલ લોંચ જરૂરી છે. મેં ડોકર ઇન્સ્ટોલ કરવા માટે ઉબુન્ટુ 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 અમારામાં બજાર એક છબી છે Docker, જે એક ક્લિકમાં ઇન્સ્ટોલ કરી શકાય છે. પર તમે કન્ટેનરની કામગીરી તપાસી શકો છો VPS. તમામ નવા ગ્રાહકોને 3 દિવસનું પરીક્ષણ મફત આપવામાં આવે છે.

પ્રિય વાચકો! શું તમે તમારા પ્રોજેક્ટ્સમાં CI/CD ટેક્નોલોજીનો ઉપયોગ કરો છો?

સોર્સ: www.habr.com