একটি সিআই/সিডি চেইন তৈরি করা এবং ডকারের সাথে স্বয়ংক্রিয় কাজ করা

আমি 90 এর দশকের শেষের দিকে আমার প্রথম ওয়েবসাইট লিখেছিলাম। তখন তাদের কাজের ক্রমে রাখা খুব সহজ ছিল। কিছু শেয়ার্ড হোস্টিং এ একটি Apache সার্ভার ছিল, আপনি FTP এর মাধ্যমে এই সার্ভারে লগ ইন করতে পারেন এরকম কিছু লিখে ftp://ftp.example.com. তারপরে আপনাকে আপনার নাম এবং পাসওয়ার্ড লিখতে হবে এবং ফাইলগুলি সার্ভারে আপলোড করতে হবে। বিভিন্ন সময় ছিল, এখনকার চেয়ে তখন সবকিছু সহজ ছিল।

তারপর থেকে দুই দশকে সবকিছু অনেক বদলে গেছে। ওয়েবসাইটগুলি আরও জটিল হয়ে উঠেছে; প্রোডাকশনে মুক্তি পাওয়ার আগে সেগুলিকে একত্রিত করতে হবে৷ একটি একক সার্ভার লোড ব্যালেন্সারের পিছনে চলমান অনেকগুলি সার্ভারে পরিণত হয় এবং সংস্করণ নিয়ন্ত্রণ ব্যবস্থার ব্যবহার সাধারণ হয়ে ওঠে।

আমার ব্যক্তিগত প্রকল্পের জন্য আমার একটি বিশেষ কনফিগারেশন ছিল। এবং আমি জানতাম যে আমার শুধুমাত্র একটি ক্রিয়া সম্পাদন করে সাইটটিকে উৎপাদনে স্থাপন করার ক্ষমতা প্রয়োজন: একটি শাখায় কোড লেখা master গিটহাবে। উপরন্তু, আমি জানতাম যে আমার ছোট ওয়েব অ্যাপ্লিকেশনের অপারেশন নিশ্চিত করার জন্য, আমি একটি বিশাল কুবারনেটস ক্লাস্টার পরিচালনা করতে চাইনি, বা ডকার সোয়ার্ম প্রযুক্তি ব্যবহার করতে চাইনি, বা পড, এজেন্ট এবং অন্যান্য সমস্ত ধরণের সার্ভারের বহর বজায় রাখতে চাইনি। জটিলতা কাজ যতটা সম্ভব সহজ করার লক্ষ্য অর্জন করার জন্য, আমাকে CI/CD এর সাথে পরিচিত হতে হবে।

আপনার যদি একটি ছোট প্রকল্প থাকে (এই ক্ষেত্রে, একটি Node.js প্রকল্প) এবং আপনি জানতে চান কিভাবে এই প্রকল্পের স্থাপনা স্বয়ংক্রিয়ভাবে করা যায়, এবং নিশ্চিত করে যে রিপোজিটরিতে যা সংরক্ষিত আছে তা উৎপাদনে যা কাজ করে তার সাথে মিলে যায়, তাহলে আমি আপনি এই নিবন্ধে আগ্রহী হতে পারে মনে হয়.

পূর্বশর্ত

এই নিবন্ধটির পাঠকের কমান্ড লাইন এবং ব্যাশ স্ক্রিপ্ট লেখার প্রাথমিক ধারণা রয়েছে বলে আশা করা হচ্ছে। উপরন্তু, তার অ্যাকাউন্ট প্রয়োজন হবে ট্র্যাভিস সিআই и ডকার হাব.

গোল

আমি বলব না যে এই নিবন্ধটিকে নিঃশর্তভাবে "টিউটোরিয়াল" বলা যেতে পারে। এটি আরও একটি নথি যেখানে আমি যা শিখেছি সে সম্পর্কে কথা বলি এবং একটি স্বয়ংক্রিয় পাসে সঞ্চালিত প্রোডাকশনে কোড পরীক্ষা এবং স্থাপন করার জন্য আমার জন্য উপযুক্ত প্রক্রিয়া বর্ণনা করি।

