BuildBot सह सतत एकात्मतेचे उदाहरण अंमलबजावणी

(प्रतिमा कॉम्प्युटरायझर आरोग्यापासून Pixabay)

हाय

माझे नाव आहे इव्हगेनी चेर्किन, मी एका खाण कंपनीत विकास कार्यसंघाचा प्रोग्रामर आहे पॉलीमेटल.

कोणताही मोठा प्रकल्प सुरू करताना, तुम्ही विचार करू लागता: "ते राखण्यासाठी कोणते सॉफ्टवेअर वापरणे चांगले आहे?" पुढील आवृत्ती रिलीज करण्यापूर्वी आयटी प्रकल्प अनेक टप्प्यांतून जातो. जेव्हा या टप्प्यांची साखळी स्वयंचलित असते तेव्हा ते चांगले असते. स्वतः आयटी प्रकल्पाची नवीन आवृत्ती रिलीझ करण्याच्या स्वयंचलित प्रक्रियेला म्हणतात सतत एकत्रीकरण. बिल्डबॉट या प्रक्रियेची अंमलबजावणी करण्यासाठी आमच्यासाठी एक चांगला सहाय्यक ठरला.

या लेखात मी शक्यतांचे विहंगावलोकन प्रदान करण्याचा निर्णय घेतला बिल्डबॉट. हे सॉफ्टवेअर काय सक्षम आहे? त्याच्याशी कसे संपर्क साधावा आणि त्याच्याशी सामान्य प्रभावी कार्य संबंध कसे तयार करावे? तुमच्या मशीनवर तुमचा प्रकल्प तयार करण्यासाठी आणि चाचणी करण्यासाठी कार्यरत सेवा तयार करून तुम्ही आमचा अनुभव स्वतः लागू करू शकता.

सामग्री

सामग्री

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

5. कॉन्फिगरेशन. स्टेप बाय स्टेप रेसिपी

5.1 BuildmasterConfig
5.2 कामगार
5.3 चेंज_स्रोत
5.4 शेड्युलर

5.5 बिल्ड फॅक्टरी
5.6 बांधकाम व्यावसायिक

6. तुमच्या स्वतःच्या कॉन्फिगरेशनचे उदाहरण

6.1 तुमच्या master.cfg च्या मार्गावर
6.2 svn सह कार्य करणे
6.3 तुम्हाला पत्र: पत्रकारांना घोषित करण्यासाठी अधिकृत आहेत

आम्ही ते केले! अभिनंदन

1. बिल्डबॉट का?

पूर्वी habr-e वर मला अंमलबजावणीबद्दलचे लेख आले सतत एकत्रीकरण वापरत आहे बिल्डबॉट. उदा. हा एक मला ते सर्वात माहितीपूर्ण वाटले. आणखी एक उदाहरण आहे - सोपे. हे लेख सिझन केले जाऊ शकतात मॅन्युअलमधून उदाहरणआणि तो त्यानंतर, इंग्रजीमध्ये. कूप एक चांगला प्रारंभ बिंदू बनवते. हे लेख वाचल्यानंतर, तुम्हाला कदाचित लगेच काहीतरी हवे असेल बिल्डबॉट करण्यासाठी.

थांबा! कोणी त्यांच्या प्रकल्पांमध्ये त्याचा वापर केला आहे का? तो होय बाहेर वळते अनेक ते त्यांच्या कार्यात लागू केले. सापडू शकतो उदाहरणे वापरा बिल्डबॉट आणि Google कोड संग्रहणांमध्ये.

मग लोक काय लॉजिक वापरतात बिल्डबॉट? तथापि, इतर साधने आहेत: क्रूझकंट्रोल и जेनकिन्स. मी या प्रकारे उत्तर देईन. बहुतेक कामांसाठी जेनकिन्स आणि सत्य पुरेसे असेल. त्याच्या बदल्यात, बिल्डबॉट - अधिक जुळवून घेणारा, तर समस्या तितक्याच सहजपणे सोडवल्या जातात जेनकिन्स. निवड तुमची आहे. परंतु आम्ही विकसनशील लक्ष्य प्रकल्पासाठी एखादे साधन शोधत असल्याने, साध्या पायऱ्यांपासून सुरुवात करून, परस्परसंवाद आणि अद्वितीय इंटरफेस असलेली बिल्ड सिस्टम मिळविण्यासाठी अनुमती देणारे एखादे साधन का निवडू नये.

ज्यांचे लक्ष्य प्रकल्प पायथनमध्ये लिहिलेले आहे त्यांच्यासाठी प्रश्न उद्भवतो: "प्रोजेक्टमध्ये वापरल्या जाणार्‍या भाषेच्या दृष्टीने स्पष्ट इंटरफेस असलेली एकीकरण प्रणाली का निवडत नाही?" आणि आता फायदे सादर करण्याची वेळ आली आहे बिल्डबॉट.

तर, आमची “इंस्ट्रुमेंटल चौकडी”. माझ्यासाठी, मी चार वैशिष्ट्ये ओळखली आहेत बिल्डबॉट:

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

2. बिल्डमास्टरच्या नेतृत्वात संकल्पना

कार्य वितरण आर्किटेक्चरचे केंद्रस्थान आहे बिल्डमास्टर. ही एक सेवा आहे जी:

• ट्रॅक ठेवते प्रकल्प स्रोत वृक्ष मध्ये बदल
• पाठवते प्रोजेक्ट तयार करण्यासाठी आणि त्याची चाचणी करण्यासाठी कामगार सेवेद्वारे कार्यान्वित केल्या जाणाऱ्या आदेश
• सूचित करते केलेल्या कृतींच्या परिणामांबद्दल वापरकर्ते

बिल्डमास्टर फाइलद्वारे कॉन्फिगर केले master.cfg. ही फाईल रूटमध्ये आहे बिल्डमास्टर. हे रूट कसे तयार होते ते मी नंतर दाखवतो. फाइल स्वतः master.cfg एक पायथन स्क्रिप्ट आहे जी कॉल वापरते बिल्डबॉट.

पुढील सर्वात महत्वाची वस्तू बिल्डबॉट नाव आहे कामगार. ही सेवा वेगळ्या OS सह दुसर्‍या होस्टवर किंवा कदाचित एकावर लॉन्च केली जाऊ शकते बिल्डमास्टर. हे स्वतःच्या पॅकेजेस आणि व्हेरिएबल्ससह खास तयार केलेल्या आभासी वातावरणात देखील अस्तित्वात असू शकते. हे आभासी वातावरण पायथन युटिलिटीज वापरून तयार केले जाऊ शकते virtualenv, venv.

बिल्डमास्टर प्रत्येकासाठी आदेश प्रसारित करते कामगार-y, आणि तो, त्या बदल्यात, त्यांना पूर्ण करतो. म्हणजेच, असे दिसून आले की प्रकल्प तयार करण्याची आणि चाचणी करण्याची प्रक्रिया चालू शकते कामगार-e विंडोज चालवते आणि लिनक्स चालवणाऱ्या दुसर्‍या वर्करवर.

तपासा प्रकल्प स्त्रोत कोड प्रत्येकावर येतो कामगार-ई

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.

"गोल्डन की
आणि आता मी मागील परिच्छेद कशासाठी लिहिला: एक स्क्रिप्ट मास्टर कडून मागणी करेल कामगार-आणि या निर्देशिकेत दूरस्थपणे केलेले कार्य अंमलात आणले जाणार नाही कारण स्क्रिप्टला चालवण्याचे अधिकार नाहीत. परिस्थिती दुरुस्त करण्यासाठी, आपल्याला एक चावी लागेल --umask=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 BuildmasterConfig

c = BuildmasterConfig = {} 

BuildmasterConfig — कॉन्फिगरेशन फाइलचा मूलभूत शब्दकोश. ते कॉन्फिगरेशन फाइलमध्ये समाविष्ट करणे आवश्यक आहे. वापर सुलभतेसाठी, कॉन्फिगरेशन कोडमध्ये एक उपनाव सादर केला आहे "c". शीर्षके कळा в c["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))                

की करून चेंज_स्रोत डिक्शनरी c मध्ये आम्हाला त्या सूचीमध्ये प्रवेश मिळतो जिथे आम्हाला एखादी वस्तू ठेवायची आहे जी प्रकल्पाच्या स्त्रोत कोडसह रेपॉजिटरी पोल करते. उदाहरण गिट रेपॉजिटरी वापरते जे ठराविक अंतराने पोल केले जाते.

पहिला युक्तिवाद आपल्या भांडाराचा मार्ग आहे.

workdir बाजूला असलेल्या फोल्डरचा मार्ग दर्शवते कामगार- मार्गाशी संबंधित /home/habr/worker/yourProject/build git रेपॉजिटरीची स्थानिक आवृत्ती संग्रहित करेल.

शाखा रेपॉजिटरीमध्ये एक विशिष्ट शाखा आहे ज्याचे अनुसरण केले पाहिजे.

pollInterval त्यानंतरच्या सेकंदांची संख्या समाविष्ट आहे बिल्डमास्टर बदलांसाठी रेपॉजिटरी मतदान करेल.

प्रकल्पाच्या भांडारातील बदलांचा मागोवा घेण्यासाठी अनेक पद्धती आहेत.

सर्वात सोपी पद्धत आहे मतदान, जे सूचित करते बिल्डमास्टर वेळोवेळी रिपॉजिटरीसह सर्व्हरचे मतदान करते. तर वचनबद्ध रेपॉजिटरीमधील बदल प्रतिबिंबित केले, नंतर बिल्डमास्टर काही विलंबाने अंतर्गत ऑब्जेक्ट तयार करेल बदल आणि इव्हेंट हँडलरला पाठवा शेड्यूलर, जे प्रकल्प तयार करण्यासाठी आणि चाचणी करण्यासाठी पायऱ्या सुरू करेल कामगार-ई या चरणांमध्ये सूचित केले जाईल सुधारणा भांडार. नक्की चालू कामगारहे रेपॉजिटरीची स्थानिक प्रत तयार करेल. पुढील दोन विभागांमध्ये या प्रक्रियेचे तपशील खाली दिले जातील. (5.4 и 5.5).

रेपॉजिटरीमधील बदलांचा मागोवा घेण्याची आणखी एक मोहक पद्धत म्हणजे ते होस्ट करणार्‍या सर्व्हरवरून थेट संदेश पाठवणे. बिल्डमास्टर- प्रकल्प स्त्रोत कोड बदलण्याबद्दल. या प्रकरणात, विकासक बनवताच वचनबद्ध, प्रोजेक्ट रिपॉजिटरी असलेला सर्व्हर संदेश पाठवेल बिल्डमास्टर-y आणि तो, त्या बदल्यात, एखादी वस्तू तयार करून त्यास रोखेल PBCchangeSource. पुढे, हा ऑब्जेक्ट हस्तांतरित केला जाईल शेड्यूलर, जे प्रकल्प तयार करण्याच्या चरणांना सक्रिय करते आणि त्याची चाचणी करते. या पद्धतीचा एक महत्त्वाचा भाग काम करत आहे हुक- रेपॉजिटरीमध्ये सर्व्हर स्क्रिप्ट. स्क्रिप्ट मध्ये हुक-a, जेव्हा क्रियांच्या प्रक्रियेसाठी जबाबदार वचनबद्ध-ई, तुम्हाला युटिलिटीला कॉल करणे आवश्यक आहे पाठवा बदल आणि नेटवर्क पत्ता निर्दिष्ट करा बिल्डमास्टर-ए. आपल्याला नेटवर्क पोर्ट देखील निर्दिष्ट करणे आवश्यक आहे जे ऐकेल PBCchangeSource. PBCchangeSource, तसे, भाग आहे बिल्डमास्टर-ए. या पद्धतीसाठी परवानगी आवश्यक असेल प्रशासन-ए सर्व्हरवर जेथे प्रकल्प भांडार स्थित आहे. तुम्हाला प्रथम रेपॉजिटरीचा बॅकअप घेणे आवश्यक आहे.

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 तुकडे तयार केले आहेत. शिवाय, प्रत्येकाचा स्वतःचा प्रकार आहे.

सिंगल ब्रांच शेड्युलर - शेड्यूलवरील सर्वात लोकप्रिय वर्गांपैकी एक. ती एक शाखा पाहते आणि त्यात नोंदवलेल्या बदलामुळे ट्रिगर होते. जेव्हा तो बदल पाहतो तेव्हा तो बिल्ड रिक्वेस्ट पाठवण्यास उशीर करू शकतो (विशेष पॅरामीटरमध्ये निर्दिष्ट केलेल्या कालावधीसाठी स्थगित ट्रीस्टेबल टाइमर) मध्ये नाव मध्ये प्रदर्शित होणार्‍या वेळापत्रकाचे नाव सेट करते बिल्डबॉट- वेब इंटरफेस. IN फिल्टर बदला एक फिल्टर सेट केला जातो, तो पास केल्यानंतर शाखेतील कोणते बदल शेड्यूलला बांधकामासाठी विनंती पाठवण्यास सूचित करतात. IN बिल्डरची नावे नाव सूचित केले आहे बिल्डर-ए, जे आम्ही थोड्या वेळाने सेट करू. आमच्या बाबतीत नाव प्रकल्पाच्या नावासारखेच असेल: तुमचा प्रकल्प.

फोर्स शेड्यूलर एक अतिशय साधी गोष्ट. या प्रकारचे शेड्यूल माऊस क्लिकद्वारे ट्रिगर केले जाते बिल्डबॉट- वेब इंटरफेस. पॅरामीटर्समध्ये सारखेच सार आहे सिंगल ब्रांच शेड्युलर.

पुनश्च क्रमांक 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 ने Git स्क्रिप्ट कार्यान्वित करण्याचा अधिकार गमावला नाही.

5.6 बांधकाम व्यावसायिक

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

काय आहे याबद्दल बिल्डर सांगितले होते येथे. आता मी ते कसे तयार करावे याबद्दल अधिक तपशीलवार सांगेन. BuilderConfig एक कन्स्ट्रक्टर आहे बिल्डर. मध्ये अशा डिझाइनर c['बिल्डर्स'] आपण अनेक निर्दिष्ट करू शकता, कारण ही वस्तूंची शीट आहे बिल्डर प्रकार आता वरून उदाहरण पुन्हा लिहू बिल्डबॉट, आमच्या कार्याच्या जवळ आणत आहे.

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

आता मी तुम्हाला पॅरामीटर्सबद्दल सांगेन BuilderConfig.

नाव नाव निर्दिष्ट करते बिल्डर-अ इथे आम्ही नाव दिले तुमचा प्रकल्प... याचा अर्थ असा की चालू कामगार- हाच मार्ग तयार केला जाईल /home/habr/worker/yourProject/build. शेड्युलर शोधत आहे बिल्डर फक्त या नावाने.

कामगारांची नावे पत्रक समाविष्ट आहे कामगार-एस. त्यापैकी प्रत्येक जोडणे आवश्यक आहे c['कामगार'].

कारखाना - विशिष्ट तयार, ज्याशी ते संबंधित आहे बिल्डर. तो ऑब्जेक्ट पाठवेल तयार वर कामगार यामध्ये समाविष्ट असलेल्या सर्व पायऱ्या पूर्ण करण्यासाठी तयार-द.

6. तुमच्या स्वतःच्या कॉन्फिगरेशनचे उदाहरण

येथे प्रकल्प आर्किटेक्चरचे उदाहरण आहे जे मी द्वारे अंमलात आणण्याचा प्रस्ताव देतो बिल्डबॉट
.

आम्ही आवृत्ती नियंत्रण प्रणाली म्हणून वापरू svn. रेपॉजिटरी स्वतःच काही प्रकारच्या क्लाउडमध्ये स्थित असेल. हा या ढगाचा पत्ता आहे svn.host/svn/yourProject/trunk. ढगाखाली svn खाते वापरकर्तानाव आहे: वापरकर्ता, passwd: पासवर्ड. चरणांचे प्रतिनिधित्व करणाऱ्या स्क्रिप्ट तयार-a देखील शाखेत असेल svn, वेगळ्या फोल्डरमध्ये बिल्डबॉट/वर्कर_लिनक्स. या स्क्रिप्ट जतन केलेल्या मालमत्तेसह रेपॉजिटरीमध्ये स्थित आहेत कार्यवाही करण्यायोग्य.

बिल्डमास्टर и कामगार त्याच होस्टवर चालवा प्रोजेक्ट.होस्ट .बिल्डमास्टर त्याच्या फायली फोल्डरमध्ये संग्रहित करते /home/habr/master. कामगार ते खालील मार्गात साठवले आहे /home/habr/worker. संप्रेषण प्रक्रिया बिल्डमास्टर-a आणि कामगार-ए प्रोटोकॉलनुसार पोर्ट 4000 द्वारे चालते बिल्डबॉट-अ, म्हणजे 'पीबी' प्रोटोकॉल

लक्ष्य प्रकल्प पूर्णपणे पायथनमध्ये लिहिलेला आहे. त्यातील बदलांचा मागोवा घेणे, एक्झिक्युटेबल फाइल तयार करणे, कागदपत्रे तयार करणे आणि चाचणी घेणे हे कार्य आहे. अयशस्वी झाल्यास, सर्व विकासकांना ईमेलद्वारे संदेश पाठवणे आवश्यक आहे की एक अयशस्वी क्रिया आहे.

वेब प्रदर्शन बिल्डबॉट साठी आम्ही पोर्ट 80 शी कनेक्ट करू प्रोजेक्ट.होस्ट. Apatch स्थापित करणे आवश्यक नाही. ग्रंथालयाचा भाग म्हणून पीळ आधीपासून एक वेब सर्व्हर आहे, बिल्डबॉट ते वापरते.

साठी अंतर्गत माहिती साठवण्यासाठी बिल्डबॉट आम्ही वापरू चौरस.

मेलिंगसाठी होस्ट आवश्यक आहे smtp.your.domain - हे मेलवरून पत्रे पाठविण्यास अनुमती देते [ईमेल संरक्षित] प्रमाणीकरणाशिवाय. यजमानपदावरही'SMTP ' पोस्ट 1025 वर मिनिटे ऐकली जात आहेत.

प्रक्रियेत दोन लोक सामील आहेत: प्रशासन и वापरकर्ता. प्रशासक प्रशासक बिल्डबॉट. वापरकर्ता वचनबद्ध व्यक्ती आहे वचनबद्ध-एस.

एक्झिक्युटेबल फाइल द्वारे व्युत्पन्न केली जाते पायइन्स्टॉलर. द्वारे दस्तऐवजीकरण तयार केले जाते डॉक्सीजन.

या आर्किटेक्चरसाठी मी हे लिहिले: 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"
}

