"Achtung!", या परियोजना की निर्माण स्थिति की निगरानी करें

परियोजना का निर्माण करने के लिए, परीक्षण चलाएं और कोड की गुणवत्ता की जांच करें, हम ( Mail.ru कैलेंडर परियोजना में) जेनकिंस CI का उपयोग करते हैं। असेंबली गिट रिपॉजिटरी (हुक द्वारा) पर धकेलने के तुरंत बाद शुरू होती है और निश्चित रूप से, मैं समय पर ढंग से असेंबल असेंबलियों के बारे में जानकारी प्राप्त करना चाहता हूं। एक तरफ, ईमेल अधिसूचना पर्याप्त लगती है, दूसरी तरफ, मैं कुछ और ध्यान देने योग्य और मजेदार चाहता हूं।

लगभग तीन या चार साल पहले, जब मैं एक अन्य परियोजना पर काम कर रहा था, उसी उद्देश्य के लिए, एक फ्लैशर खरीदा गया था, जो 220-वोल्ट नेटवर्क पर काम कर रहा था, और इसे नियंत्रित करने के लिए, कुख्यात कंपनी मास्टरपिट का MP709 मॉड्यूल (USB रिले) खरीदा गया था। समाधान असफल था: सबसे पहले, इस समय इस मॉड्यूल के लिए कोई लिनक्स समर्थन नहीं था (मुझे डेटा एक्सचेंज प्रोटोकॉल को उल्टा करना था और लिनक्स के लिए अपना खुद का "ड्राइवर" लिखना था), और दूसरी बात, कंप्यूटर और आउटलेट से चलने वाले तारों द्वारा आपातकालीन प्रकाश का स्थान सीमित था। एक तरह से या किसी अन्य, डिजाइन दूर के बॉक्स में छोड़ दिया गया था और पंखों में इंतजार कर रहा था।
हाल ही में, मेरे हाथ फिर से कंघी कर रहे थे, मैं कुछ दिलचस्प करना चाहता था, लेकिन बेकार और मुझे फ्लैशर याद था। रबिश के ढेर में अफरा-तफरी मचने के बाद मैं वहां से निकल आया: अरुडिनो नैनो - दो टुकड़े, रिले मॉड्यूल - एक टुकड़ा, एमएक्स -05 वी रिसीवर - एक टुकड़ा और एमएक्स-एफएस -03 वी ट्रांसमीटर - एक टुकड़ा। बाकी कूड़े को बालकनी में दूर कोने में फेंककर, अपने अगले घंटे की प्रतीक्षा में, मैंने उपकरण को इकट्ठा करना शुरू कर दिया।
गीतात्मक स्तूप : एक बार, बहुत पहले, जब मैं छोटा था और मेरे पास बहुत समय था, मैं AVR माइक्रोकंट्रोलर्स के एक जोड़े को ले जाऊंगा, बोर्ड को मिलाऊंगा, डिवाइस को मिलाऊंगा, इसे असेंबली भाषा में प्रोग्राम करूंगा ... और मुझे वही मिलेगा बाहर निकलने पर। प्रक्रिया से अधिक सुख हैं, परिणाम समान है।

हार्डवेयर

सर्किट बेहद सरल निकला, क्योंकि हमारे समय में विभिन्न इलेक्ट्रॉनिक मॉड्यूलों, डिजाइनरों और ब्लॉकों की एक बड़ी संख्या आपको किसी ऐसे व्यक्ति के लिए एक इलेक्ट्रॉनिक डिवाइस को इकट्ठा करने की अनुमति देती है, जिन्होंने कभी अपने हाथों में टांका लगाने वाला लोहा नहीं लिया है और सर्किटरी और प्रोग्रामिंग का अध्ययन नहीं किया है।

रिसीवर (MX-05V + Arduino नैनो + रिले मॉड्यूल):

ऑपरेशन का सिद्धांत और भी सरल है: Arduino कंप्यूटर के USB पोर्ट से जुड़ता है और सीरियल इंटरफ़ेस के माध्यम से कमांड सुनता है। यदि कमांड मान्य है, तो इसे रेडियो ट्रांसमीटर के माध्यम से प्रेषित किया जाएगा। दूसरे ब्लॉक में, एक और Arduino रिसीवर को सुनता है और, जब एक कमांड प्राप्त होता है, या तो रिले को चालू या बंद कर देता है। वह सब है। कोई प्रतिक्रिया नहीं, कोई जांच (चेकसम) नहीं, कोई तर्क नहीं।
ट्रांसमीटर कार्यक्रम इस प्रकार है:

#include <VirtualWire.h>

int ledPin = 13 ; // इस पर नेतृत्व के साथ पिन

चार आने वाली_बाय ; // आने वाले संदेशों को संग्रहीत करने के लिए एक बफर
char input_data [ 12 ] ; // संदेश का आकार
int input_size = 0 ; // काउंटर, सिर्फ काउंटर

शून्य सेटअप ( ) {
// सेटअप एलईडी पिन
पिनमोड ( ledPin, OUTPUT ) ;
digitalWrite ( ledPin, LOW ) ;

// सीरियल को शुरू करें (9600 बीपीएस)
सीरियल। शुरू ( 9600 ) ;
सीरियल। Println ( "अचतुंग के लिए तैयार" ) ;

// IO और ISR को इनिशियलाइज़ करें
vw_set_ptt_inverted ( सच ) ; // DR3100 के लिए आवश्यक
vw_setup ( 1200 ) ; // बिट्स प्रति सेकंड
}

शून्य लूप ( ) {
जबकि ( सीरियल उपलब्ध है ) ( 0 ) 0 ) {
आवक_बेटे = सीरियल। पढ़ें ( ) ; // आने वाली बाइट पढ़ें

अगर ( आने वाली_बाइट == 'एन' ) {
input_data [ input_size ++ ] = 0 ;
if ( strncmp ( input_data, "Achtung ON" , 10 ) == 0 || strncmp ( input_data, "Achtung Off " , 11 ) == 0 ) {
digitalWrite ( ledPin, HIGH ) ;
vw_send ( ( uint8_t * ) input_data, input_size ) ;
vw_wait_tx ( ) ; // पूरा संदेश चले जाने तक प्रतीक्षा करें
digitalWrite ( ledPin, LOW ) ;

सीरियल। Println ( "ओके" ) ;
} {
सीरियल। Println ( "विफल" ) ;
}
जबकि ( input_size - > = 0 ) {
input_data [ input_size ] = 0 ;
}
input_size = 0 ; // रीसेट काउंटर
} {
अगर ( input_size <= 11 ) {
input_data [ input_size ] = आने वाली_बेटे ;
}
input_size ++ ;
}
}
}

रिसीवर कार्यक्रम:

#include <VirtualWire.h>

int ledPin = 13 ; // इस पर नेतृत्व के साथ पिन
int relayPin = 3 ; // इस पर रिले के साथ पिन

बाइट इनपुट_डाटा [ VW_MAX_MESSAGE_LEN ] ; // आने वाले संदेशों को संग्रहीत करने के लिए एक बफर
बाइट input_size = VW_MAX_MESSAGE_LEN ; // संदेश का आकार

शून्य सेटअप ( ) {
// सेटअप एलईडी पिन
पिनमोड ( ledPin, OUTPUT ) ;
digitalWrite ( ledPin, LOW ) ;

// सेटअप रिले पिन
पिनमोड ( relayPin, OUTPUT ) ;
digitalWrite ( relayPin, HIGH ) ;

// IO और ISR को इनिशियलाइज़ करें
vw_set_ptt_inverted ( सच ) ; // DR3100 के लिए आवश्यक
vw_setup ( 1200 ) ; // बिट्स प्रति सेकंड
vw_rx_start ( ) ; // रिसीवर शुरू करें
}

शून्य लूप ( ) {
// जांचें कि क्या हमारे पास प्रक्रिया के लिए कुछ डेटा है
अगर ( vw_get_message ( input_data, और input_size ) ) {
digitalWrite ( ledPin, HIGH ) ;
if ( strncmp ( ( * * ) input_data, "Achtung ON" , 10 ) == 0 ) {
digitalWrite ( relayPin, LOW ) ; // achtung! रिले को चालू करें
} और अगर ( strncmp ( char * ) input_data, "Achtung OFF" , 11 ) = = 0 ) {
digitalWrite ( relayPin, HIGH ) ; // रिले रिले
} {
देरी ( 1000 ) ;
}
digitalWrite ( ledPin, LOW ) ;
}
}