এই আমার কর্মপ্রবাহ হচ্ছে কি শেষ.

ব্যতীত যেকোনো সংগ্রহস্থল শাখায় পোস্ট করা কোডের জন্য master, নিম্নলিখিত কর্ম সঞ্চালিত হয়:

• ট্র্যাভিস সিআই-এর উপর নির্মিত প্রকল্পটি শুরু হয়।
• সমস্ত ইউনিট, ইন্টিগ্রেশন এবং শেষ থেকে শেষ পরীক্ষা সঞ্চালিত হয়।

শুধুমাত্র যে কোডের মধ্যে পড়ে তার জন্য master, নিম্নলিখিত সঞ্চালিত হয়:

• উপরে উল্লিখিত সবকিছু, প্লাস...
• বর্তমান কোড, সেটিংস এবং পরিবেশের উপর ভিত্তি করে একটি ডকার ইমেজ তৈরি করা।
• ডকার হাবে ছবিটি স্থাপন করা হচ্ছে।
• উৎপাদন সার্ভারের সাথে সংযোগ।
• ডকার হাব থেকে সার্ভারে একটি ছবি আপলোড করা হচ্ছে।
• বর্তমান ধারক বন্ধ করা এবং নতুন ছবির উপর ভিত্তি করে একটি নতুন শুরু করা।

আপনি যদি ডকার, চিত্র এবং পাত্র সম্পর্কে একেবারে কিছুই না জানেন তবে চিন্তা করবেন না। আমি আপনাকে এটি সম্পর্কে সব বলব।

CI/CD কি?

সংক্ষিপ্ত রূপ CI/CD-এর অর্থ হল "অবিচ্ছিন্ন একীকরণ/নিরবিচ্ছিন্ন স্থাপনা।"

▍ ক্রমাগত একীকরণ

ক্রমাগত ইন্টিগ্রেশন হল এমন একটি প্রক্রিয়া যেখানে ডেভেলপাররা প্রকল্পের মূল সোর্স কোড রিপোজিটরিতে প্রতিশ্রুতি দেয় (সাধারণত একটি শাখা master) একই সময়ে, স্বয়ংক্রিয় পরীক্ষার মাধ্যমে কোডের গুণমান নিশ্চিত করা হয়।

▍ অবিরাম স্থাপনা

ক্রমাগত স্থাপনা হল ঘন ঘন, স্বয়ংক্রিয়ভাবে কোড উৎপাদনে স্থাপন। CI/CD সংক্ষিপ্ত রূপের দ্বিতীয় অংশকে কখনও কখনও "অবিচ্ছিন্ন বিতরণ" হিসাবে বানান করা হয়। এটি মূলত "নিরবিচ্ছিন্ন স্থাপনার" মতই, কিন্তু "নিরবিচ্ছিন্ন বিতরণ" প্রকল্পের স্থাপনা প্রক্রিয়া শুরু করার আগে ম্যানুয়ালি পরিবর্তনগুলি নিশ্চিত করার প্রয়োজনীয়তা বোঝায়।

গেটিং স্টার্টেড

এই সব শিখতে আমি যে অ্যাপটি ব্যবহার করি তাকে বলা হয় নোট নাও. এটি একটি ওয়েব প্রকল্প যা আমি কাজ করছি, নোট নেওয়ার জন্য ডিজাইন করা হয়েছে। প্রথমে আমি করার চেষ্টা করেছি JAMStack-প্রকল্প, বা শুধুমাত্র একটি সার্ভার ছাড়াই একটি ফ্রন্ট-এন্ড অ্যাপ্লিকেশন, যাতে এটি অফার করে এমন স্ট্যান্ডার্ড হোস্টিং এবং প্রকল্প স্থাপনের ক্ষমতার সুবিধা নিতে নেটলিফাই. অ্যাপ্লিকেশনটির জটিলতা বাড়ার সাথে সাথে, আমাকে এটির সার্ভার অংশ তৈরি করতে হয়েছিল, যার অর্থ হল যে প্রকল্পের স্বয়ংক্রিয় সংহতকরণ এবং স্বয়ংক্রিয় স্থাপনার জন্য আমার নিজস্ব কৌশল তৈরি করতে হবে।