प्रथम आपल्याला आवश्यक आहे तयार करण्यासाठी बिल्डमास्टर-a आणि कामगार-अ नंतर ही फाईल पेस्ट करा master.cfg в /home/habr/master.

पुढील पायरी म्हणजे सेवा सुरू करणे बिल्डमास्टरaa

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_alwaystruk नियम सेट करते: फोल्डर रचना कशी खंडित करावी svn शाखा वर. तो त्यांना सापेक्ष मार्ग देखील देतो. त्याच्या बदल्यात split_file_alwaystruk रेपॉजिटरीमध्ये फक्त समाविष्ट आहे असे सांगून प्रक्रिया सुलभ करते ट्रंक.

В वेळापत्रक असे सूचित फिल्टर बदलाकोण पाहतो काहीही नाही आणि त्याच्याशी एक शाखा संबद्ध करते ट्रंक द्वारे दिलेल्या असोसिएशननुसार split_file_alwaystruk. मधील बदलांना प्रतिसाद देत आहे ट्रंक, लाँच करते बिल्डर नावासह तुमचा प्रकल्प.

गुणधर्म येथे हे आवश्यक आहे जेणेकरून प्रशासकास प्रक्रियेचा मालक म्हणून बिल्ड आणि चाचणी परिणामांच्या मेलिंग याद्या प्राप्त होतील.

पाऊल तयार-a चेकआऊट रेपॉजिटरीच्या स्थानिक आवृत्तीमध्ये असलेल्या कोणत्याही फाइल्स पूर्णपणे हटविण्यास सक्षम कामगार-ए. आणि मग पूर्ण करा एसएनएन अद्यतन. मोड पॅरामीटरद्वारे कॉन्फिगर केला आहे मोड = पूर्ण, पद्धत = ताजी. पॅरामीटर haltOnTailure म्हणतात की जर एसएनएन अद्यतन त्रुटीसह कार्यान्वित केले जाईल, नंतर इमारत आणि चाचणीची संपूर्ण प्रक्रिया निलंबित केली जावी, कारण पुढील क्रियांना अर्थ नाही.

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]

तो संदेश पाठवू शकतो वेगळा मार्ग.

MailNotifier सूचना पाठवण्यासाठी ईमेल वापरते.

template_html वृत्तपत्रासाठी मजकूर टेम्पलेट सेट करते. मार्कअप तयार करण्यासाठी HTML चा वापर केला जातो. ते इंजिनद्वारे सुधारित केले जाते jinja2 (शी तुलना केली जाऊ शकते django). बिल्डबॉट व्हेरिएबल्सचा एक संच आहे ज्याची मूल्ये संदेश मजकूर तयार करण्याच्या प्रक्रियेदरम्यान टेम्पलेटमध्ये बदलली जातात. हे व्हेरिएबल्स {{ डबल कर्ली ब्रेसेस }} मध्ये बंदिस्त आहेत. उदाहरणार्थ, सारांश पूर्ण झालेल्या ऑपरेशन्सची स्थिती प्रदर्शित करते, म्हणजेच यश किंवा अपयश. ए प्रकल्प आउटपुट करेल तुमचा प्रकल्प. तर, मध्ये कंट्रोल कमांड वापरुन jinja2, चल बिल्डबॉट-ए आणि पायथन स्ट्रिंग फॉरमॅटिंग टूल्स, तुम्ही खूप माहितीपूर्ण संदेश तयार करू शकता.