जैसा कि आप देख सकते हैं, सब कुछ बेहद सरल है। हम माइक्रोकंट्रोलर्स को कनेक्ट करते हैं, हम क्रमशः, रिसीवर और ट्रांसमीटर को लोड करते हैं, जो कि Arduino प्रोग्राम में एकीकृत बूटलोडर का उपयोग करते हैं, ट्रांसमीटर से जुड़े "सीरियल मॉनीटर" को चलाते हैं और रिले को / ऑफ कमांड पर प्रसारित करते हैं, साथ ही अमान्य कमांड (जाँच के लिए):

रिले चालू और बंद हो जाता है, सब कुछ काम करता है, सब कुछ ठीक है।
यह फ्लैशर को अलग करने और यह देखने का समय है कि हम रिसीवर और रिले कहां रखेंगे:

हम देखते हैं कि अंदर बहुत जगह है। हम डिवाइस को इकट्ठा करना शुरू करते हैं, लेकिन पहले आपको रिसीवर की शक्ति से निपटने की आवश्यकता है।
मैंने ऐसा ही किया: मैंने पुराने को ले लिया, जो एक नोकिया सेल फोन से अनावश्यक, बिजली की आपूर्ति हो गया, इसे विघटित कर दिया और एक छोटा बोर्ड मिला जो हमारे 220 वोल्ट रिसीवर को शक्ति प्रदान कर सकता था। यह ध्यान रखना कि बोर्ड को मामले से हटाने की प्रक्रिया अविश्वसनीय रूप से कठिन थी। मामला गुणवत्ता वाले प्लास्टिक से बना है। फिर भी, मैं सफल रहा:

हम अपने रिसीवर और बिजली की आपूर्ति के साथ एक फ्लैशर को इकट्ठा करते हैं:

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

भविष्य में मैं यह सब एक सुंदर मामले में पैक करने की योजना बना रहा हूं।

सॉफ्टवेयर

कंप्यूटर से ट्रांसमीटर तक कमांड भेजने के लिए, हम एक साधारण स्क्रिप्ट लिखते हैं:

#! / usr / bin / env अजगर
"" "
ट्रांसमीटर को प्राप्त करने के लिए 'ON' या 'OFF' कमांड भेजें।
"" "
__future__ से प्रिंट_फंक्शन आयात करें
आयात os
आयात sys
आयात धारावाहिक


अगर __name__ == '__main__' :
अगर len ( sys । argv ) ! = 3 :
प्रिंट ( "उपयोग: achtung / dev / ttyXX <ON | OFF>" )
सिस । बाहर निकलें ( 1 )

tty = sys । argv [ 1 ]
यदि ओएस नहीं है । पथ । मौजूद है ( tty ) :
प्रिंट ( "त्रुटि: डिवाइस '% s' मौजूद नहीं है" % tty )
सिस । बाहर निकलें ( 1 )

कमांड = सिस । argv [ 2 ]
यदि कमांड ( 'ओएन' , 'ऑफ' ) में नहीं है :
प्रिंट ( "त्रुटि: अज्ञात कमांड '% s'" % कमांड )
सिस । बाहर निकलें ( 1 )

ट्रांसमीटर = धारावाहिक। सीरियल ( ट्टी , 9600 )

अगर ट्रांसमीटर है। रीडलाइन ( ) । पट्टी ( ) ! = 'रेडी के लिए तैयार' :
प्रिंट ( "त्रुटि: डिवाइस आरंभीकृत नहीं है" )
सिस । बाहर निकलें ( 1 )

ट्रांसमीटर। लिखना ( "अचतुंग% एसएन" % कमांड )

परिणाम = ट्रांसमीटर। रीडलाइन ( ) । पट्टी ( )
अगर परिणाम ! = 'ठीक है' :
प्रिंट ( "त्रुटि: डिवाइस की प्रतिक्रिया ठीक नहीं है" )
सिस । बाहर निकलें ( 1 )