আমার ক্ষেত্রে, অ্যাপ্লিকেশনটি Node.js পরিবেশে চলমান একটি এক্সপ্রেস সার্ভার, একটি একক-পৃষ্ঠা প্রতিক্রিয়া অ্যাপ্লিকেশন পরিবেশন করে এবং একটি সুরক্ষিত সার্ভার-সাইড API সমর্থন করে। এই স্থাপত্যটি সেই কৌশল অনুসরণ করে যা পাওয়া যেতে পারে এই সম্পূর্ণ স্ট্যাক প্রমাণীকরণ গাইড।

সাথে পরামর্শ করলাম বন্ধু, যিনি একজন অটোমেশন বিশেষজ্ঞ, এবং তাকে জিজ্ঞাসা করলেন যে আমার ইচ্ছামত কাজ করার জন্য আমার কী করা দরকার। তিনি আমাকে একটি স্বয়ংক্রিয় কর্মপ্রবাহ কেমন হওয়া উচিত সে সম্পর্কে ধারণা দিয়েছেন, এই নিবন্ধের লক্ষ্য বিভাগে বর্ণিত হয়েছে। এই লক্ষ্যগুলি থাকার অর্থ হল যে আমাকে কীভাবে ডকার ব্যবহার করবেন তা খুঁজে বের করতে হবে।

ডকশ্রমিক

ডকার হল একটি টুল যা, কনটেইনারাইজেশন প্রযুক্তির জন্য ধন্যবাদ, অ্যাপ্লিকেশনগুলিকে সহজেই বিতরণ, স্থাপন এবং একই পরিবেশে চালানোর অনুমতি দেয়, এমনকি ডকার প্ল্যাটফর্ম নিজেই বিভিন্ন পরিবেশে চলে। প্রথমে, আমাকে ডকার কমান্ড লাইন টুলস (সিএলআই) এ আমার হাত পেতে হবে। নির্দেশ ডকার ইনস্টলেশন গাইডটি ঠিক ততটা স্পষ্ট এবং সহজবোধ্য নয়, তবে এতে বলা আছে যে ইনস্টলেশনের প্রথম ধাপ হিসেবে আপনাকে ডকার ডেস্কটপ (ম্যাক বা এর জন্য) ডাউনলোড করতে হবে। Windows).

ডকার হাব মোটামুটি একই জিনিস 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
---

▍ট্যাগ

একটি ট্যাগ একটি চিত্রের একটি নির্দিষ্ট সংস্করণের একটি ইঙ্গিত।

▍ ডকার কমান্ডের একটি দ্রুত রেফারেন্স

এখানে কিছু সাধারণভাবে ব্যবহৃত ডকার কমান্ডের একটি ওভারভিউ রয়েছে।

টীম

প্রসঙ্গ

প্রভাব

ডকার বিল্ড

ভাবমূর্তি

একটি ডকারফাইল থেকে একটি ছবি তৈরি করা

ডকার ট্যাগ

ভাবমূর্তি

ইমেজ ট্যাগিং

ডকার ইমেজ

ভাবমূর্তি

ইমেজ তালিকা

ডকার রান

আধার

একটি ছবির উপর ভিত্তি করে একটি ধারক চালানো

ডকার ধাক্কা

ভাবমূর্তি

রেজিস্ট্রিতে একটি ছবি আপলোড করা হচ্ছে

ডকার টান

ভাবমূর্তি