MailNotifier खालील युक्तिवाद समाविष्टीत आहे.

addr पासून - ज्या पत्त्यावरून प्रत्येकाला वृत्तपत्र प्राप्त होईल.

स्वारस्य असलेल्या वापरकर्त्यांना पाठवा=True बनवलेल्या मालकाला आणि वापरकर्त्याला संदेश पाठवते वचनबद्ध.

वर बघ — एक प्रत्यय जो वृत्तपत्र प्राप्त करणाऱ्या वापरकर्त्यांच्या नावांमध्ये जोडला जाणे आवश्यक आहे. तर प्रशासन वापरकर्त्याला पत्त्यावर वृत्तपत्र कसे प्राप्त होईल [ईमेल संरक्षित].

relayhost होस्टनाव निर्दिष्ट करते ज्यावर सर्व्हर उघडला आहे SMTPएक smptPort ऐकणारा पोर्ट क्रमांक निर्दिष्ट करते SMTP सर्व्हर

मोड="चेतावणी" किमान एक पाऊल असेल तरच मेलिंग केले पाहिजे असे म्हणतात तयार-ए, जे स्थिती अयशस्वी किंवा चेतावणीसह समाप्त झाले. यशाच्या बाबतीत, वृत्तपत्र पाठवण्याची गरज नाही.

अतिरिक्त प्राप्तकर्ते मालक आणि ज्या व्यक्तीने हे केले त्याव्यतिरिक्त ज्यांना मेलिंग पाठवले जावे अशा व्यक्तींची यादी आहे वचनबद्ध.

संदेश स्वरूप एक ऑब्जेक्ट आहे जो संदेश स्वरूप, त्याचे टेम्पलेट आणि उपलब्ध व्हेरिएबल्सचा संच निर्दिष्ट करतो jinja2. सारखे पर्याय wantProperties = खरे и wantSteps = खरे उपलब्ध व्हेरिएबल्सचा हा संच परिभाषित करा.

सह['services']=[sendMessageToAll] सेवांची सूची प्रदान करते, ज्यामध्ये आमची असेल रिपोर्टर.

आम्ही ते केले! अभिनंदन

आम्ही आमचे स्वतःचे कॉन्फिगरेशन तयार केले आणि ते सक्षम असलेली कार्यक्षमता पाहिली. बिल्डबॉट. मला वाटतं, तुमचा प्रकल्प तयार करण्यासाठी हे साधन आवश्यक आहे की नाही हे समजून घेण्यासाठी हे पुरेसे आहे. तुम्हाला त्याच्यात रस आहे का? ते तुम्हाला उपयोगी पडेल का? त्याच्यासोबत काम करणे सोयीचे आहे का? मग मी हा लेख व्यर्थ लिहित नाही.

आणि पुढे. मला व्यावसायिक समुदाय वापरायला आवडेल बिल्डबॉट, विस्तीर्ण झाले, हस्तपुस्तिकेचे भाषांतर केले गेले आणि आणखी उदाहरणे आहेत.

तुमचे लक्ष दिल्याबद्दल सर्वांचे आभार. शुभेच्छा.

स्त्रोत: www.habr.com