बिल्डबॉट के साथ सतत एकीकरण का एक उदाहरण कार्यान्वयन

(छवि द्वारा कम्प्यूटरीकरणकर्ता से पिक्साबे)

हाय!

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

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

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

सामग्री

सामग्री

1. बिल्डबॉट क्यों?
2. बिल्डमास्टर के नेतृत्व में अवधारणा
3. स्थापना
4. पहला कदम

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

5.1 बिल्डमास्टर कॉन्फिग
5.2 कार्यकर्ताओं
5.3 परिवर्तन_स्रोत
5.4 अनुसूचक

5.5 बिल्डफैक्ट्री
5.6 बिल्डर्स

6. आपके स्वयं के कॉन्फ़िगरेशन का उदाहरण

6.1 आपके मास्टर.सीएफजी के रास्ते पर
6.2 एसवीएन के साथ कार्य करना
6.3 आपको पत्र: पत्रकार घोषणा करने के लिए अधिकृत हैं

हमने यह किया! बधाई हो

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

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

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

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

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

तो, हमारी "वाद्य चौकड़ी"। अपने लिए, मैंने चार विशेषताओं की पहचान की है बिल्डबॉट:

1. यह जीपीएल लाइसेंस के तहत एक ओपन सोर्स फ्रेमवर्क है
2. यह एक कॉन्फ़िगरेशन टूल के रूप में पायथन का उपयोग और आवश्यक क्रियाओं का विवरण है
3. यह उस मशीन से प्रतिक्रिया प्राप्त करने का एक अवसर है जिस पर असेंबली होती है
4. आख़िरकार, ये एक मेज़बान के लिए न्यूनतम आवश्यकताएँ हैं। परिनियोजन के लिए पायथन और ट्विस्टेड की आवश्यकता होती है, और वर्चुअल मशीन और जावा मशीन की आवश्यकता नहीं होती है।

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

कार्य वितरण वास्तुकला का केंद्र है बिल्डमास्टर. यह एक ऐसी सेवा है जो:

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

बिल्डमास्टर फ़ाइल के माध्यम से कॉन्फ़िगर किया गया मास्टर.सीएफजी. यह फ़ाइल रूट में है बिल्डमास्टर. बाद में मैं दिखाऊंगा कि यह रूट कैसे बनता है। फ़ाइल स्वयं मास्टर.सीएफजी इसमें एक पायथन स्क्रिप्ट है जो कॉल का उपयोग करती है बिल्डबॉट.

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

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

चेक आउट प्रोजेक्ट स्रोत कोड प्रत्येक पर होता है कामगार-इ।

3. स्थापना

तो चलते हैं। मैं होस्ट के रूप में Ubuntu 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. पहला कदम

बनाने का समय बिल्डमास्टर. यह हमारे फोल्डर में होगा /होम/एचएबीआर/मास्टर.

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. विन्यास. स्टेप बाई स्टेप रेसिपी

विन्यास बिल्डमास्टर मशीन के उस तरफ किया जाता है जहां हमने कमांड निष्पादित की थी क्रिएट-मास्टर. हमारे मामले में, यह एक निर्देशिका है /होम/एचएबीआर/मास्टर. विन्यास फाइल मास्टर.सीएफजी अभी तक अस्तित्व में नहीं है, लेकिन कमांड ने पहले ही फ़ाइल बना ली है मास्टर.सीएमजी.नमूना. आपको इसका नाम बदलना होगा मास्टर.सीएफजी.नमूना в मास्टर.सीएफजी

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

बिल्डमास्टर कॉन्फिग - कॉन्फ़िगरेशन फ़ाइल का मूल शब्दकोश। इसे कॉन्फ़िगरेशन फ़ाइल में शामिल किया जाना चाहिए. उपयोग में आसानी के लिए, कॉन्फ़िगरेशन कोड में एक उपनाम पेश किया गया है "सी". टाइटल कुंजियों की в सी["keyFromDist"] के साथ अंतःक्रिया के लिए निश्चित तत्व हैं बिल्डमास्टर. प्रत्येक कुंजी के लिए, संबंधित ऑब्जेक्ट को मान के रूप में प्रतिस्थापित किया जाता है।

5.2 कार्यकर्ताओं

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

इस बार हम संकेत देते हैं बिल्डमास्टर-y की सूची कामगार-एस। खुद कामगार हमने बनाया ऊपर, संकेत आप-कार्यकर्ता-नाम и पासवर्ड. अब इसके स्थान पर उन्हें निर्दिष्ट करने की आवश्यकता है उदाहरण-कार्यकर्ता и पास .

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

कुंजी से परिवर्तन_स्रोत डिक्शनरी सी में हमें उस सूची तक पहुंच मिलती है जहां हम एक ऑब्जेक्ट रखना चाहते हैं जो प्रोजेक्ट के स्रोत कोड के साथ रिपॉजिटरी को पोल करता है। उदाहरण एक Git रिपॉजिटरी का उपयोग करता है जिसे निश्चित अंतराल पर सर्वेक्षण किया जाता है।

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

कार्यदिर उस फ़ोल्डर के पथ का प्रतिनिधित्व करता है जहां किनारे पर है कामगार-पथ के सापेक्ष /home/habr/worker/yourProject/build गिट रिपॉजिटरी के स्थानीय संस्करण को संग्रहीत करेगा।

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

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

किसी प्रोजेक्ट के रिपॉजिटरी में परिवर्तनों को ट्रैक करने के लिए कई विधियाँ हैं।

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

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

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": "."}))

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

बिल्डफ़ैक्टरी एक विशिष्ट बनाता है निर्माण, फिर कौन निर्माता को भेजता है कामगार. में बिल्डफ़ैक्टरी पालन ​​किए जाने वाले चरणों को इंगित करता है कामगार-य. विधि को कॉल करके चरण जोड़े जाते हैं ऐडस्टेप

इस उदाहरण में पहला जोड़ा गया कदम है गिट क्लीन -डी -एफ -एफ -एक्स, फिर गिट चेकआउट. ये क्रियाएं पैरामीटर में शामिल हैं तरीका, जो स्पष्ट रूप से नहीं बताया गया है लेकिन एक डिफ़ॉल्ट मान दर्शाता है ताजा. पैरामीटर मोड='वृद्धिशील' इंगित करता है कि फ़ाइलें उस निर्देशिका से हैं जहां chechout, भंडार से गायब रहते हुए भी अछूते रहें।

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

1. कामगार एक कुंजी के साथ बनाया जाना चाहिए --उमास्क ताकि यह बाद में निष्पादन अधिकारों को अवरुद्ध न करे जांच-एक।
2. में git धक्का-इन स्क्रिप्टों में से आपको संपत्ति निर्दिष्ट करने की आवश्यकता है निष्पादनयोग्यताकि बाद में chechout-ई ने Git स्क्रिप्ट निष्पादित करने का अधिकार नहीं खोया।

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. समयबद्धक ढूंढ रहे हैं निर्माता बस इसी नाम से.

कार्यकर्ताओं के नाम शीट शामिल है कामगार-एस। जिनमें से प्रत्येक को जोड़ा जाना चाहिए सी['श्रमिक'].

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

6. आपके स्वयं के कॉन्फ़िगरेशन का उदाहरण

यहां उदाहरण प्रोजेक्ट आर्किटेक्चर है जिसे मैं लागू करने का प्रस्ताव करता हूं बिल्डबॉट
.

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

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

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

वेब प्रदर्शन बिल्डबॉट हम पोर्ट 80 से जुड़ेंगे प्रोजेक्ट.होस्ट. Apatch इंस्टॉल करना आवश्यक नहीं है. पुस्तकालय के भाग के रूप में मुड़ वहाँ पहले से ही एक वेब सर्वर है, बिल्डबॉट इसका उपयोग करता है.

के लिए आंतरिक जानकारी संग्रहीत करने के लिए बिल्डबॉट हम इस्तेमाल करेंगे SQLite.

मेल करने के लिए एक होस्ट की आवश्यकता होती है smtp.आपका.डोमेन - यह मेल से पत्र भेजने की अनुमति देता है [ईमेल संरक्षित] प्रमाणीकरण के बिना. होस्ट पर भी 'एसएमटीपी ' मिनट्स पोस्ट 1025 पर सुने जा रहे हैं।

इस प्रक्रिया में दो लोग शामिल हैं: व्यवस्थापक и उपयोगकर्ता. व्यवस्थापक प्रशासन करता है बिल्डबॉट. उपयोगकर्ता वह व्यक्ति है जो प्रतिबद्ध है करना-एस।

निष्पादनयोग्य फ़ाइल के माध्यम से उत्पन्न होता है pyinstaller. दस्तावेज़ीकरण के माध्यम से तैयार किया जाता है Doxygen.

इस वास्तुकला के लिए मैंने यह लिखा: मास्टर.सीएफजी:

मास्टर.सीएफजी

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"
}

आरंभ करने के लिए, आपको चाहिए बनाने बिल्डमास्टर-ए और कामगार-एक। फिर इस फाइल को पेस्ट करें मास्टर.सीएफजी в /होम/एचएबीआर/मास्टर.

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

sudo buildbot start /home/habr/master

फिर सेवा प्रारंभ करें कामगार-a

buildbot-worker start /home/habr/worker

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

नीचे मैं उपरोक्त की कुछ विशेषताओं का वर्णन करूंगा मास्टर.सीएफजी.

6.1 आपके मास्टर.सीएफजी के रास्ते पर

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

В शेड्यूलर इंगित किया गया है फ़िल्टर बदलेंकौन देखता है कोई नहीं और इसके साथ एक शाखा जोड़ता है सूँ ढ किसी दिए गए एसोसिएशन के अनुसार स्प्लिट_फाइल_ऑलवेस्ट्रंक. में होने वाले परिवर्तनों पर प्रतिक्रिया देना सूँ ढ, लॉन्च निर्माता नाम के साथ आपका प्रोजेक्ट.

गुण यहां इसकी आवश्यकता है ताकि व्यवस्थापक को प्रक्रिया के स्वामी के रूप में निर्माण और परीक्षण परिणामों की मेलिंग सूचियां प्राप्त हों।

कदम निर्माण-a जांच रिपॉजिटरी के स्थानीय संस्करण में स्थित किसी भी फ़ाइल को पूरी तरह से हटाने में सक्षम कामगार-एक। और फिर पूरा करो svn अद्यतन. मोड को पैरामीटर के माध्यम से कॉन्फ़िगर किया गया है मोड=पूर्ण, विधि=ताजा. पैरामीटर हॉल्टऑनटेलर कहता है कि यदि 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 का उपयोग मार्कअप बनाने के लिए किया जाता है। इसे इंजन द्वारा संशोधित किया गया है jinja2 (तुलना की जा सकती है django). बिल्डबॉट इसमें वेरिएबल्स का एक सेट होता है जिनके मान संदेश पाठ उत्पन्न करने की प्रक्रिया के दौरान टेम्पलेट में प्रतिस्थापित किए जाते हैं। ये वेरिएबल्स {{ डबल कर्ली ब्रेसिज़ }} में संलग्न हैं। उदाहरण के लिए, सारांश पूर्ण किए गए कार्यों की स्थिति, यानी सफलता या विफलता प्रदर्शित करता है। ए परियोजनाओं बाहर लाएगा आपका प्रोजेक्ट. तो, नियंत्रण आदेशों का उपयोग करना jinja2, चर बिल्डबॉट-ए और पायथन स्ट्रिंग फ़ॉर्मेटिंग टूल, आप काफी जानकारीपूर्ण संदेश बना सकते हैं।

मेलनोटिफ़ायर निम्नलिखित तर्क शामिल हैं.

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

रुचि रखने वाले उपयोगकर्ताओं को भेजें=True स्वामी और बनाने वाले उपयोगकर्ता को एक संदेश भेजता है करना.

लुकअप - एक प्रत्यय जिसे समाचार पत्र प्राप्त करने वाले उपयोगकर्ताओं के नाम में जोड़ा जाना चाहिए। इसलिए व्यवस्थापक उपयोगकर्ता को पते पर न्यूज़लेटर कैसे प्राप्त होगा [ईमेल संरक्षित].

रिलेहोस्ट उस होस्टनाम को निर्दिष्ट करता है जिस पर सर्वर खोला गया है एसएमटीपीतक smptपोर्ट उस पोर्ट नंबर को निर्दिष्ट करता है जो सुनता है एसएमटीपी सर्वर.

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

अतिरिक्तप्राप्तकर्ता इसमें स्वामी और इसे अंजाम देने वाले व्यक्ति के अलावा उन व्यक्तियों की सूची होती है जिन्हें मेल भेजा जाना चाहिए करना.

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

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

हमने यह किया! बधाई हो

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

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

ध्यान देने के लिए आप सभी का धन्यवाद। आपको कामयाबी मिले।

स्रोत: www.habr.com