রেজিস্ট্রি থেকে একটি ছবি লোড করা হচ্ছে

ডকার ps

আধার

তালিকা পাত্রে

ডকার সিস্টেম ছাঁটাই

ছবি/ধারক

অব্যবহৃত পাত্র এবং ছবি অপসারণ

▍ডকারফাইল

আমি জানি কিভাবে স্থানীয়ভাবে একটি উত্পাদন অ্যাপ্লিকেশন চালাতে হয়। আমার কাছে একটি রেডিমেড রিঅ্যাক্ট অ্যাপ্লিকেশন তৈরি করার জন্য ডিজাইন করা একটি ওয়েবপ্যাক কনফিগারেশন আছে। এর পরে, আমার কাছে একটি কমান্ড রয়েছে যা পোর্টে একটি 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

আপনার নির্বাচিত বেস ইমেজের উপর নির্ভর করে, আপনাকে অতিরিক্ত ডিপেন্ডেন্সি ইনস্টল করতে হতে পারে। এর কারণ হলো কিছু বেস ইমেজ (যেমন নোড আলপাইন) Linuxএগুলোকে যথাসম্ভব কম জায়গা নেয় এমনভাবে ডিজাইন করা হয়েছে। ফলে, এতে আপনার প্রয়োজনীয় কিছু প্রোগ্রাম নাও থাকতে পারে।

▍কন্টেইনার নির্মাণ, ট্যাগিং এবং চালানো

লোকাল অ্যাসেম্বলি ও লঞ্চের কনটেইনার পরে আছে 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 অ্যাকশন ব্যবহার করতে পারেন। এবং DigitalOcean এর পরিবর্তে - AWS বা Linode।

আমরা Travis CI এর সাথে কাজ করার সিদ্ধান্ত নিয়েছি, এবং আমি ইতিমধ্যে এই পরিষেবাতে কিছু কনফিগার করেছি। অতএব, এখন আমি কীভাবে এটিকে কাজের জন্য প্রস্তুত করব সে সম্পর্কে সংক্ষেপে কথা বলব।

ট্র্যাভিস সিআই

ট্র্যাভিস সিআই কোড পরীক্ষা এবং স্থাপনের জন্য একটি সরঞ্জাম। আমি ট্র্যাভিস সিআই স্থাপনের জটিলতায় যেতে চাই না, যেহেতু প্রতিটি প্রকল্প অনন্য, এবং এটি খুব বেশি সুবিধা নিয়ে আসবে না। কিন্তু আপনি যদি ট্র্যাভিস সিআই ব্যবহার করার সিদ্ধান্ত নেন তবে আপনাকে শুরু করার জন্য আমি মৌলিক বিষয়গুলি কভার করব। আপনি Travis CI, CircleCI, Jenkins বা অন্য কিছু চয়ন করুন না কেন, অনুরূপ কনফিগারেশন পদ্ধতি সর্বত্র ব্যবহার করা হবে।

ট্র্যাভিস সিআই দিয়ে শুরু করতে, যান প্রকল্প এবং একটি অ্যাকাউন্ট তৈরি করুন। তারপরে আপনার গিটহাব অ্যাকাউন্টের সাথে ট্র্যাভিস সিআই একীভূত করুন। সিস্টেম সেট আপ করার সময়, আপনাকে সেই রিপোজিটরিটি নির্দিষ্ট করতে হবে যার সাথে আপনি কাজ স্বয়ংক্রিয় করতে চান এবং এটিতে অ্যাক্সেস সক্ষম করতে চান। (আমি গিটহাব ব্যবহার করি, তবে আমি নিশ্চিত যে ট্র্যাভিস সিআই বিটবাকেট, এবং গিটল্যাব এবং অন্যান্য অনুরূপ পরিষেবাগুলির সাথে একীভূত হতে পারে)।

প্রতিবার ট্র্যাভিস সিআই চালু হলে, একটি সার্ভার চালু করা হয় যা কনফিগারেশন ফাইলে উল্লেখিত কমান্ডগুলি কার্যকর করে, যার মধ্যে সংশ্লিষ্ট সংগ্রহস্থল শাখাগুলি স্থাপন করা হয়।

▍চাকরীর জীবনচক্র

ট্র্যাভিস সিআই কনফিগারেশন ফাইল বলা হয় .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 টুল ব্যবহার করে ইমেজটিকে ডকার হাবে তৈরি করুন, ট্যাগ করুন এবং পাঠান (আমাদের ক্ষেত্রে, ট্র্যাভিস সিআই)।
• সার্ভারে চিত্রটি লোড করা, পুরানো ধারকটি বন্ধ করা এবং একটি নতুন শুরু করা (আমাদের ক্ষেত্রে, সার্ভারটি DigitalOcean প্ল্যাটফর্মে চলে)।

প্রথমে, আপনাকে ডকার হাবে ইমেজ তৈরি, ট্যাগিং এবং পুশ করার জন্য একটি স্বয়ংক্রিয় প্রক্রিয়া সেট আপ করতে হবে। ইমেজ এবং স্বয়ংক্রিয় লগইনগুলিতে অনন্য ট্যাগ বরাদ্দ করার জন্য আমাদের একটি কৌশল প্রয়োজন ছাড়া এটি আমরা ইতিমধ্যে ম্যানুয়ালি যা করেছি তার সাথে খুব মিল। ডিপ্লয়মেন্ট স্ক্রিপ্টের কিছু বিবরণ যেমন ট্যাগিং কৌশল, লগইন, এসএসএইচ কী এনকোডিং, এসএসএইচ সংযোগ স্থাপনে আমার অসুবিধা হয়েছিল। কিন্তু সৌভাগ্যবশত আমার বয়ফ্রেন্ড বাশের সাথে অনেক ভালো, যেমনটা অন্য অনেক কিছুর সাথে। তিনি আমাকে এই স্ক্রিপ্ট লিখতে সাহায্য করেছেন।

সুতরাং, স্ক্রিপ্টের প্রথম অংশটি ডকার হাবে ছবিটি আপলোড করছে। এটি করা বেশ সহজ। আমি যে ট্যাগিং স্কিমটি ব্যবহার করেছি তাতে একটি গিট হ্যাশ এবং একটি গিট ট্যাগ একত্রিত করা জড়িত, যদি একটি বিদ্যমান থাকে। এটি নিশ্চিত করে যে ট্যাগটি অনন্য এবং এটি যেটির উপর ভিত্তি করে সেটিকে সনাক্ত করা সহজ করে তোলে। DOCKER_USERNAME и DOCKER_PASSWORD ব্যবহারকারীর পরিবেশের ভেরিয়েবল যা ট্র্যাভিস সিআই ইন্টারফেস ব্যবহার করে সেট করা যেতে পারে। 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}

স্ক্রিপ্টের দ্বিতীয় অংশটি কী হবে তা সম্পূর্ণরূপে নির্ভর করে আপনি কোন হোস্ট ব্যবহার করছেন এবং এটির সাথে সংযোগটি কীভাবে সংগঠিত হয়েছে তার উপর। আমার ক্ষেত্রে, যেহেতু আমি ডিজিটাল মহাসাগর ব্যবহার করি, আমি সার্ভারের সাথে সংযোগ করতে কমান্ডগুলি ব্যবহার করি ডক্টএল. AWS এর সাথে কাজ করার সময়, ইউটিলিটি ব্যবহার করা হবে aws, এবং তাই।