काम करने के लिए स्क्रिप्ट के लिए, आपको निर्भरता स्थापित करने की आवश्यकता है - pyserial मॉड्यूल:

  पाइपर स्थापित करें 

हम शुरू करते हैं, ऑन / ऑफ फ्लैशर का आनंद लेते हैं:

  python achtung.py /dev/tty.usbserial-A900FYDU ON
     python achtung.py /dev/tty.usbserial-A900FYDU OFF 

जेनकिंस सीआई में असेंबली की स्थिति प्राप्त करने के लिए, जेनकिंसपी मॉड्यूल का उपयोग करना सबसे अच्छा है, इस मामले में स्क्रिप्ट प्राथमिक होगी। निर्भरता स्थापना:

  पाइप स्थापित करें जेनकिंसापी 

स्क्रिप्ट ही:

#! / usr / bin / env अजगर
"" "
नौकरी ठीक न होने पर जेनकिंस जॉब स्टेटस और अलार्म चलाएं।
"" "
आयात os
आयात sys
आयात का समय

आयात धारावाहिक
जेनकिंसपी से। जेनकींस आयात जेनकिंस
जेनकिंसपी से। अपवाद JenkinsAPIException आयात करते हैं


URL = 'http://jenkins.example.ru/'
USERNAME = 'जेनकींस'
पासवर्ड = 'गुप्त'
जॉब्स = [ 'बिल्ड' , 'टेस्ट' , 'लिंट' ]
TTY = '/dev/tty.usbserial-A900FYDU'


def job_failed ( कनेक्ट, job_name ) :
"" "
बूलियन नौकरी की स्थिति लौटाता है (सच - सफलता, गलत - असफल)।
"" "
अगर job_name कनेक्ट नहीं है :
सच लौटाओ

last_build = कनेक्ट [ job_name ] । get_last_build ( )

अगर last_build। is_running ( ) :
झूठा लौटना

build_status = last_build। get_status ( )

अगर build_status में ( 'FAIL' , 'FAILED' , 'FAILURE' , 'ERROR' , 'REGRESSION' ) :
सच लौटाओ

झूठा लौटना


def send_to_transmitter ( डिवाइस, कमांड ) :
"" "
डिवाइस पर कमांड भेजें और त्रुटि पर मरें।
"" "
डिवाइस। लिखना ( "अचतुंग% एसएन" % कमांड )

परिणाम = उपकरण। रीडलाइन ( ) । पट्टी ( )
अगर परिणाम ! = 'ठीक है' :
प्रिंट ( "त्रुटि: डिवाइस की प्रतिक्रिया ठीक नहीं है" )
सिस । बाहर निकलें ( 1 )


अगर __name__ == '__main__' :
यदि ओएस नहीं है । पथ । मौजूद है ( TTY ) :
प्रिंट ( "त्रुटि: डिवाइस '% s' मौजूद नहीं है" % TTY )
सिस । बाहर निकलें ( 1 )

कोशिश करें :
कनेक्ट = जेनकिंस ( URL, USERNAME, PASSWORD )

यदि कोई ( job_failed ( कनेक्ट, job_name ) जॉब_name के लिए JOBS में ) :
ट्रांसमीटर = धारावाहिक। सीरियल ( TTY, 9600 )

अगर ट्रांसमीटर है। रीडलाइन ( ) । पट्टी ( ) ! = 'रेडी के लिए तैयार' :
प्रिंट ( "त्रुटि: डिवाइस आरंभीकृत नहीं है" )
सिस । बाहर निकलें ( 1 )

send_to_transmitter ( ट्रांसमीटर, 'चालू' )
समय । नींद ( 5 )
send_to_transmitter ( ट्रांसमीटर, 'OFF' )

सिवाय जेनकिंसएपीआईएक्स अपवाद:
सिस । बाहर निकलें ( 1 )

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

लाभ!

सब कुछ सबसे उपयुक्त समय पर एक हंसमुख पलक के साथ, सभी डेवलपर्स को स्थापित करने, काम करने, और सभी डेवलपर्स को प्रसन्न करता है (बिल्ड को छोड़कर जो बनाता है)।
स्रोत: https://github.com/dreadatour/jenkins-achtung

अपडेट : डिवाइस ऑपरेशन वीडियो: