😧 🕺🏻 🌑 बिल्डबोट का उपयोग करके निरंतर एकीकरण कार्यान्वयन उदाहरण 😣 👨‍✈️ 🤚🏼

( पिक्साबे से कंप्यूटराइज़र द्वारा छवि )

नमस्ते!

मेरा नाम इवगेनी चेरकिन है , मैं खनन कंपनी पॉलीमेटल में विकास टीम का प्रोग्रामर हूं।

किसी भी बड़ी परियोजना को शुरू करते समय, आप सोचना शुरू करते हैं: "इसके रखरखाव के लिए कौन सा सॉफ्टवेयर बेहतर है?"। अगले संस्करण की रिलीज से पहले एक आईटी परियोजना कई चरणों की श्रृंखला से गुजरती है। यह अच्छा है जब इन चरणों की श्रृंखला स्वचालित है। आईटी परियोजना के नए संस्करण को जारी करने की स्वचालित प्रक्रिया को कंटीन्यूअस इंटीग्रेशन कहा जाता है। बिल्डबॉट इस प्रक्रिया को लागू करने के लिए हमारे लिए एक अच्छा सहायक बन गया।

इस लेख में, मैंने बिल्डबॉट की विशेषताओं का अवलोकन प्रदान करने का निर्णय लिया। यह सॉफ्टवेयर किसमें सक्षम है? उसके साथ कैसे संपर्क करें और उसके साथ एक सामान्य प्रभावी काम के संबंध कैसे बनाएं? आप अपने प्रोजेक्ट को असेंबल करने और परीक्षण करने के लिए अपनी मशीन पर काम करके अपने अनुभव को खुद पर भी लागू कर सकते हैं।

सामग्री

सामग्री
1. बिल्डबॉट क्यों है?	2. बिल्डमास्टर के नेतृत्व में अवधारणा	3. स्थापना	4. पहला कदम
5. विन्यास। स्टेप बाय स्टेप रेसिपी
5.1 बिल्डमास्टरऑनफिग	5.2 कार्यकर्ता	5.3 परिवर्तन_ स्रोत	5.4 शेड्यूलर
5.5 बिल्डफैक्ट		5.6 बिल्डरों
6. स्वयं के विन्यास का उदाहरण
6.1 अपने मास्टर के रास्ते पर	6.2 svn के साथ काम करें	6.3 आपके लिए एक पत्र: पत्रकारों को घोषित करने के लिए अधिकृत है
हमने कर दिखाया! मेरी बधाई

1. बिल्डबॉट क्यों है?

इससे पहले हब्र-ई पर, मैं बिल्डबोट का उपयोग करके निरंतर एकीकरण को लागू करने के लेख पर आया था। उदाहरण के लिए, यह मुझे सबसे अधिक जानकारीपूर्ण लग रहा था। एक और उदाहरण है - सरल । इन लेखों को मैनुअल से एक उदाहरण के साथ सीज़न किया जा सकता है, और यह अंग्रेजी में है। कूप एक अच्छा प्रारंभिक बिंदु है। इन लेखों को पढ़ने के बाद, आप शायद BuildBot पर तुरंत कुछ करना चाहेंगे।

इसे रोको! क्या किसी ने भी अपनी परियोजनाओं में इसका इस्तेमाल किया? यह पता चला है, कई ने इसे अपने कार्यों में लागू किया है। आप Google कोड अभिलेखागार में बिल्डबॉट का उपयोग करने के उदाहरण पा सकते हैं।

तो बिल्डबोट का उपयोग करने वाले लोगों का तर्क क्या है? आखिरकार, अन्य उपकरण हैं: क्रूज़कंट्रोल और जेनकिंस । मैं इस तरह जवाब दूंगा। अधिकांश कार्यों के लिए, जेनकिंस वास्तव में पर्याप्त होगा। बिल्डबोट , बदले में, अधिक अनुकूली है, और वहां के कार्यों को जेनकिंस में आसानी से हल किया जाता है। आप चुनें। लेकिन जब से हम एक विकासशील लक्ष्य परियोजना के लिए एक उपकरण की तलाश कर रहे हैं, तो क्यों न एक ऐसा विकल्प चुनें जो हमें सरल चरणों से शुरू हो, एक निर्माण प्रणाली प्राप्त करने के लिए, जिसमें अन्तरक्रियाशीलता और एक अद्वितीय इंटरफ़ेस हो।

