बिल्ड इवेंट प्रोटोकॉल (बीईपी) की मदद से, तीसरे पक्ष के प्रोग्राम को Bazel को कॉल करने के बारे में अहम जानकारी मिलती है. उदाहरण के लिए, IDE प्लग इन या ऐसे डैशबोर्ड के लिए जानकारी इकट्ठा करने के लिए, बीईपी का इस्तेमाल किया जा सकता है जो बिल्ड के नतीजे दिखाता है.
प्रोटोकॉल, प्रोटोकॉल बफ़र मैसेज का एक सेट होता है. इसमें कुछ सेमेटिक्स भी होते हैं. इसमें बिल्ड और जांच के नतीजों, बिल्ड की प्रोग्रेस, बिल्ड कॉन्फ़िगरेशन वगैरह के बारे में जानकारी शामिल होती है. BEP का इस्तेमाल, प्रोग्राम के हिसाब से किया जाना है. इससे Bazel की कमांड लाइन के आउटपुट को पार्स करने की ज़रूरत नहीं पड़ती.
बिल्ड इवेंट प्रोटोकॉल, किसी बिल्ड के बारे में जानकारी को इवेंट के तौर पर दिखाता है. बिल्ड इवेंट, प्रोटोकॉल बफ़र मैसेज होता है. इसमें बिल्ड इवेंट आइडेंटिफ़ायर, चाइल्ड इवेंट आइडेंटिफ़ायर का एक सेट, और पेलोड शामिल होता है.
बिल्ड इवेंट आइडेंटिफ़ायर: बिल्ड इवेंट के टाइप के आधार पर, यह ओपेक स्ट्रिंग या स्ट्रक्चर्ड जानकारी हो सकती है. इससे, बिल्ड इवेंट के बारे में ज़्यादा जानकारी मिलती है. बिल्ड इवेंट आइडेंटिफ़ायर, किसी बिल्ड में यूनीक होता है.
चाइल्ड: कोई बिल्ड इवेंट, अपने children फ़ील्ड में बिल्ड इवेंट आइडेंटिफ़ायर शामिल करके, दूसरे बिल्ड इवेंट का एलान कर सकता है. उदाहरण के लिए,
PatternExpandedबिल्ड इवेंट उन टारगेट के बारे में बताता है जिन्हें वह चाइल्ड के तौर पर बड़ा करता है. प्रोटोकॉल से यह पक्का होता है कि पहले इवेंट को छोड़कर, सभी इवेंट के बारे में पिछले इवेंट से सूचना दी जाती है.पेलोड: पेलोड में, किसी बिल्ड इवेंट के बारे में स्ट्रक्चर्ड जानकारी होती है. इसे उस इवेंट के लिए प्रोटोकॉल बफ़र मैसेज के तौर पर एन्कोड किया जाता है. ध्यान दें कि हो सकता है कि पेलोड, उम्मीद के मुताबिक टाइप का न हो. हालांकि, अगर बिल्ड बीच में ही बंद हो गया है, तो यह
Abortedमैसेज हो सकता है.
इवेंट ग्राफ़ बनाना
सभी बिल्ड इवेंट, पैरंट और चाइल्ड के संबंध के ज़रिए, डायरेक्टेड ऐसाइक्लिक ग्राफ़ बनाते हैं. शुरुआती बिल्ड इवेंट को छोड़कर, हर बिल्ड इवेंट में एक या एक से ज़्यादा पैरंट इवेंट होते हैं. कृपया ध्यान दें कि किसी चाइल्ड इवेंट के सभी पैरंट इवेंट, ज़रूरी नहीं है कि उसके पहले पोस्ट किए जाएं. कोई बिल्ड पूरा होने पर (सफल या असफल), पहले से सूचना दिए गए सभी इवेंट पोस्ट कर दिए जाएंगे. Bazel के क्रैश होने या नेटवर्क ट्रांसपोर्ट के काम न करने पर, हो सकता है कि एलान किए गए कुछ बिल्ड इवेंट कभी पोस्ट न किए जाएं.
इवेंट ग्राफ़ का स्ट्रक्चर, किसी निर्देश के लाइफ़साइकल को दिखाता है. हर बीईपी ग्राफ़ का आकार इस तरह का होता है:
- रूट इवेंट हमेशा
BuildStartedइवेंट होता है. अन्य सभी इवेंट, इसके वंशज होते हैं. - BuildStarted इवेंट के बच्चों में, कमांड के बारे में मेटाडेटा होता है.
- कमांड से जनरेट किए गए डेटा वाले इवेंट,
BuildFinishedइवेंट से पहले दिखते हैं. जैसे, बनाई गई फ़ाइलें और जांच के नतीजे. BuildFinishedइवेंट के बाद, ऐसे इवेंट हो सकते हैं जिनमें बिल्ड के बारे में खास जानकारी हो. उदाहरण के लिए, मेट्रिक या प्रोफ़ाइलिंग डेटा.
Build Event Protocol का इस्तेमाल करना
बाइनरी फ़ॉर्मैट में इस्तेमाल करना
BEP को बाइनरी फ़ॉर्मैट में इस्तेमाल करने के लिए:
--build_event_binary_file=/path/to/fileविकल्प तय करके, Bazel को प्रोटोकॉल बफ़र मैसेज को फ़ाइल में सीरियलाइज़ करने के लिए कहें. इस फ़ाइल में, क्रम से लगाए गए प्रोटोकॉल बफ़र मैसेज होंगे. साथ ही, हर मैसेज की लंबाई तय होगी. हर मैसेज के आगे, उसकी लंबाई होती है. इसे वैरिएबल लेंथ इंटरजर के तौर पर एन्कोड किया जाता है. प्रोटोकॉल बफ़र लाइब्रेरी केparseDelimitedFrom(InputStream)तरीके का इस्तेमाल करके, इस फ़ॉर्मैट को पढ़ा जा सकता है.इसके बाद, एक प्रोग्राम लिखें जो क्रम से लगाए गए प्रोटोकॉल बफ़र मैसेज से काम की जानकारी निकालता हो.
टेक्स्ट या JSON फ़ॉर्मैट में इस्तेमाल करना
Bazel कमांड-लाइन के इन फ़्लैग से, BEP को टेक्स्ट और JSON जैसे ऐसे फ़ॉर्मैट में आउटपुट किया जाएगा जिन्हें कोई भी पढ़ सकता है:
--build_event_text_file
--build_event_json_file
इवेंट सेवा बनाना
बिल्ड इवेंट सेवा प्रोटोकॉल, बिल्ड इवेंट पब्लिश करने के लिए एक सामान्य gRPC सेवा है. Build Event
Service प्रोटोकॉल, BEP से अलग होता है और BEP इवेंट को ओपेक बाइट के तौर पर इस्तेमाल करता है.
Bazel, Build Event Service प्रोटोकॉल के gRPC क्लाइंट के साथ शिप होता है. यह प्रोटोकॉल, Build Event Protocol इवेंट पब्लिश करता है. --bes_backend=HOST:PORT फ़्लैग का इस्तेमाल करके, एंडपॉइंट तय किया जा सकता है, ताकि इवेंट भेजे जा सकें. अगर आपका बैकएंड gRPC का इस्तेमाल करता है, तो आपको पते के आगे सही स्कीम जोड़ना होगा: सादा टेक्स्ट gRPC के लिए grpc:// और TLS चालू होने पर gRPC के लिए grpcs://.
इवेंट सेवा के फ़्लैग बनाना
Bazel में, Build Event Service प्रोटोकॉल से जुड़े कई फ़्लैग हैं. इनमें ये भी शामिल हैं:
--bes_backend--[no]bes_best_effort--[no]bes_lifecycle_events--bes_results_url--bes_timeout--project_id
इनमें से हर फ़्लैग के बारे में जानने के लिए, कमांड-लाइन रेफ़रंस देखें.
पुष्टि करना और सुरक्षा
Bazel की Build Event Service को लागू करने पर, पुष्टि करने और TLS की सुविधा भी काम करती है. इन सेटिंग को नीचे दिए गए फ़्लैग का इस्तेमाल करके कंट्रोल किया जा सकता है. कृपया ध्यान दें कि इन फ़्लैग का इस्तेमाल, Bazel के रिमोट एक्सीक्यूशन के लिए भी किया जाता है. इसका मतलब है कि Build Event Service और रिमोट इक्विज़िकशन एंडपॉइंट को एक ही पुष्टि और TLS इन्फ़्रास्ट्रक्चर शेयर करना होगा.
--[no]google_default_credentials--google_credentials--google_auth_scopes--tls_certificate--[no]tls_enabled
इनमें से हर फ़्लैग के बारे में जानने के लिए, कमांड-लाइन रेफ़रंस देखें.
इवेंट सेवा बनाना और रिमोट कैश मेमोरी
आम तौर पर, BEP में उन लॉग फ़ाइलों के कई रेफ़रंस होते हैं (test.log, test.xml वगैरह) जो उस मशीन पर सेव होती हैं जहां Bazel चल रहा है. आम तौर पर, रिमोट बीईएस सर्वर इन फ़ाइलों को ऐक्सेस नहीं कर सकता, क्योंकि ये अलग-अलग मशीनों पर मौजूद होती हैं. इस समस्या को हल करने के लिए, रिमोट कैश मेमोरी के साथ Bazel का इस्तेमाल करें. Bazel, सभी आउटपुट फ़ाइलों को रिमोट कैश मेमोरी में अपलोड करेगा. इनमें, BEP में रेफ़र की गई फ़ाइलें भी शामिल हैं. इसके बाद, BES सर्वर कैश मेमोरी से रेफ़र की गई फ़ाइलें फ़ेच कर सकता है.
ज़्यादा जानकारी के लिए, GitHub पर समस्या 3689 देखें.