BuildBot এর সাথে ক্রমাগত একীকরণের একটি উদাহরণ বাস্তবায়ন

(এর দ্বারা চিত্র কম্পিউটারাইজার থেকে Pixabay)

গ্রিটিংস!

আমার নাম হল এভজেনি চেরকিন, আমি একটি মাইনিং কোম্পানিতে একটি উন্নয়ন দলের একজন প্রোগ্রামার পলিমেটাল.

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

এই নিবন্ধে আমি সম্ভাবনার একটি ওভারভিউ প্রদান করার সিদ্ধান্ত নিয়েছে বিল্ডবট. এই সফ্টওয়্যার কি সক্ষম? কিভাবে তার সাথে যোগাযোগ করবেন এবং কিভাবে তার সাথে একটি স্বাভাবিক কার্যকরী সম্পর্ক গড়ে তুলবেন? আপনি আপনার মেশিনে আপনার প্রকল্প তৈরি এবং পরীক্ষা করার জন্য একটি কাজের পরিষেবা তৈরি করে আমাদের অভিজ্ঞতা নিজেই প্রয়োগ করতে পারেন।

সন্তুষ্ট

সন্তুষ্ট

1. কেন বিল্ডবট?
2. বিল্ডমাস্টারের নেতৃত্বে ধারণা
3. ইনস্টলেশন
4. প্রথম ধাপ

5. কনফিগারেশন। ধাপে ধাপে রেসিপি

5.1 বিল্ডমাস্টার কনফিগ
5.2 শ্রমিক
5.3 পরিবর্তন_উৎস
5.4 সময়সূচী

5.5 বিল্ড ফ্যাক্টরি
5.6 জন নির্মাতা

6. আপনার নিজস্ব কনফিগারেশনের উদাহরণ

6.1 আপনার master.cfg এর পথে
6.2 svn এর সাথে কাজ করা
6.3 আপনাকে চিঠি: সাংবাদিকরা ঘোষণা করার জন্য অনুমোদিত

আমরা এটা করেছি! অভিনন্দন

1. কেন বিল্ডবট?

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

থামো! কেউ কি আসলে তাদের প্রকল্পে এটি ব্যবহার করেছে? এটা হ্যাঁ সক্রিয় আউট অনেক তাদের কাজে এটি প্রয়োগ করা হয়েছে। পাওয়া যাবে উদাহরণ использования বিল্ডবট এবং Google কোড সংরক্ষণাগারে।

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

যাদের লক্ষ্য প্রকল্পটি পাইথনে লেখা হয়েছে, তাদের জন্য প্রশ্ন উঠেছে: "কেন এমন একটি ইন্টিগ্রেশন সিস্টেম বেছে নিচ্ছেন না যেটি প্রকল্পে ব্যবহৃত ভাষার পরিপ্রেক্ষিতে একটি স্পষ্ট ইন্টারফেস আছে?" এবং এখন সুবিধাগুলি উপস্থাপন করার সময় বিল্ডবট.

সুতরাং, আমাদের "ইন্সট্রুমেন্টাল কোয়ার্টেট"। নিজের জন্য, আমি চারটি বৈশিষ্ট্য চিহ্নিত করেছি বিল্ডবট:

1. এটি জিপিএল লাইসেন্সের অধীনে একটি ওপেন সোর্স ফ্রেমওয়ার্ক
2. এটি একটি কনফিগারেশন টুল এবং প্রয়োজনীয় ক্রিয়াগুলির বিবরণ হিসাবে পাইথনের ব্যবহার
3. যে মেশিনে সমাবেশ হয় তার থেকে প্রতিক্রিয়া পাওয়ার এটি একটি সুযোগ
4. এগুলি হল, অবশেষে, একটি হোস্টের জন্য সর্বনিম্ন প্রয়োজনীয়তা। স্থাপনার জন্য পাইথন এবং টুইস্টেড প্রয়োজন, এবং ভার্চুয়াল মেশিন এবং জাভা মেশিনের প্রয়োজন নেই।

2. বিল্ডমাস্টারের নেতৃত্বে ধারণা

টাস্ক ডিস্ট্রিবিউশন আর্কিটেকচার কেন্দ্রীয় বিল্ডমাস্টার. এটি একটি পরিষেবা যা:

• ট্র্যাক রাখে প্রকল্পের উৎস গাছের পরিবর্তন
• পাঠায় প্রজেক্ট তৈরি করতে এবং এটি পরীক্ষা করার জন্য কর্মী পরিষেবা দ্বারা কার্যকর করা উচিত এমন কমান্ড
• অবহিত করে গৃহীত কর্মের ফলাফল সম্পর্কে ব্যবহারকারীদের

বিল্ডমাস্টার ফাইলের মাধ্যমে কনফিগার করা হয়েছে master.cfg. এই ফাইলটি রুটে আছে বিল্ডমাস্টার. পরে দেখাবো কিভাবে এই রুট তৈরি হয়। ফাইল নিজেই master.cfg একটি পাইথন স্ক্রিপ্ট রয়েছে যা কল ব্যবহার করে বিল্ডবট.

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

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

চেকআউট প্রকল্পের সোর্স কোড প্রতিটিতে ঘটে কর্মী-ই

3. ইনস্টলেশন

তাহলে এবার চল. আমি হোস্ট হিসাবে উবুন্টু 18.04 ব্যবহার করব। আমি এটি একটি স্থাপন করব বিল্ডমাস্টার- একটি এবং একটি কর্মী-ক কিন্তু প্রথমে আপনাকে python3.7 ইনস্টল করতে হবে:

sudo apt-get update
sudo apt-get install python3.7

যাদের 3.7.2 এর পরিবর্তে python3.7.1 প্রয়োজন, আপনি নিম্নলিখিতগুলি করতে পারেন:

sudo apt-get update
sudo apt-get software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get install python3.7
sudo ln -fs /usr/bin/python3.7 /usr/bin/python3
pip3 install --upgrade pip

পরবর্তী পদক্ষেপটি ইনস্টল করা টুইট করেছেন и বিল্ডবট, সেইসাথে প্যাকেজ যা আপনাকে অতিরিক্ত কার্যকারিতা ব্যবহার করার অনুমতি দেয় বিল্ডবট-ক

/*Все что под sudo будет установленно для всех пользователей в директорию /usr/local/lib/python3.7/dist-packages*/

#На хосте который производит мониторинг Worker-ов 
sudo pip install twisted #Библиотека twisted
sudo pip install buildbot #BuildMaster
#Дополнительный функционал
pip install pysqlite3 #Устанавливаем базу sqllite в учебных целях
pip install jinja2 #framework наподобие django, для web и для почтовых рассыллок
pip install autobahn #Web cокеты для связи BuildMaster->Worker
pip install sqlalchemy sqlalchemy-migrate #Для отображения схемы базы данных
#Для Web отображения BuildBot-a
pip install buildbot-www buildbot-grid-view buildbot-console-view buildbot-waterfall-view
pip install python-dateutil #Отображение дат в web
#На стороне хоста который непосредственно осуществляет сборку и тестирование 
pip install buildbot-worker #Worker
#Дополнительный функционал
sudo pip install virtualenv #Виртуальная среда 

4. প্রথম ধাপ

তৈরি করার সময় বিল্ডমাস্টার. এটি আমাদের ফোল্ডারে থাকবে /home/habr/master.

mkdir master
buildbot create-master master # Собственно сдесь и создаем

পরবর্তী পর্ব. আসুন তৈরি করি কর্মী. এটি আমাদের ফোল্ডারে থাকবে /home/habr/worker.

mkdir worker
buildbot-worker create-worker --umask=0o22 --keepalive=60 worker localhost:4000 yourWorkerName password

আপনি যখন দৌড়ান কর্মী, তারপর ডিফল্টরূপে এটি তৈরি হবে /home/habr/worker প্রকল্পের নামের সাথে ফোল্ডার, যা নির্দিষ্ট করা আছে master.cfg. এবং প্রোজেক্টের নামের সাথে ফোল্ডারে এটি একটি ডিরেক্টরি তৈরি করবে নির্মাণ করা, এবং তা করতে থাকবে চেকআউট. জন্য কাজ ডিরেক্টরি কর্মী-এবং এটি একটি ডিরেক্টরি হয়ে যাবে /home/habr/yourProject/build.

"সোনার চাবি
এবং এখন আমি কি জন্য পূর্ববর্তী অনুচ্ছেদ লিখেছেন: একটি স্ক্রিপ্ট যে মালিক থেকে দাবি করবে কর্মী-এবং এই ডিরেক্টরিতে দূরবর্তীভাবে সম্পন্ন করা হবে না কারণ স্ক্রিপ্টটি চালানোর অনুমতি নেই। পরিস্থিতি সংশোধন করতে, আপনার একটি কী প্রয়োজন হবে --উমাস্ক=0o22, যা এই ডিরেক্টরিতে লেখা নিষিদ্ধ করে, কিন্তু লঞ্চের অধিকার বজায় রাখবে। এবং যে সব আমরা প্রয়োজন.

বিল্ডমাস্টার и কর্মী একে অপরের সাথে একটি সংযোগ স্থাপন। এটা হয় যে এটি বন্ধ বিরতি এবং কর্মী থেকে উত্তরের জন্য কিছু সময়ের জন্য অপেক্ষা করছি বিল্ডমাস্টার-ক. যদি কোন প্রতিক্রিয়া না থাকে, সংযোগটি পুনরায় চালু করা হয়। চাবি --keepalive=60 শুধু এর পরে সময় নির্দেশ করতে হবে সংযোগ করা রিবুট

5. কনফিগারেশন। ধাপে ধাপে রেসিপি

কনফিগারেশন বিল্ডমাস্টার মেশিনের পাশে বাহিত হয় যেখানে আমরা কমান্ডটি কার্যকর করেছি সৃষ্টিকর্তা. আমাদের ক্ষেত্রে, এটি একটি ডিরেক্টরি /home/habr/master. কনফিগারেশন ফাইল master.cfg এখনও বিদ্যমান নেই, কিন্তু কমান্ড নিজেই ইতিমধ্যে ফাইল তৈরি করেছে master.cmg.sample. আপনাকে এটির নাম পরিবর্তন করতে হবে master.cfg.নমুনা в master.cfg

mv master.cfg.sample master.cfg

এর এই এক খুলুন master.cfg. এবং এর এটি গঠিত কি তাকান. এবং এর পরে, আসুন আমাদের নিজস্ব কনফিগারেশন ফাইল তৈরি করার চেষ্টা করি।

master.cfg

c['change_source'] = []
c['change_source'].append(changes.GitPoller(
    'git://github.com/buildbot/hello-world.git',
         workdir='gitpoller-workdir', branch='master',
         pollInterval=300))
                        
c['schedulers'] = []
c['schedulers'].append(schedulers.SingleBranchScheduler(
        name="all",
        change_filter=util.ChangeFilter(branch='master'),
        treeStableTimer=None,
        builderNames=["runtests"]))
c['schedulers'].append(schedulers.ForceScheduler(
        name="force",
        builderNames=["runtests"]))
                        
factory = util.BuildFactory()
                        
factory.addStep(steps.Git(repourl='git://github.com/buildbot/hello-world.git', mode='incremental'))
factory.addStep(steps.ShellCommand(command=["trial", "hello"],
                                   env={"PYTHONPATH": "."}))
                        
c['builders'] = []
c['builders'].append(
    util.BuilderConfig(name="runtests",
    workernames=["example-worker"],
    factory=factory))
                         
c['services'] = []
                        
c['title'] = "Hello World CI"
c['titleURL'] = "https://buildbot.github.io/hello-world/"
                        
                        
c['buildbotURL'] = "http://localhost:8010/"
                        
c['www'] = dict(port=8010,
                plugins=dict(waterfall_view={}, console_view={}, grid_view={}))
                        
c['db'] = {
    'db_url' : "sqlite:///state.sqlite",
}

5.1 বিল্ডমাস্টার কনফিগ

c = BuildmasterConfig = {} 

Buildmaster Config — কনফিগারেশন ফাইলের মৌলিক অভিধান। এটি কনফিগারেশন ফাইলে অন্তর্ভুক্ত করা আবশ্যক। ব্যবহারের সহজতার জন্য, কনফিগারেশন কোডে একটি উপনাম চালু করা হয়েছে "গ". নাম চাবি в c["keyFromDist"] সঙ্গে মিথস্ক্রিয়া জন্য নির্দিষ্ট উপাদান বিল্ডমাস্টার. প্রতিটি কীর জন্য, সংশ্লিষ্ট বস্তুটিকে একটি মান হিসাবে প্রতিস্থাপিত করা হয়।

5.2 শ্রমিক

c['workers'] = [worker.Worker("example-worker", "pass")]

এইবার আমরা ইঙ্গিত করি বিল্ডমাস্টার-y তালিকা কর্মী-s আমি নিজেই কর্মী আমরা তৈরি করেছি ঊর্ধ্বতন, নির্দেশ করে আপনি-কর্মী-নাম и পাসওয়ার্ড. এখন তাদের পরিবর্তে নির্দিষ্ট করা প্রয়োজন উদাহরণ-কর্মী и পাস .

5.3 পরিবর্তন_উৎস

c['change_source'] = []
c['change_source'].append(changes.GitPoller(
                            'git://github.com/buildbot/hello-world.git',
                             workdir='gitpoller-workdir', branch='master',
                             pollInterval=300))                

চাবি দ্বারা পরিবর্তন_উৎস অভিধান c আমরা সেই তালিকায় অ্যাক্সেস পাই যেখানে আমরা একটি বস্তু রাখতে চাই যা প্রজেক্টের সোর্স কোডের সাহায্যে সংগ্রহস্থলকে পোল করে। উদাহরণটি একটি গিট সংগ্রহস্থল ব্যবহার করে যা নির্দিষ্ট বিরতিতে পোল করা হয়।

প্রথম যুক্তি হল আপনার সংগ্রহস্থলের পথ।

workdir পাশের ফোল্ডারের পাথ প্রতিনিধিত্ব করে কর্মী-পথের আপেক্ষিক /home/habr/worker/yourProject/build git সংগ্রহস্থলের স্থানীয় সংস্করণ সংরক্ষণ করবে।

শাখা সংগ্রহস্থলে একটি নির্দিষ্ট শাখা রয়েছে যা অনুসরণ করা উচিত।

pollInterval এর পরে সেকেন্ডের সংখ্যা রয়েছে বিল্ডমাস্টার পরিবর্তনের জন্য সংগ্রহস্থল পোল করা হবে.