उन लोगों के लिए जिनकी लक्ष्य परियोजना अजगर में लिखी गई है, सवाल उठता है: "क्यों नहीं एक एकीकरण प्रणाली का चयन किया जाए, जिसका परियोजना में उपयोग की जाने वाली भाषा के संदर्भ में एक स्पष्ट इंटरफ़ेस है?"। और फिर बिल्डबॉट के लाभों को पेश करने का समय आ गया है।

तो, हमारे "वाद्य चौकड़ी"। अपने लिए, मैंने बिल्डबॉट की चार विशेषताओं को परिभाषित किया:
यह जीपीएल के तहत एक खुला स्रोत ढांचा है
यह एक विन्यास उपकरण के रूप में अजगर का उपयोग कर रहा है और आवश्यक क्रियाओं का वर्णन कर रहा है।
यह उस मशीन से प्रतिक्रिया प्राप्त करने का एक अवसर है जिस पर विधानसभा होती है।
ये आखिरकार मेजबान के लिए न्यूनतम आवश्यकताएं हैं। तैनाती के लिए अजगर और मुड़ की आवश्यकता होती है, और किसी वर्चुअल मशीन या जावा मशीन की आवश्यकता नहीं होती है।

2. बिल्डमास्टर के नेतृत्व में अवधारणा

कार्य वितरण वास्तुकला का केंद्र बिल्डमास्टर है । यह एक सेवा है:

प्रोजेक्ट स्रोत ट्री में परिवर्तन ट्रैक करता है
कमांड्स भेजता है कि किसी प्रोजेक्ट को बनाने के लिए वर्कर सर्विस को निष्पादित करना चाहिए और उसका परीक्षण करना चाहिए
किए गए कार्यों के परिणामों के उपयोगकर्ताओं को सूचित करता है

BuildMaster मास्टर.cfg फ़ाइल के माध्यम से कॉन्फ़िगर किया गया है। यह फ़ाइल BuildMaster की जड़ में है। बाद में मैं दिखाऊंगा कि यह जड़ कैसे बनाई जाती है। Master.cfg फ़ाइल में python होता है, जिसमें एक स्क्रिप्ट BuildBot कॉल का उपयोग करती है।

अगला सबसे महत्वपूर्ण बिल्डबॉट को कार्यकर्ता कहा जाता है। यह सेवा एक अलग ओएस के साथ एक अलग होस्ट पर चलाई जा सकती है, या शायद जहां BuildMaster है । यह अपने स्वयं के पैकेज और चर के साथ विशेष रूप से तैयार आभासी वातावरण में भी मौजूद हो सकता है। इन आभासी वातावरणों को पायथुनेव, वेनव जैसे अजगर उपयोगिताओं के साथ तैयार किया जा सकता है।

बिल्डमास्टर प्रत्येक कार्यकर्ता को कमांड प्रसारित करता है, जो बदले में, उन्हें निष्पादित करता है। यही है, यह पता चला है कि परियोजना के निर्माण और परीक्षण की प्रक्रिया विंडोज के तहत और किसी अन्य कार्यकर्ता पर लिनक्स के तहत श्रमिक के पास जा सकती है।

प्रोजेक्ट वर्कर कोड का चेकआउट हर वर्कर पर होता है।

3. स्थापना

तो चलिए चलते हैं। मैं मेजबान के रूप में Ubuntu 18.04 का उपयोग करूंगा। इस पर मैं एक BuildMaster -a और एक Worker -a रखूँगा । लेकिन पहले आपको python3.7 स्थापित करने की आवश्यकता होगी:

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

उन लोगों के लिए जिन्हें 3.7.1 के बजाय python3.7.2 की आवश्यकता है, आप निम्नलिखित कार्य कर सकते हैं:

 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. पहला कदम

एक बिल्डमास्टर बनाने का समय। हमारे पास यह फ़ोल्डर / होम / हैबर / मास्टर में होगा ।

 mkdir master buildbot create-master master #

अगला कदम। एक कार्यकर्ता बनाएँ। हम इसे फोल्डर / होम / हैबर / वर्कर में रखेंगे ।

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

जब आप वर्कर शुरू करते हैं, तो डिफ़ॉल्ट रूप से यह प्रोजेक्ट के नाम के साथ / home / habr / कार्यकर्ता में एक फ़ोल्डर बनाएगा, जो मास्टर.कॉफ में निर्दिष्ट है। और परियोजना के नाम के साथ फ़ोल्डर में, वह बिल्ड डायरेक्टरी बनाएगा, और फिर इसमें चेकआउट किया जाएगा। वर्कर के लिए वर्किंग डायरेक्टरी डायरेक्टरी / होम / हैब्र / yourProject / build होगी ।

गोल्डन की
और अब मैंने पिछले पैराग्राफ के लिए जो लिखा है: स्क्रिप्ट जिसे मास्टर को वर्कर को दूरस्थ रूप से इस निर्देशिका में करने की आवश्यकता होगी, उसे निष्पादित नहीं किया जाएगा, क्योंकि स्क्रिप्ट को चलाने की अनुमति नहीं है। स्थिति को ठीक करने के लिए, आपको एक कुंजी की आवश्यकता है --umask = 0o22 , जो इस निर्देशिका को लिखने पर प्रतिबंध लगाता है, लेकिन स्टार्टअप अधिकार छोड़ देता है। और हमें केवल यही चाहिए।

बिल्डमास्टर और वर्कर आपस में संबंध स्थापित करते हैं। ऐसा होता है कि यह टूट जाता है और वर्कर कुछ समय के लिए बिल्डमास्टर की प्रतिक्रिया का इंतजार करता है। यदि कोई प्रतिक्रिया नहीं मिलती है, तो कनेक्शन को फिर से शुरू किया जाता है। कुंजी - शासनात्मक = 60 बस वह है जो आपको उस समय को इंगित करने की आवश्यकता है जिसके बाद रिबूट कनेक्ट होते हैं ।

5. विन्यास। स्टेप बाय स्टेप रेसिपी

बिल्डमास्टर कॉन्फ़िगरेशन मशीन की तरफ से किया जाता है, जहां हमने create-master कमांड चलाया। हमारे मामले में, यह निर्देशिका / घर / हैबर / मास्टर है । Master.cfg कॉन्फ़िगरेशन फ़ाइल अभी तक मौजूद नहीं है, लेकिन कमांड ने पहले ही Master.cmg.sample फ़ाइल बना ली है। आपको इसका नाम बदलकर Master.cfg.sample में master.cfg करने की आवश्यकता है

 mv master.cfg.sample 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.imtqy.com/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 = {}

BuildmasterConfig - कॉन्फ़िगरेशन फ़ाइल का मूल शब्दकोश। यह कॉन्फ़िगरेशन फ़ाइल में शामिल होना चाहिए। उपयोग में आसानी के लिए, इसका उपनाम "c" कॉन्फ़िगरेशन कोड में दर्ज किया गया है। सी में मुख्य नाम ["keyFromDist" BuildMaster के साथ बातचीत करने के लिए निश्चित तत्व हैं। प्रत्येक कुंजी के तहत, संबंधित वस्तु को एक मूल्य के रूप में प्रतिस्थापित किया जाता है।

5.2 कार्यकर्ता

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

इस बार हम वर्कर्स की बिल्डमास्टर सूची को इंगित करते हैं। हमने आपको-कार्यकर्ता-नाम और पासवर्ड निर्दिष्ट करके ऊपर वर्कर बनाया है। अब उन्हें उदाहरण-कार्यकर्ता और पास के बजाय निर्दिष्ट किया जाना चाहिए।

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))

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

पहला तर्क आपके भंडार का मार्ग है।

कार्यदिवस उस फ़ोल्डर का पथ है जहाँ पर कार्यकर्ता के पथ पर, पथ / घर / हैबर / कार्यकर्ता / yourProject / build के सापेक्ष, git रिपॉजिटरी के स्थानीय संस्करण को संग्रहीत करेगा।

शाखा में रिपॉजिटरी में एक विशिष्ट शाखा होती है जिसकी निगरानी की जानी चाहिए।

पोलइंटरवल में सेकंड की संख्या होती है जिसके बाद बिल्डमास्टर परिवर्तनों के लिए भंडार का सर्वेक्षण करेगा।

प्रोजेक्ट रिपॉजिटरी में बदलाव को ट्रैक करने के कई तरीके हैं।

सबसे आसान तरीका मतदान है , जिसका अर्थ है कि BuildMaster समय-समय पर सर्वर को रिपॉजिटरी के साथ सर्वेक्षण करता है। यदि रिपॉजिटरी में बदलावों को प्रतिबिंबित किया जाता है, तो बिल्डमेस्टर कुछ देरी के साथ एक आंतरिक परिवर्तन ऑब्जेक्ट बनाएगा और शेड्यूलर ईवेंट हैंडलर को भेज देगा, जो वर्कर पर प्रोजेक्ट बनाने और परीक्षण करने के लिए कदम शुरू करेगा। इन चरणों के बीच, रिपॉजिटरी के अपडेट का संकेत दिया जाएगा। यह कार्यकर्ता पर है कि रिपॉजिटरी की एक स्थानीय प्रति बनाई जाएगी। इस प्रक्रिया का विवरण अगले दो खंडों ( 5.4 और 5.5 ) में नीचे दिया जाएगा।

रिपॉजिटरी में परिवर्तनों को ट्रैक करने का एक और अधिक सुंदर तरीका सर्वर से सीधे संदेश भेजना है, जिस पर यह प्रोजेक्ट के स्रोत कोड को बदलने के बारे में बिल्डमास्टर को स्थित है। इस मामले में, जैसे ही डेवलपर एक प्रतिबद्ध करता है, प्रोजेक्ट रिपॉजिटरी वाला सर्वर BuildMaster को एक संदेश भेजेगा । और, बदले में, PBChangeSource ऑब्जेक्ट बनाकर इंटरसेप्ट किया जाएगा। इसके अलावा, इस ऑब्जेक्ट को शेड्यूलर को स्थानांतरित कर दिया जाएगा, जो परियोजना की विधानसभा और इसके परीक्षण के लिए चरणों को सक्रिय करता है। इस विधि का एक महत्वपूर्ण हिस्सा रिपॉजिटरी में सर्वर हुक स्क्रिप्ट के साथ काम कर रहा है। प्रतिबद्ध के दौरान कार्यों को संभालने के लिए जिम्मेदार हुक स्क्रिप्ट में, आपको सेंडविच उपयोगिता को कॉल करने और बिल्डमास्टर के नेटवर्क पते को निर्दिष्ट करने की आवश्यकता है । आपको नेटवर्क पोर्ट निर्दिष्ट करना होगा जो PBChangeSource को सुनेगा । PBChangeSource , वैसे, BuildMaster का हिस्सा है। इस पद्धति के लिए सर्वर पर व्यवस्थापक -एक विशेषाधिकार की आवश्यकता होगी जहां प्रोजेक्ट रिपॉजिटरी स्थित है। सबसे पहले आपको एक बैकअप रिपॉजिटरी बनाने की आवश्यकता है।

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"]))

अनुसूचक एक तत्व है जो एक ट्रिगर के रूप में कार्य करता है जो एक परियोजना के पूरे विधानसभा और परीक्षण श्रृंखला को चलाता है।
बिल्डबोट शेड्यूलर्स

जो बदलाव change_source द्वारा दर्ज किए गए थे, वे BuildBot -a के ऑपरेशन ऑब्जेक्ट में बदल दिए गए थे और अब उनके आधार पर प्रत्येक Sheduler प्रोजेक्ट बिल्ड प्रक्रिया शुरू करने के लिए अनुरोध करता है। हालाँकि, यह भी निर्धारित करता है कि इन अनुरोधों को कतार में कब भेजा जाए। वस्तु बिल्डर एक अनुरोध कतार रखता है और एक अलग वर्कर -ई पर वर्तमान विधानसभा की स्थिति की निगरानी करता है। बिल्डर दोनों बिल्डमेस्टर -ई और वर्कर -ई पर मौजूद है। वह BuildMaster से Worker के लिए एक विशिष्ट बिल्ड भेजता है, चरणों की एक श्रृंखला जिसका पालन किया जाना चाहिए।
हम देखते हैं कि ऐसे अनुसूचियों के वर्तमान उदाहरण में, 2 टुकड़े बनाए जाते हैं। इसके अलावा, प्रत्येक का अपना प्रकार है।

SingleBranchScheduler सबसे लोकप्रिय शेड्यूल वर्गों में से एक है। यह एक शाखा की निगरानी करता है और इसमें दर्ज बदलाव से ट्रिगर होता है। जब वह परिवर्तन देखता है, तो वह निर्माण के लिए अनुरोध भेज सकता है (विशेष पैरामीटर ट्रीस्टेबलटेमर में निर्दिष्ट अवधि के लिए स्थगित कर सकता है )। नाम उस अनुसूची का नाम निर्दिष्ट करता है जिसे बिल्डबॉट -web इंटरफ़ेस में प्रदर्शित किया जाएगा। चेंजफ़िल्टर में एक फ़िल्टर सेट किया जाता है , जिसके पास से गुजरने के बाद शाखा में बदलाव शेड्यूल को बिल्ड अनुरोध भेजने के लिए प्रेरित करता है। बिल्डर -नाम नाम बिल्डर में निर्दिष्ट है, जिसे हम थोड़ी देर बाद निर्दिष्ट करेंगे। हमारे मामले में नाम परियोजना के नाम के समान होगा: yourProject ।

ForceScheduler एक बहुत ही साधारण बात है। इस प्रकार का शेड्यूल BuildBot -web इंटरफ़ेस के माध्यम से माउस क्लिक से चालू होता है। Parameters में SingleBranchScheduler की तरह ही सार है।

पीएस नंबर 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": "."}))

periodicBuildTimer सेकंड में इस आवधिकता का समय निर्धारित करता है।

BuildFactory एक ठोस बिल्ड बनाता है, जिसे फिर बिल्डर वर्कर को भेजता है। BuildFactory उन चरणों को इंगित करता है जो एक कार्यकर्ता को पालन करना चाहिए। ऐडस्टेप विधि को कॉल करके चरण जोड़े जाते हैं ।

इस उदाहरण में जोड़ा गया पहला कदम git क्लीन -d -f -f –x है , फिर git चेकआउट है । ये क्रियाएं विधि पैरामीटर में अंतर्निहित हैं, जो स्पष्ट रूप से इंगित नहीं की गई है, लेकिन ताजे के डिफ़ॉल्ट मान का अर्थ है। मोड = 'वृद्धिशील' पैरामीटर इंगित करता है कि निर्देशिका से फाइलें जहां चिकीआउट की जाती हैं, रिपॉजिटरी से गायब होने के दौरान, अछूती रहती हैं।

दूसरा जोड़ा गया चरण है, ट्रायल स्क्रिप्ट को वर्कर / होम / हैबर / वर्कर / हेलोप्रोजेक्ट वर्कर की ओर से हेलो पैरामीटर के साथ पर्यावरण वैरिएबल PATHONPATH = के साथ कॉल करें ... ताकि आप अपनी स्क्रिप्ट लिख सकें और उन्हें वर्कर की तरफ से निष्पादित कर सकें। use.ShellCommand चरण के माध्यम से। इन लिपियों को सीधे भंडार में डाला जा सकता है। फिर चीचआउट के दौरान वे / घर / हाब / कार्यकर्ता / yourProject / build जाएंगे । हालाँकि, फिर दो "बट्स" हैं:

वर्कर को --umask स्विच के साथ बनाया जाना चाहिए ताकि यह चेकआउट के बाद निष्पादन अधिकारों को अवरुद्ध न करे।
जब git इन लिपियों को आगे बढ़ाता है, तो यह एक्स्टैचेबल प्रॉपर्टी को निर्दिष्ट करने के लिए आवश्यक है, ताकि chechout -e Git के साथ स्क्रिप्ट को निष्पादित करने का अधिकार न खो जाए।

5.6 बिल्डरों

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

बिल्डर के बारे में यहां बताया गया था। अब मैं इसे बनाने के तरीके के बारे में अधिक विस्तार से बात करूंगा। बिल्डरकॉन्फिग एक कंस्ट्रक्टर बिल्डर है । आप ऐसे कई बिल्डरों को c ['बिल्डरों'] में निर्दिष्ट कर सकते हैं, क्योंकि यह बिल्डर प्रकार की वस्तुओं की सूची है। अब हम BuildBot से उदाहरण को फिर से लिखेंगे, इसे हमारे कार्य के करीब लाएंगे।

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

अब मैं मापदंडों बिल्डरकॉन्फिग के बारे में बताऊंगा ।

नाम सेट बिल्डर -a। यहाँ हमने इसे आपकाProject कहा है। इसका मतलब यह है कि वर्कर पर यह बहुत ही रास्ता / घर / हैबर / वर्कर / yourProject / build बनाया जाएगा। Sheduler उस नाम से एक बिल्डर की खोज करता है।

Workernames में श्रमिकों की सूची होती है। जिनमें से प्रत्येक को सी ['श्रमिकों'] में जोड़ा जाना चाहिए।

कारखाना विशिष्ट निर्माण है जिसके साथ बिल्डर जुड़ा हुआ है। यह वर्कर को बिल्ड -ए बनाने वाले सभी चरणों को पूरा करने के लिए एक बिल्ड ऑब्जेक्ट भेजेगा।

6. स्वयं के विन्यास का उदाहरण

यहाँ एक नमूना परियोजना की वास्तुकला है जिसे मैं बिल्डबॉट के माध्यम से लागू करने का प्रस्ताव देता हूं
।

हम svn को एक संस्करण नियंत्रण प्रणाली के रूप में उपयोग करेंगे। रिपॉजिटरी खुद एक निश्चित बादल में होगी। यहाँ इस बादल का पता svn.host/svn/yourProject/trunk है । Svn के तहत क्लाउड में एक उपयोगकर्ता नाम है: उपयोगकर्ता , पासवार्ड: पासवर्ड खाता। स्क्रिप्ट जो बिल्ड -ए स्टेप्स होते हैं, वे भी svn शाखा में, एक अलग बिल्डबॉट / वर्कर_लिनक्स फ़ोल्डर में पड़े होंगे । ये स्क्रिप्ट निष्पादित संपत्ति के साथ भंडार में हैं।

बिल्डमास्टर और वर्कर एक ही प्रोजेक्ट पर काम करते हैं ।होस्ट होस्ट। बिल्डमास्टर अपनी फ़ाइलों को / होम / हैबर / मास्टर फ़ोल्डर में संग्रहीत करता है । कार्यकर्ता निम्नलिखित पथ / घर / हाबर / कार्यकर्ता को संग्रहीत करता है । बिल्डबस्टर और वर्कर प्रक्रियाओं के बीच संचार बिल्डबॉट -ए प्रोटोकॉल का उपयोग करके 4000 पोर्ट के माध्यम से किया जाता है, जो कि 'pb' प्रोटोकॉल है।

लक्ष्य परियोजना पूरी तरह से अजगर में लिखी गई है। कार्य अपने परिवर्तनों को ट्रैक करना, एक निष्पादन योग्य फ़ाइल बनाना, प्रलेखन उत्पन्न करना, परीक्षण करना है। विफलता के मामले में, सभी डेवलपर्स को मेल पर एक संदेश भेजने की आवश्यकता है कि एक विफल कार्रवाई है।

हम प्रोजेक्ट.होस्ट के लिए बिल्डबॉट वेब मैपिंग को पोर्ट 80 से कनेक्ट करेंगे। Apatch वैकल्पिक है। ट्विस्टेड लाइब्रेरी में पहले से ही एक वेब सर्वर है, बिल्डबॉट इसका उपयोग करता है।

बिल्डबॉट के लिए आंतरिक जानकारी संग्रहीत करने के लिए हम साइक्लाइट का उपयोग करेंगे।

मेलिंग के लिए, आपको मेजबान smtp.your.domain की आवश्यकता है - यह प्रमाणीकरण के बिना projectHost@your.domain से ईमेल भेजने की अनुमति देता है। इसके अलावा मेजबान ' smtp ' पर प्रोटोकॉल 1025 पर सुना जाता है।

प्रक्रिया में दो व्यक्ति शामिल हैं: व्यवस्थापक और उपयोगकर्ता । बिल्डबोट को प्रशासित करता है। उपयोगकर्ता प्रतिबद्ध व्यक्ति है।

एक एक्स्टैचेबल फ़ाइल pyinstaller के माध्यम से उत्पन्न होती है । दस्तावेज़ीकरण doxygen के माध्यम से उत्पन्न होता है।

इस वास्तुकला के लिए, मैंने इस मास्टर को लिखा है।

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="projectHost@your.domain", sendToInterestedUsers=True, lookup="your.domain", relayhost="smtp.your.domain", smtpPort=1025, mode="warnings", extraRecipients=['user@your.domain'], 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" }

सबसे पहले आपको BuildMaster और Worker -a बनाना होगा। फिर इस मास्टर.कफ फ़ाइल को / होम / हब्र / मास्टर में पेस्ट करें।

अगला कदम बिल्डमास्टर सेवा शुरू करना है

 sudo buildbot start /home/habr/master

फिर कार्यकर्ता -ए सेवा शुरू करें

 buildbot-worker start /home/habr/worker

हो गया! अब बिल्डबॉट परिवर्तनों को ट्रैक करेगा और उपरोक्त वास्तुकला के साथ परियोजना के निर्माण और परीक्षण के चरणों के बाद svn में प्रतिबद्ध रूप से निष्पादित करेगा।

नीचे मैं उपरोक्त Master.cfg की कुछ विशेषताओं का वर्णन करूंगा ।

6.1 अपने मास्टर के रास्ते पर

अपने Master.cfg को लिखते समय , बहुत सारी त्रुटियां की जाएंगी, इसलिए आपको लॉग फाइल को पढ़ना होगा। यह दोनों BuildMaster -ec के पूर्ण पथ /home/habr/master/twistd.log और कार्यकर्ता -a के साथ पूर्ण पथ /home/habr/worker/twistd.log पर संग्रहीत है । जैसा कि आप त्रुटि को पढ़ते हैं और इसे ठीक करते हैं, आपको BuildMaster -a सेवा को पुनरारंभ करना होगा। यह कैसे करना है:

 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 केवल ट्रंक शाखा तक पहुंचता है। रहस्यमय पैरामीटर स्प्लिट_फाइल = यूज़। एस.वन.प्लेट_फाइल_वैलस्ट्रंक नियम सेट करता है: शाखाओं में svn फ़ोल्डरों की संरचना को कैसे विभाजित किया जाए। वह उन्हें सापेक्ष तरीके प्रदान करता है। बदले में, विभाजन_फाइल_वैलस्ट्रंक यह कहकर प्रक्रिया को सरल करता है कि केवल ट्रंक भंडार में है।

शेड्यूलर में , ChangeFilter निर्दिष्ट किया जाता है , जो किसी को भी नहीं देखता है और इसके साथ ट्रंक शाखा को संबद्ध करता है, विभाजित_फाइल_वैलस्ट्रंक के माध्यम से निर्दिष्ट एसोसिएशन के अनुसार। ट्रंक में परिवर्तन का जवाब देते हुए, यह आपके Project नाम के बिल्डर को शुरू करता है।

यहां संपत्तियों की आवश्यकता है ताकि व्यवस्थापक को विधानसभा से न्यूज़लेटर मिले और प्रक्रिया के मालिक के रूप में परीक्षण के परिणाम मिले।

बिल्ड -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="projectHost@your.domain", sendToInterestedUsers=True, lookup="your.domain", relayhost="smtp.your.domain", smtpPort=1025, mode="warnings", extraRecipients=['user@your.domain'], messageFormatter=reporters.MessageFormatter( template=template_html, template_type='html', wantProperties=True, wantSteps=True) ) c['services'] = [sendMessageToAll]