সার্ভারটি সেট আপ করা তেমন কঠিন ছিল না। আমি বেস ইমেজের উপর ভিত্তি করে একটি ড্রপলেট তৈরি করেছি। উল্লেখ্য যে, আমি যে সিস্টেমটি বেছে নিয়েছি তাতে একবার ম্যানুয়ালি ডকার ইনস্টল এবং একবার ম্যানুয়ালি চালু করার প্রয়োজন হয়। আমি ব্যবহার করেছি Ubuntu ১৮.০৪, সুতরাং আপনিও যদি ব্যবহার করেন Ubuntuএকই কাজ করতে, আপনি কেবল অনুসরণ করতে পারেন The সহজ গাইড।

আমি এখানে পরিষেবার জন্য নির্দিষ্ট কমান্ড সম্পর্কে কথা বলছি না, যেহেতু এই দিকটি বিভিন্ন ক্ষেত্রে ব্যাপকভাবে পরিবর্তিত হতে পারে। আমি শুধু 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== you@example.com" | base64

এবং এখানে এটি কি উত্পাদন করে - একটি বেস64 এনকোডেড স্ট্রিং:

MTIzLjQ1LjY3Ljg5IHNzaC1yc2EgQUFBQUIzTnphQzF5YzJFQUFBQUJJd0FBQVFFQWtsT1Vwa0RIcmZIWTE3U2JybVRJcE5MVEdLOVRqb20vQldEU1UKR1BsK25hZnpsSERUWVc3aGRJNHlaNWV3MThKSDRKVzlqYmhVRnJ2aVF6TTd4bEVMRVZmNGg5bEZYNVFWa2JQcHBTd2cwY2RhMwpQYnY3a09kSi9NVHlCbFdYRkNSK0hBbzNGWFJpdEJxeGlYMW5LaFhwSEFac01jaUxxOFY2UmpzTkFRd2RzZE1GdlNsVksvN1hBCnQzRmFvSm9Bc25jTTFROXg1KzNWMFd3NjgvZUlGbWIxenVVRmxqUUpLcHJyWDg4WHlwTkR2allOYnk2dncvUGIwcndlcnQvRW4KbVorQVc0T1pQblRQSTg5WlBtVk1MdWF5ckQyY0U4NlovaWw4YitndzNyMysxbkthdG1Ja2puMnNvMWQwMVFyYVRsTXFWU3NieApOclJGaTl3cmYrTTdRPT0geW91QGV4YW1wbGUuY29tCg==

এখানে উপরে উল্লিখিত কমান্ড আছে

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

সংযোগ স্থাপন করার সময় একই পদ্ধতি একটি ব্যক্তিগত কী দিয়ে ব্যবহার করা যেতে পারে, যেহেতু সার্ভার অ্যাক্সেস করার জন্য আপনার একটি ব্যক্তিগত কী প্রয়োজন হতে পারে। কী দিয়ে কাজ করার সময়, আপনাকে নিশ্চিত করতে হবে যে এটি একটি Travis CI এনভায়রনমেন্ট ভেরিয়েবলে নিরাপদে সংরক্ষণ করা হয়েছে এবং এটি কোথাও প্রদর্শিত হচ্ছে না।

আরেকটি বিষয় লক্ষণীয় যে আপনাকে একটি লাইন হিসাবে সমগ্র স্থাপনার স্ক্রিপ্ট চালানোর প্রয়োজন হতে পারে, উদাহরণস্বরূপ - এর সাথে doctl. এর জন্য কিছু অতিরিক্ত প্রচেষ্টার প্রয়োজন হতে পারে।

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

TLS/SSL এবং লোড ব্যালেন্সিং

আমি উপরে উল্লিখিত সবকিছু করার পরে, আমি যে শেষ সমস্যার সম্মুখীন হয়েছিলাম তা হল সার্ভারে SSL ছিল না। যেহেতু আমি জোর করার জন্য একটি Node.js সার্ভার ব্যবহার করি কাজ করতে রিভার্স প্রক্সি Nginx এবং আসুন এনক্রিপ্ট করি, আপনাকে অনেক টিঙ্কার করতে হবে।

আমি সত্যিই এই সমস্ত SSL কনফিগারেশন ম্যানুয়ালি করতে চাইনি, তাই আমি শুধু একটি লোড ব্যালেন্সার তৈরি করেছি এবং ডিএনএস-এ এর বিবরণ রেকর্ড করেছি। DigitalOcean-এর ক্ষেত্রে, উদাহরণস্বরূপ, লোড ব্যালেন্সারে একটি স্বয়ংক্রিয় পুনর্নবীকরণ স্ব-স্বাক্ষরিত শংসাপত্র তৈরি করা একটি সহজ, বিনামূল্যে এবং দ্রুত প্রক্রিয়া। এই পদ্ধতির অতিরিক্ত সুবিধা রয়েছে যে এটি প্রয়োজনে লোড ব্যালেন্সারের পিছনে চলমান একাধিক সার্ভারে SSL সেট আপ করা খুব সহজ করে তোলে। এটি সার্ভারগুলিকে নিজেরাই SSL সম্পর্কে "চিন্তা" করতে দেয় না, তবে একই সময়ে স্বাভাবিক হিসাবে পোর্ট ব্যবহার করে 80. তাই লোড ব্যালেন্সারে SSL সেট আপ করা SSL সেট আপ করার বিকল্প পদ্ধতির চেয়ে অনেক সহজ এবং আরও সুবিধাজনক।

এখন আপনি সার্ভারের সমস্ত পোর্ট বন্ধ করতে পারেন যা ইনকামিং সংযোগগুলি গ্রহণ করে - পোর্ট ছাড়া 80, লোড ব্যালেন্সার এবং পোর্টের সাথে যোগাযোগ করতে ব্যবহৃত হয় 22 SSH এর জন্য। ফলস্বরূপ, এই দুটি ব্যতীত অন্য কোনও পোর্টে সরাসরি সার্ভার অ্যাক্সেস করার প্রচেষ্টা ব্যর্থ হবে।

ফলাফল

আমি এই উপাদানটিতে যা যা বলেছিলাম তা করার পরে, ডকার প্ল্যাটফর্ম বা স্বয়ংক্রিয় CI/CD চেইনের ধারণাগুলি আমাকে আর ভয় দেখায়নি। আমি একটি অবিচ্ছিন্ন ইন্টিগ্রেশন চেইন সেট আপ করতে সক্ষম হয়েছি, যার সময় কোডটি উত্পাদনে যাওয়ার আগে পরীক্ষা করা হয় এবং কোডটি স্বয়ংক্রিয়ভাবে সার্ভারে স্থাপন করা হয়। এটি এখনও আমার কাছে তুলনামূলকভাবে নতুন, এবং আমি নিশ্চিত যে আমার স্বয়ংক্রিয় কর্মপ্রবাহ উন্নত করার এবং এটিকে আরও দক্ষ করার উপায় রয়েছে। তাই এই বিষয়ে আপনার কোন ধারনা থাকলে দয়া করে আমাকে জানান। আমার কাছে জানি আমি আশা করি এই নিবন্ধটি আপনার প্রচেষ্টায় আপনাকে সাহায্য করেছে। আমি বিশ্বাস করতে চাই যে এটি পড়ার পরে, আপনি আমি যতটা শিখেছি ততটাই শিখেছি যখন আমি এতে যে সমস্ত কথা বলেছি তা বের করার সময়।

দ্রষ্টব্য আমাদের মধ্যে বাজার একটি ইমেজ আছে ডকশ্রমিক, যা এক ক্লিকে ইনস্টল করা হয়। আপনি পাত্রে কাজ পরীক্ষা করতে পারেন ভিপিএস. সমস্ত নতুন গ্রাহকদের বিনামূল্যে 3 দিনের পরীক্ষা দেওয়া হয়।

প্রিয় পাঠকগণ! আপনি কি আপনার প্রকল্পে CI/CD প্রযুক্তি ব্যবহার করেন?

উত্স: www.habr.com