একটি প্রকল্পের সংগ্রহস্থল পরিবর্তন ট্র্যাক করার জন্য বিভিন্ন পদ্ধতি আছে.

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

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

5.4 সময়সূচী

c['schedulers'] = []
c['schedulers'].append(schedulers.SingleBranchScheduler(
        name="all",
        change_filter=util.ChangeFilter(branch='master'),
        treeStableTimer=None,
        builderNames=["runtests"]))
c['schedulers'].append(schedulers.ForceScheduler(
        name="force",
        builderNames=["runtests"]))

সময়সূচী - এটি এমন একটি উপাদান যা একটি ট্রিগার হিসাবে কাজ করে যা প্রকল্পের সমাবেশ এবং পরীক্ষার সম্পূর্ণ চেইন শুরু করে।


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

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

ফোর্স শিডিউলার একটি খুব সহজ জিনিস। এই ধরনের সময়সূচী একটি মাউস ক্লিক মাধ্যমে ট্রিগার হয় বিল্ডবট-ওয়েব ইন্টারফেস. পরামিতিগুলির মধ্যে একই সারাংশ রয়েছে একক শাখার সময়সূচী.

পিএস নং 3। হয়তো কাজে আসবে
পর্যাবৃত্ত একটি সময়সূচী যা একটি নির্দিষ্ট সময়-নির্দিষ্ট ফ্রিকোয়েন্সিতে চলে। কল এই মত কিছু দেখায়

from buildbot.plugins import schedulers
nightly = schedulers.Periodic(name="daily",
                              builderNames=["full-solaris"],
                              periodicBuildTimer=24*60*60)
c['schedulers'] = [nightly]                    

5.5 বিল্ড ফ্যাক্টরি

factory = util.BuildFactory()
                        
factory.addStep(steps.Git(repourl='git://github.com/buildbot/hello-world.git', mode='incremental'))
factory.addStep(steps.ShellCommand(command=["trial", "hello"],
                                   env={"PYTHONPATH": "."}))

পর্যায়ক্রমিক বিল্ড টাইমার সেকেন্ডে এই পর্যায়ক্রমের সময় নির্দিষ্ট করে।

বিল্ড ফ্যাক্টরি একটি নির্দিষ্ট তৈরি করে নির্মাণ করা, তারপর কি নির্মাতা পাঠায় কর্মী। দ্য বিল্ড ফ্যাক্টরি অনুসরণ করা পদক্ষেপ নির্দেশ করে কর্মী-y পদ্ধতি কল করে ধাপ যোগ করা হয় ধাপ যোগ করুন

এই উদাহরণে প্রথম যোগ করা ধাপ হল git পরিষ্কার -d -f -f -xতারপর, গিট চেকআউট. এই ক্রিয়াগুলি পরামিতিতে অন্তর্ভুক্ত করা হয়েছে পদ্ধতি, যা স্পষ্টভাবে বলা হয়নি কিন্তু একটি ডিফল্ট মান বোঝায় তাজা. প্যারামিটার মোড = 'ক্রমবর্ধমান' নির্দেশ করে যে ফাইলগুলি ডিরেক্টরি থেকে এসেছে যেখানে চেচআউট, ভান্ডার থেকে অনুপস্থিত, অস্পৃশ্য থাকা.

দ্বিতীয় যোগ করা ধাপ স্ক্রিপ্ট কল করা হয় পরীক্ষা প্যারামিটার সহ হ্যালো পাশে কর্মী- একটি ডিরেক্টরি থেকে /home/habr/worker/yourProject/build পরিবেশ পরিবর্তনশীল PATHONPATH=... এইভাবে, আপনি নিজের স্ক্রিপ্ট লিখতে পারেন এবং সেগুলিকে পাশে চালাতে পারেন কর্মী- একটি প্রতিটি পদক্ষেপ util.ShellCommand. এই স্ক্রিপ্টগুলি সরাসরি সংগ্রহস্থলে স্থাপন করা যেতে পারে। তারপর এ চেচআউট- তারা পড়ে যাবে /home/habr/worker/yourProject/build. যাইহোক, তারপর দুটি "কিন্তু" আছে:

1. কর্মী একটি কী দিয়ে তৈরি করতে হবে --উমাস্ক যাতে এটি পরে মৃত্যুদন্ড কার্যকর করার অধিকার অবরুদ্ধ না করে চেকআউট-ক
2. এ গিট ধাক্কা-ই এই স্ক্রিপ্টগুলির মধ্যে আপনাকে সম্পত্তি নির্দিষ্ট করতে হবে নির্বাহযোগ্যযাতে পরে চেচআউট-e গিট স্ক্রিপ্ট চালানোর অধিকার হারায়নি।

5.6 জন নির্মাতা

c['builders'] = []
c['builders'].append(util.BuilderConfig(name="runtests",
                                        workernames=["example-worker"],
                                        factory=factory))

কি সম্পর্কে নির্মাতা বলা হয় এখানে. এখন আমি আপনাকে এটি কীভাবে তৈরি করতে হয় সে সম্পর্কে আরও বিশদে বলব। বিল্ডার কনফিগ একজন কনস্ট্রাক্টর নির্মাতা. মধ্যে যেমন ডিজাইনার গ['নির্মাতাদের'] আপনি বেশ কয়েকটি নির্দিষ্ট করতে পারেন, যেহেতু এটি বস্তুর একটি শীট নির্মাতা প্রকার এখন থেকে উদাহরণ পুনর্লিখন করা যাক বিল্ডবট, এটা আমাদের টাস্ক কাছাকাছি আনা.

c['builders'] = []
c['builders'].append(util.BuilderConfig(name="yourProject",
                                            workernames=["yourWorkerName"],
                                            factory=factory))

এখন আমি আপনাকে প্যারামিটার সম্পর্কে বলব বিল্ডার কনফিগ.

নাম নাম নির্দিষ্ট করে নির্মাতা-ক এখানে আমরা নাম দিয়েছি আপনার প্রকল্প... এই যে মানে কর্মী- এই পথ তৈরি করা হবে /home/habr/worker/yourProject/build. শেডুলার খুঁজছি নির্মাতা শুধু এই নামে।

কর্মীর নাম শীট রয়েছে কর্মী-s যার প্রতিটি যোগ করতে হবে গ['শ্রমিক'].

কারখানা - নির্দিষ্ট নির্মাণ করা, যার সাথে এটি যুক্ত নির্মাতা. তিনি বস্তু পাঠাবেন নির্মাণ করা উপর কর্মী এই অন্তর্ভুক্ত সমস্ত পদক্ষেপ সম্পূর্ণ করতে নির্মাণ করা-ক

6. আপনার নিজস্ব কনফিগারেশনের উদাহরণ

এখানে উদাহরণ প্রকল্প আর্কিটেকচার যা আমি এর মাধ্যমে বাস্তবায়নের প্রস্তাব করছি বিল্ডবট
.

আমরা একটি সংস্করণ নিয়ন্ত্রণ সিস্টেম হিসাবে ব্যবহার করব SVN. ভান্ডারটি নিজেই এক ধরণের মেঘে অবস্থিত হবে। এই মেঘের ঠিকানা svn.host/svn/yourProject/trunk. মেঘের নিচে SVN একটি অ্যাকাউন্ট ব্যবহারকারীর নাম আছে: ব্যবহারকারী, passwd: পাসওয়ার্ড. স্ক্রিপ্ট যে ধাপগুলি প্রতিনিধিত্ব করে নির্মাণ করা-এও শাখায় থাকবে SVN, একটি পৃথক ফোল্ডারে buildbot/worker_linux. এই স্ক্রিপ্টগুলি সংরক্ষিত সম্পত্তির সাথে সংগ্রহস্থলে অবস্থিত এক্সিকিউটেবল.

বিল্ডমাস্টার и কর্মী একই হোস্টে চালান প্রকল্প.হোস্ট .বিল্ডমাস্টার একটি ফোল্ডারে এর ফাইল সংরক্ষণ করে /home/habr/master. কর্মী এটি নিম্নলিখিত পথে সংরক্ষিত হয় /home/habr/worker. যোগাযোগ প্রক্রিয়া বিল্ডমাস্টার-ক এবং কর্মী-a প্রোটোকল অনুযায়ী পোর্ট 4000 এর মাধ্যমে বাহিত হয় বিল্ডবট-এ, যে 'পিবি' প্রোটোকল

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

ওয়েব প্রদর্শন বিল্ডবট আমরা পোর্ট 80 এর সাথে সংযোগ করব প্রকল্প.হোস্ট. Apatch ইনস্টল করার প্রয়োজন নেই। গ্রন্থাগারের অংশ হিসেবে পাকান ইতিমধ্যে একটি ওয়েব সার্ভার আছে, বিল্ডবট এটা ব্যবহার করে

জন্য অভ্যন্তরীণ তথ্য সংরক্ষণ করতে বিল্ডবট আমরা ব্যবহার করবো স্ক্লাইট.

মেল করার জন্য একটি হোস্ট প্রয়োজন smtp.your.domain - এটি মেইল ​​থেকে চিঠি পাঠানোর অনুমতি দেয় [ইমেল সুরক্ষিত] প্রমাণীকরণ ছাড়া। এছাড়াও হোস্টে'SMTP ' মিনিট ১০২৫ পোস্টে শুনানি হচ্ছে।

প্রক্রিয়ায় জড়িত দুই ব্যক্তি আছে: অ্যাডমিন и ব্যবহারকারী. প্রশাসক প্রশাসক বিল্ডবট. ব্যবহারকারী প্রতিশ্রুতিশীল ব্যক্তি সমর্পণ করা-s

এক্সিকিউটেবল ফাইলের মাধ্যমে তৈরি করা হয় পাইইনস্টলার. ডকুমেন্টেশন মাধ্যমে তৈরি করা হয় ডক্সিজেন.

এই স্থাপত্যের জন্য আমি এটি লিখেছি: master.cfg:

master.cfg

import os, re
from buildbot.plugins import steps, util, schedulers, worker, changes, reporters

c= BuildmasterConfig ={}

c['workers'] = [ worker.Worker('yourWorkerName', 'password') ]
c['protocols'] = {'pb': {'port': 4000}} 


svn_poller = changes.SVNPoller(repourl="https://svn.host/svn/yourProject/trunk",
                                svnuser="user",
                                svnpasswd="password",
                                pollinterval=60,
				split_file=util.svn.split_file_alwaystrunk
                                )

c['change_source'] =  svn_poller

hourlyscheduler = schedulers.SingleBranchScheduler(
                                name="your-project-schedulers",
				change_filter=util.ChangeFilter(branch=None),
                                builderNames=["yourProject"],
				properties = {'owner': 'admin'}
                                )

c['schedulers'] = [hourlyscheduler]

checkout = steps.SVN(repourl='https://svn.host/svn/yourProject/trunk',
                        mode='full',
                        method='fresh',
                        username="user",
                        password="password",
                        haltOnFailure=True)

	
projectHost_build = util.BuildFactory()  


cleanProject = steps.ShellCommand(name="Clean",
                 command=["buildbot/worker_linux/pyinstaller_project", "clean"]
                                )
buildProject = steps.ShellCommand(name="Build",
                 command=["buildbot/worker_linux/pyinstaller_project", "build"]
                                )
doxyProject = steps.ShellCommand(name="Update Docs",
                                command=["buildbot/worker_linux/gendoc", []]
                                )
testProject = steps.ShellCommand(name="Tests",
                                command=["python","tests/utest.py"],
                                env={'PYTHONPATH': '.'}
                                )

projectHost_build.addStep(checkout)
projectHost_build.addStep(cleanProject)
projectHost_build.addStep(buildProject)
projectHost_build.addStep(doxyProject)
projectHost_build.addStep(testProject)


c['builders'] = [
        util.BuilderConfig(name="yourProject", workername='yourWorkerName', factory=projectHost_build)
]


template_html=u'''
<h4>Статус построенного релиза: {{ summary }}</h4>
<p>Используемый сервис для постраения: {{ workername }}</p>
<p>Проект: {{ projects }}</p>
<p>Для того что бы посмотреть интерфейс управления пройдите по ссылке: {{ buildbot_url }}</p>
<p>Для того что бы посмотреть результат сборки пройдите по ссылке: {{ build_url }}</p>
<p>Используя WinSCP можно подключиться к серверу c ip:xxx.xx.xxx.xx. Войдя под habr/password, забрать собранный executable файл с директории ~/worker/yourProject/build/dist.</p>
<p><b>Построение было произведено через Buildbot</b></p>
'''

sendMessageToAll = reporters.MailNotifier(fromaddr="[email protected]",
					sendToInterestedUsers=True,
					lookup="your.domain",
					relayhost="smtp.your.domain",
					smtpPort=1025,
					mode="warnings",
					extraRecipients=['[email protected]'],
              messageFormatter=reporters.MessageFormatter(
						template=template_html,
						template_type='html',
						wantProperties=True, 
                                                wantSteps=True)
					)
c['services'] = [sendMessageToAll]

c['title'] = "The process of bulding"
c['titleURL'] = "http://project.host:80/"

c['buildbotURL'] = "http://project.host"

c['www'] = dict(port=80,
                plugins=dict(waterfall_view={}, console_view={}, grid_view={}))


c['db'] = {
    'db_url' : "sqlite:///state.sqlite"
}

প্রথম আপনার প্রয়োজন তৈরি বিল্ডমাস্টার-ক এবং কর্মী-ক তারপর এই ফাইলটি পেস্ট করুন master.cfg в /home/habr/master.

পরবর্তী ধাপ হল পরিষেবা শুরু করা বিল্ডমাস্টারগুলি

sudo buildbot start /home/habr/master

তারপর পরিষেবা শুরু করুন কর্মী-a

buildbot-worker start /home/habr/worker

প্রস্তুত! এখন বিল্ডবট পরিবর্তনগুলি ট্র্যাক করবে এবং ট্রিগার করবে সমর্পণ করা-y মধ্যে SVN, উপরের আর্কিটেকচারের সাথে একটি প্রকল্প নির্মাণ এবং পরীক্ষা করার ধাপগুলি সম্পাদন করা।

নিচে আমি উপরের কিছু বৈশিষ্ট্য বর্ণনা করব master.cfg.

6.1 আপনার master.cfg এর পথে

লেখার সময় আমার master.cfg অনেক ত্রুটি করা হবে, তাই লগ ফাইল পড়া প্রয়োজন হবে. এটি হিসাবে সংরক্ষণ করা হয় বিল্ডমাস্টার-ইসি পরম পথ /home/habr/master/twistd.log, এবং পাশে কর্মী-একটি পরম পথ সহ /home/habr/worker/twistd.log. আপনি ত্রুটিটি পড়া এবং এটি ঠিক করার সাথে সাথে আপনাকে পরিষেবাটি পুনরায় চালু করতে হবে বিল্ডমাস্টার-ক এটি কীভাবে করা হয়েছে তা এখানে:

sudo buildbot stop /home/habr/master
sudo buildbot upgrade-master /home/habr/master
sudo buildbot start /home/habr/master

6.2 svn এর সাথে কাজ করা

svn_poller = changes.SVNPoller(repourl="https://svn.host/svn/yourProject/trunk",
                               svnuser="user",
                               svnpasswd="password",
                               pollinterval=60,
                               split_file=util.svn.split_file_alwaystrunk
                        )

c['change_source'] =  svn_poller

hourlyscheduler = schedulers.SingleBranchScheduler(
                            name="your-project-schedulers",
                            change_filter=util.ChangeFilter(branch=None),
                            builderNames=["yourProject"],
                            properties = {'owner': 'admin'}
                        )

c['schedulers'] = [hourlyscheduler]

checkout = steps.SVN(repourl='https://svn.host/svn/yourProject/trunk',
                     mode='full',
                     method='fresh',
                     username="user",
                     password="password",
                     haltOnFailure=True)

শুরু করার জন্য, এর একটি কটাক্ষপাত করা যাক svn_poller. এটি এখনও একই ইন্টারফেস, নিয়মিতভাবে প্রতি মিনিটে একবার সংগ্রহস্থলে ভোট দেয়। এক্ষেত্রে svn_poller শুধুমাত্র শাখায় প্রবেশ করে ট্রাঙ্ক. রহস্যময় প্যারামিটার split_file=util.svn.split_file_alwaystruunk নিয়মগুলি সেট করে: ফোল্ডার কাঠামোটি কীভাবে ভাঙ্গা যায় SVN শাখায় তিনি তাদের আপেক্ষিক পথও অফার করেন। তার পালা split_file_alwaystruk রিপোজিটরি শুধুমাত্র ধারণ করে বলে প্রক্রিয়াটিকে সহজ করে ট্রাঙ্ক.

В সময়সূচী জ্ঞাপিত ফিল্টার পরিবর্তন করুনযারা দেখে না এবং এর সাথে একটি শাখা যুক্ত করে ট্রাঙ্ক মাধ্যমে একটি প্রদত্ত সমিতি অনুযায়ী split_file_alwaystruk. মধ্যে পরিবর্তন সাড়া ট্রাঙ্ক, লঞ্চ করে নির্মাতা নামের সাথে আপনার প্রকল্প.

বৈশিষ্ট্য এখানে এটি প্রয়োজন যাতে প্রশাসক প্রক্রিয়াটির মালিক হিসাবে বিল্ড এবং পরীক্ষার ফলাফলের মেলিং তালিকা গ্রহণ করেন।

ধাপ নির্মাণ করা-a চেকআউট সংগ্রহস্থলের স্থানীয় সংস্করণে অবস্থিত কোনো ফাইল সম্পূর্ণরূপে মুছে ফেলতে সক্ষম কর্মী-ক. এবং তারপর সম্পূর্ণ করুন svn আপডেট. মোডটি প্যারামিটারের মাধ্যমে কনফিগার করা হয়েছে মোড = পূর্ণ, পদ্ধতি=তাজা. প্যারামিটার haltOnTailure বলেন যে যদি svn আপডেট একটি ত্রুটির সাথে মৃত্যুদন্ড কার্যকর করা হবে, তারপর নির্মাণ এবং পরীক্ষার পুরো প্রক্রিয়াটি স্থগিত করা উচিত, যেহেতু পরবর্তী পদক্ষেপগুলি অর্থহীন।

6.3 আপনাকে চিঠি: সাংবাদিকরা ঘোষণা করার জন্য অনুমোদিত

সাংবাদিকদের ইমেলের মাধ্যমে বিজ্ঞপ্তি পাঠানোর জন্য একটি পরিষেবা।

template_html=u'''
<h4>Статус построенного релиза: {{ summary }}</h4>
<p>Используемый сервис для постраения: {{ workername }}</p>
<p>Проект: {{ projects }}</p>
<p>Для того что бы посмотреть интерфейс управления пройдите по ссылке: {{ buildbot_url }}</p>
<p>Для того что бы посмотреть результат сборки пройдите по ссылке: {{ build_url }}</p>
<p>Используя WinSCP можно подключиться к серверу c ip:xxx.xx.xxx.xx. Войдя под habr/password, забрать собранный executable файл с директории ~/worker/yourProject/build/dist.</p>
<p><b>Построение было произведено через Buildbot</b></p>
'''
                        
sendMessageToAll = reporters.MailNotifier(fromaddr="[email protected]",
                                          sendToInterestedUsers=True,
                                          lookup="your.domain",
                                          relayhost="smtp.your.domain",
                                          smtpPort=1025,
                                          mode="warnings",
                                          extraRecipients=['[email protected]'],
                                    messageFormatter=reporters.MessageFormatter(
                                                    template=template_html,
                                                    template_type='html',
                                                    wantProperties=True, 
                                                    wantSteps=True)
                                        )
c['services'] = [sendMessageToAll]

তিনি বার্তা পাঠাতে পারেন ভিন্ন পথ.

মেইল নোটিফায়ার বিজ্ঞপ্তি পাঠাতে ইমেল ব্যবহার করে।

template_html নিউজলেটারের জন্য টেক্সট টেমপ্লেট সেট করে। মার্কআপ তৈরি করতে HTML ব্যবহার করা হয়। এটি ইঞ্জিন দ্বারা পরিবর্তিত হয় জিঞ্জা২ (এর সাথে তুলনা করা যেতে পারে জ্যাঙ্গো). বিল্ডবট ভেরিয়েবলের একটি সেট রয়েছে যার মানগুলি বার্তা পাঠ্য তৈরি করার প্রক্রিয়া চলাকালীন টেমপ্লেটে প্রতিস্থাপিত হয়। এই ভেরিয়েবলগুলি {{ ডবল কোঁকড়া বন্ধনী }} এ আবদ্ধ। উদাহরণ স্বরূপ, সংক্ষিপ্ত সম্পূর্ণ অপারেশনের স্থিতি প্রদর্শন করে, অর্থাৎ সাফল্য বা ব্যর্থতা। ক প্রকল্প আউটপুট হবে আপনার প্রকল্প. সুতরাং, নিয়ন্ত্রণ কমান্ড ব্যবহার করে জিঞ্জা২, ভেরিয়েবল বিল্ডবট-a এবং পাইথন স্ট্রিং ফরম্যাটিং টুল, আপনি একটি বেশ তথ্যপূর্ণ বার্তা তৈরি করতে পারেন।

মেইল নোটিফায়ার নিম্নলিখিত আর্গুমেন্ট রয়েছে.

addr থেকে – যে ঠিকানা থেকে সবাই নিউজলেটার পাবে।

আগ্রহী ব্যবহারকারীদের পাঠান=True তৈরি করা মালিক এবং ব্যবহারকারীকে একটি বার্তা পাঠায় সমর্পণ করা.

খুঁজে দেখো — একটি প্রত্যয় যা নিউজলেটার গ্রহণকারী ব্যবহারকারীদের নামের সাথে যোগ করতে হবে। তাই অ্যাডমিন ব্যবহারকারী কিভাবে ঠিকানায় নিউজলেটার পাবেন [ইমেল সুরক্ষিত].

রিলেহোস্ট যে হোস্টনেমটি সার্ভার খোলা হয়েছে তা নির্দিষ্ট করে SMTP, একটি smptPort শোনার পোর্ট নম্বর নির্দিষ্ট করে SMTP সার্ভার

মোড="সতর্কতা" বলেছেন যে মেইলিং শুধুমাত্র করা উচিত যদি কমপক্ষে একটি ধাপ থাকে নির্মাণ করা-a, যা স্ট্যাটাস ব্যর্থতা বা সতর্কতার সাথে শেষ হয়েছে। সাফল্যের ক্ষেত্রে, একটি নিউজলেটার পাঠানোর প্রয়োজন নেই।

অতিরিক্ত প্রাপক মালিক এবং যিনি এই কাজটি করেছেন তার পাশাপাশি যাদের কাছে মেইলিং পাঠানো উচিত তাদের একটি তালিকা রয়েছে সমর্পণ করা.

বার্তা ফরম্যাটার একটি অবজেক্ট যা বার্তা বিন্যাস, এর টেমপ্লেট এবং এর থেকে উপলব্ধ ভেরিয়েবলের একটি সেট নির্দিষ্ট করে জিঞ্জা২. যেমন বিকল্প wantProperties=সত্য и চাই স্টেপস=সত্য উপলব্ধ ভেরিয়েবলের এই সেটটি সংজ্ঞায়িত করুন।

সঙ্গে['services']=[sendMessageToAll] পরিষেবাগুলির একটি তালিকা প্রদান করে, যার মধ্যে আমাদের হবে৷ সংবাদদাতা.

আমরা এটা করেছি! অভিনন্দন

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

এবং আরও। আমি পেশাদার সম্প্রদায় ব্যবহার করতে চাই বিল্ডবট, আরও বিস্তৃত হয়েছে, ম্যানুয়ালগুলি অনুবাদ করা হয়েছে, এবং আরও উদাহরণ রয়েছে।

আপনার মনোযোগের জন্য আপনাকে ধন্যবাদ. শুভকামনা।

উত্স: www.habr.com