यह कई तरीकों से संदेश भेज सकता है ।

MailNotifier नोटिफिकेशन भेजने के लिए मेल का उपयोग करता है।

template_html समाचार पत्र के लिए पाठ टेम्पलेट सेट करता है। मार्कअप बनाने के लिए, html का उपयोग करें। इसे jinja2 इंजन द्वारा संशोधित किया गया है ( django के साथ तुलना की जा सकती है)। BuildBot में चर का एक सेट होता है, जिनमें से मानों को संदेश पाठ बनाने की प्रक्रिया में टेम्पलेट में प्रतिस्थापित किया जाता है। ये चर {{डबल घुंघराले ब्रेस}} में अंकित हैं। इसलिए, उदाहरण के लिए, सारांश पूर्ण किए गए संचालन, यानी सफलता या विफलता की स्थिति को प्रदर्शित करता है। और परियोजनाएं आपके Project को आउटपुट देंगी । इसलिए, jinja2 , BuildBot वैरिएबल और अजगर स्ट्रिंग फॉर्मेटर्स में कंट्रोल कमांड्स का उपयोग करके, आप एक बहुत ही सूचनात्मक संदेश बना सकते हैं।

MailNotifier में निम्नलिखित तर्क दिए गए हैं।

fromaddr - वह पता जिससे सभी लोग समाचार पत्र प्राप्त करेंगे।

sendToInterestedUsers = True उस स्वामी और उपयोगकर्ता को एक संदेश भेजता है जिसने कमिट किया है ।

लुकअप - समाचार प्राप्त करने वाले उपयोगकर्ताओं के नाम में प्रत्यय जोड़ा जाना। तो एक उपयोगकर्ता के रूप में व्यवस्थापक admin@your.domain पर न्यूज़लेटर प्राप्त करेगा।

relayhost होस्ट नाम निर्दिष्ट करता है जिस पर smtp सर्वर खुला है, और smptPort उस पोर्ट संख्या को निर्दिष्ट करता है, जिस पर smtp सर्वर सुनता है।

मोड = "चेतावनी" कहती है कि मेलिंग तभी की जानी चाहिए जब कम से कम एक बिल्ड स्टेप ऐसा हो जो विफलता या चेतावनी की स्थिति के साथ समाप्त हो गया हो। सफलता के मामले में, मेलिंग की आवश्यकता नहीं है।

extraRecipients में उन व्यक्तियों की एक सूची है, जिनके साथ मेलिंग को स्वामी और प्रतिबद्ध बनाने वाले व्यक्ति के अलावा किया जाना चाहिए ।

messageFormatter एक ऐसी वस्तु है जो संदेश के प्रारूप, उसके टेम्पलेट और jinja2 से उपलब्ध चरों के सेट को परिभाषित करती है । चाहने वाले के रूप में पैरामीटर = यह सच है और चाहते हैं = उपलब्ध उपलब्ध चर के इस सेट को सही करें।

['सेवाओं'] के साथ = [sendMessageToAll] सेवाओं की एक सूची प्रदान करता है, जिनके बीच हमारा होगारिपोर्टर ।

हमने कर दिखाया! मेरी बधाई

हमने अपना स्वयं का कॉन्फ़िगरेशन बनाया और कार्यक्षमता देखी कि बिल्डबॉट सक्षम है । यह, मुझे लगता है, यह समझने के लिए पर्याप्त है कि क्या इस उपकरण को आपकी परियोजना बनाने के लिए आवश्यक है। क्या वह आपके लिए दिलचस्प है? क्या यह आपके काम आएगा? क्या इसके साथ काम करना सुविधाजनक है? तब मैं अच्छे कारण के लिए यह लेख लिखता हूं।

और एक बात।मैं चाहूंगा कि व्यावसायिक समुदाय बिल्डबॉट का उपयोग करके व्यापक, मैनुअल अनुवाद, और अधिक उदाहरणों का उपयोग करें।

ध्यान देने के लिए आप सभी का धन्यवाद। सौभाग्य है।

बिल्डबोट का उपयोग करके निरंतर एकीकरण कार्यान्वयन उदाहरण

सामग्री