FreeBSD पोर्ट टेस्टिंग के लिए क्विक टिंडरबॉक्स सेटअप

प्रस्तावित पाठ को मुख्य रूप से FreeBSD पोर्ट मेंटेनर और खुद को शुरू करने वालों को संबोधित किया जाता है, लेकिन भले ही आपने अभी तक किसी भी पोर्ट PR को नहीं भेजा है, लेकिन आप इसे करने जा रहे हैं, या पोर्ट्स संग्रह के संबंध में QA विधियों के बारे में जानने का मन नहीं बना रहे हैं, तो मुझे लगता है कि आप भी यह दिलचस्प होगा।

दरअसल, हम मार्कसकॉम टिंडरबॉक्स के बारे में बात कर रहे हैं - मार्कस क्लार्क और उनके सहयोगियों द्वारा लिखी गई स्क्रिप्ट का एक सेट जो कि आधिकारिक फ्रीबीएसडी पैकेज बनाने के लिए उपयोग किया जाता था।

संक्षेप में, यह इस तरह से काम करता है: आप आधार प्रणालियों के एक सेट को परिभाषित करते हैं (फ्रीबीएसडी शब्दावली में आधार प्रणाली; जरूरी नहीं कि यह रिलीज हो, यह किसी भी स्थिर शाखा या पाठ्यक्रम हो सकता है, या यहां तक ​​कि आपका खुद का निर्माण), पोर्ट ट्री और बिल्ड (पहले दो का संयोजन)। फिर, शुद्ध चिरोट वातावरण में, आप किसी भी पोर्ट को एक पैकेज के रूप में एकत्र कर सकते हैं और सुनिश्चित कर सकते हैं कि आपको कुछ भी याद नहीं है: सभी निर्भरता को ध्यान में रखा जाता है, सब कुछ सही ढंग से इकट्ठा, स्थापित और हटा दिया जाता है, जिससे सिस्टम में कुछ भी नहीं होता है। सभी मेटा-जानकारी एक डेटाबेस में संग्रहीत होती है (MySQL और PostgreSQL समर्थित हैं), बंदरगाहों को अपडेट करने के लिए विकसित टूल हैं और लक्ष्य प्रणाली के "सब्सट्रेट", एकत्रित पैकेज और डिस्टिलिअल्स की कैशिंग, ccache के लिए समर्थन, और यहां तक ​​कि एक PHP वेब फ्रंटेंड भी है।

दरअसल, डॉक्यूमेंटेशन में इंस्टॉलेशन, कंफिगरेशन और यूसेज के उदाहरण कुछ विस्तार से बताए गए हैं, लेकिन कुछ ही नियमित रूप से टिंडरबॉक्स का इस्तेमाल करते हैं।

क्यों?

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

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

एक विशिष्ट FreeBSD डेस्कटॉप उपयोगकर्ता के पास SQL ​​* के अलावा किसी भी * SQL की संभावना नहीं होगी। टिंडरबॉक्स के लिए MySQL या PostgreSQL को स्थापित करना सामान्य कारणों के लिए केवल बेवकूफी है। सौभाग्य से, हाल ही में, इस परियोजना को सुधारने के लक्ष्य के साथ कांटा लगाया गया था (आधिकारिक रिपॉजिटरी को लंबे समय तक अपडेट नहीं किया गया है), और पहली बात SQLite के लिए समर्थन जोड़ा गया था। मेरे लिए अज्ञात कारणों से, लेखक ने गीथब पर अपनी सभी रिपॉजिटरी को हटा दिया। आप .git निर्देशिका को डाउनलोड कर सकते हैं, इसे अनज़िप कर सकते हैं और git reset --hard । अब आप केवल पांच से दस मिनट में टिंडरबॉक्स को तैनात कर सकते हैं।

अद्यतन: SQLite समर्थन हाल ही में आधिकारिक रिपॉजिटरी में दिखाई दिया है ।

कारण के लिए!

हम एक छोटे सुविधाजनक नाम tb साथ एक निर्देशिका में रिपॉजिटरी को क्लोन करते हैं और sqlite_support शाखा में स्विच करते हैं (इसके अलावा, वर्तमान निर्देशिका के लिए एक scripts लिंक बनाएं, क्योंकि हम इसमें सीधे काम करेंगे):

 git clone https://github.com/markjdb/tinderbox-WORK.git tb cd tb git checkout sqlite_support ln -s . scripts 

तुरंत एक आरक्षण करें कि संभावित समस्याओं से बचने के लिए निम्नलिखित कमांड को रूट के भीतर से चलाया जाना चाहिए (हालांकि यह हमेशा आवश्यक नहीं है)।

अब आपको कुछ सरल सवालों के जवाब देकर टिंडरबॉक्स सेटिंग्स को इनिशियलाइज़ करने की आवश्यकता है (आधार के रूप में sqlite चुनें और फ़ाइल नाम सेट करें:

 ./tc Setup 

स्क्रिप्ट चेतावनी देगी कि हमारे पास कुछ निर्भरताएं स्थापित नहीं हैं, लेकिन उनमें से अधिकांश वेब फ्रंटएंड के लिए आवश्यक हैं। हमें केवल p5-DBD-SQLite और lftp । यदि आप उदाहरण के लिए, -STABLE शाखाओं का समर्थन करने और उन्हें अद्यतन करने की योजना बना रहे हैं, और उन्हें csup(1) का उपयोग करके अपडेट करें, और फिर उन्हें make world माध्यम से बनाएँ, तो आपको tb/scripts/etc/env/GLOBAL ./tc init रन ./tc init , लेकिन हमें पर्याप्त रिलीज़ की आवश्यकता है। जिसे हम एफ़टीपी के माध्यम से उठाएंगे, इसलिए इस कदम को छोड़ दिया जा सकता है।

अब हमें फ्रीबीएसडी के सभी संस्करणों के सब्सट्रेट (मूल जेलों में) को बनाने की आवश्यकता है, जिसके लिए हम पैकेज बनाना चाहते हैं। उन्हें jail(8) से कोई लेना-देना नहीं है, इस मामले में यह सिर्फ एक मेल नाम है, इसलिए मैंने इसे शब्दशः अनुवाद नहीं किया। टिंडरबॉक्स के केंद्र में केवल चिरोट chroot(8) और NFS या नलफुट माउंट होते हैं (बेहतर तब से जब आपको कुछ भी कॉन्फ़िगर करने की आवश्यकता न हो)। मुझे लगता है, शुरुआत के लिए, हम दो स्थिर शाखाओं से नवीनतम रिलीज के लिए खुद को सीमित करेंगे:

 ./tc createJail -j 7.4 -t 7.4-RELEASE -u LFTP -H ftp.freebsd.org ./tc createJail -j 8.2 -t 8.2-RELEASE -u LFTP -H ftp.freebsd.org 

नाम FreeBSD के मुख्य संस्करण संख्या से शुरू होना चाहिए (वही नाम बनाने के लिए लागू होता है, नीचे देखें)। एक मेजबान ( -H पैरामीटर) के रूप में, यह निकटतम दर्पण के पते को बदलने के लिए समझ में आता है (हमें केवल base , proflibs , proflibs और src proflibs )।

अब हमें अपने वर्किंग पोर्ट्स ट्री को जोड़ने की जरूरत है - न कि /usr/ports , लेकिन जिसे सबवर्सन (या, हमेशा की तरह, CVS) से चेकआउट किया जाए और जहां से हम send-pr(1) या कमिट के लिए डिफरेंसेस बनाएंगे। इसे डायरेक्टरी /home/alice/fbsd/ports जिसे /home/alice/fbsd/ports (प्रगति में काम) कहा जाता है:

 ./tc createPortsTree -p wip -u NONE -m /home/alice/fbsd/ports 

-u NONE विकल्प यादृच्छिक नहीं है: हम स्पष्ट रूप से इंगित करते हैं कि बंदरगाहों के पेड़ को अपडेट करना आवश्यक नहीं है; आमतौर पर हम इसे cvs^Wsvn up माध्यम से खुद को अपडेट करते हैं (आखिरकार, यह हमारा काम करने वाला पेड़ है)। कई पेड़, साथ ही साथ सबस्ट्रेट्स भी हो सकते हैं, लेकिन ज्यादातर यह एक साधारण पोर्ट-हैकर की मशीन पर होता है।

हालांकि, हम लगभग वहां हैं। यह बिल्ड बनाने के लिए बनी हुई है: सब्सट्रेट और पोर्ट ट्री के संयोजन। क्योंकि हमारे पास दो रिलीज (7.4 और 8.2) और एक पेड़ (wip) है, तो दो बिल्ड भी होंगे:

 ./tc createBuild -b 7.4-wip -j 7.4 -p wip ./tc createBuild -b 8.2-wip -j 8.2 -p wip 

अगर हमने कुछ गलत किया है (उदाहरण के लिए, हमने किसी एक कमांड में गलत पैरामीटर निर्दिष्ट किया है), और रिकॉर्ड पहले ही डेटाबेस में प्रवेश कर गया है, तो हमें मैन्युअल रूप से ( sqlite3 tinderbox.db का उपयोग करके) संबंधित रिकॉर्ड (आमतौर पर jails , ports_trees ) को हटाना होगा या builds )।

स्थानीय डिस्टिफाइल कैश के रूप में मौजूदा का उपयोग करना तर्कसंगत है:

 ./tc configDistfile -c /usr/ports/distfiles 

असल में, वह सब है! हम टिंडरबॉक्स में अपने पहले पैकेज को इकट्ठा करने के लिए तैयार हैं। चलो संकलन करते हैं, उदाहरण के लिए, FreeBSD-7.4 के लिए nmap (यह इंगित करते हुए कि हम nullfs के माध्यम से निर्देशिकाओं को माउंट करना पसंद करते हैं और pkg-plist साथ समस्याओं को घातक त्रुटि मानते हैं):

 ./tc tinderbuild -nullfs -plistcheck -b 7.4-wip security/nmap 

यदि सब कुछ सही ढंग से किया जाता है, तो थोड़ी देर के बाद हमारे पास packages/7.4-wip निर्देशिका में नए पैकेज होंगे और logs/7.4-wip में बिल्ड-लॉग (यदि आपने पोर्ट या इसके किसी भी निर्भरता का निर्माण नहीं किया है, तो पैकेज दिखाई नहीं देगा, लेकिन) errors/7.4-wip में त्रुटि लॉग के लिए देखो errors/7.4-wip निर्देशिका और ध्यान से उन्हें अध्ययन):

 $ find logs packages -type f -name nmap\* logs/7.4-wip/nmap-5.51_2.log packages/7.4-wip/All/nmap-5.51_2.tbz 

फ़ाइलों के अलावा, पोर्ट श्रेणियों के लिए प्रतीकात्मक लिंक भी बनाए जाते हैं, और इसी तरह। pkg_add -r माध्यम से पैकेज स्थापित करने के लिए नवीनतम लिंक:

 $ find packages -type l -name nmap\* packages/7.4-wip/Latest/nmap.tbz packages/7.4-wip/ipv6/nmap-5.51_2.tbz packages/7.4-wip/security/nmap-5.51_2.tbz 

आगे क्या है?

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

अंत में, मैं एक स्वच्छ निर्माण के महत्व को जल्दी दोहराता हूं। याद रखें: यदि आपके सिस्टम पर एक पोर्ट बनाया गया है, तो इसका मतलब यह नहीं है कि इसे बाकी सभी से एकत्र किया जाएगा; केवल टिंडरबॉक्स विधानसभा प्रदान करता है, जैसा कि वे कहते हैं, प्राचीन वातावरण में। बेशक, FreeBSD बिल्ड-क्लस्टर (पॉइंट्टीहाट) वस्तुतः एक ही काम करता है, और यदि पैकेज नहीं बनाया गया है, तो इसका पता लगाया जाएगा, अनुचर को एक अधिसूचना प्राप्त होगी जिसे जवाब देना होगा, अन्यथा पोर्ट को BROENEN के रूप में चिह्नित किया जाएगा। लेकिन यह सब समय लगता है, क्योंकि portmgr @ को अधिक समस्याग्रस्त लॉग में रेक करना पड़ता है, और उपयोगकर्ताओं को एक कच्चे उत्पाद के साथ संतुष्ट होने के लिए मजबूर किया जाता है। टिंडरबॉक्स, आपकी ओर से बहुत कम या कोई शरीर की गतिविधि के साथ, अगर ठीक से उपयोग किया जाता है, तो बहुत से लोगों के काम को सरल कर सकता है और फ्रीबीएसडी बंदरगाहों की समग्र गुणवत्ता में सुधार करने में मदद कर सकता है।