Semafori Jenkins za posao: 8 koraka (sa slikama)

2024 Autor: John Day | [email protected]. Zadnja promjena: 2024-01-30 09:35

U softverskom inženjeringu kontinuirana integracija je praksa spajanja svih radnih kopija programera na zajedničku glavnu liniju nekoliko puta dnevno. Neke od najboljih praksi za postizanje toga su:

• svi se svakodnevno obvezuju na osnovnu liniju,
• automatizirati izgradnju,
• svi mogu vidjeti rezultate najnovijih verzija.
• …i mnogi drugi.

Da biste ispunili samo ove 3 točke gore, važno je biti obaviješten o statusu izrade što je brže moguće.

Ovaj projekt pomaže u postizanju toga stvaranjem mini, osobnih semafora koji pokazuju trenutni status gradnje. Izgradio sam 2 semafora koji su integrirani u Jenkins poslužitelj za automatizaciju koji NodeMCU povremeno povlači putem WiFi -a.

Korak 1: Materijali i alati

Materijali koje sam koristio:

• NodeMCU (koristio sam v3) (BangGood.com)
• Muški i ženski prespojni kabeli, (BangGood.com)
• 2 kompleta LED dioda: crvena, žuta, zelena (BangGood.com)
• 2 seta od 3 otpornika (450Ω, 500Ω, 22Ω)
• 2 tanke, ali duge prototip PCB ploče (BangGood.com)
• microUSB kabel kao izvor napajanja
• Neka kutija (ja sam je koristio za električne visokonaponske komponente. Našao sam mnogo različitih oblika i jeftino u mojoj lokalnoj maloprodaji)
• 2 olovke ili 2 debele cijevi unutarnjeg promjera 0,5-1 cm; i/ili 2 debele slamke za piće

Potrebni alati:

• Oštri nož (npr. Pomoćni nož za rezanje tepiha)
• Rotacijski alat
• Pištolj za vruće ljepilo
• Stanica za lemljenje
• Klešta, dijagonalna kliješta/bočni rezači
• Odvijač
• Komad debelog papira
• Dvostrana ljepljiva traka
• Vas

Korak 2: Semafori

Za izradu semafora koristimo ploču za izradu prototipova 20x80 mm. Lemite LED diode tako da su postavljene u liniji. Koristio sam ove vrijednosti otpornika:

• crvena: 510Ω
• žuta: 470Ω
• zelena: 22Ω

Vrijednosti su puno veće od preporučenih (maksimalna struja 20 mA po LED), ali eksperimentirajući s različitim vrijednostima, svjetlo nije previše jako i također sve 3 imaju sličan intenzitet. Imajte na umu da je napon 3,3 V za NodeMCU.

Ožičenje je ravno prema naprijed, samo spojite (lemite) katodu svake LED diode s otpornikom, a zatim lemite na muški kraj kabela kratkospojnika. S jedne strane ploče htio sam samo LED elemente bez ikakvih drugih "iskačućih" dijelova poput nogu otpornika, žica i tako dalje. Zato sam koristio "tehniku" koja je neka vrsta SMD -a koristeći komponente PCB -a.

Za sada ostavljamo ovako; poklopac svjetla bit će učinjen kasnije.

Korak 3: Okvir - Glavni

Moramo ugraditi naš NodeMCU na dno okvira. Kutija treba otvor za microUSB priključak kako bismo mogli napajati glavnu jedinicu. Raughly sam izmjerio položaj rupe i upravo sam je izbušio.

Zatim sam pričvrstio plastične odstojnike pomoću vijaka na nodemcu. Stavio sam malo ljepila u svaki kut kutije i stavio cijelu konstrukciju na njega. Nakon što se ohladio, odvrnuo sam NodeMCU i stavio dodatno vruće ljepilo oko odstojnika za koje sam bio siguran da su savršeno postavljeni za NodeMCU. Zahvaljujući tome, ništa se ne koleba unutar kutije i lako možemo priključiti microUSB priključak bez premještanja stvari unutra.

Korak 4: Kutija - Poklopac

Prvo sam pokušao koristiti slamke za piće kao stup za svoje semafore, no nakon nekog ispitivanja otkrio sam da je plastika previše tanka, a kad sam je htio upotrijebiti vrućim ljepilom, postala je vrlo mekana pa se čak i promijenila njegov oblik. Pa sam odlučio koristiti nešto tvrđe - olovke. Odabrao sam neke jeftine prozirne olovke, koje sam odrezao u željenoj duljini i stavio 4 kabela (1 odjednom) sa semafora kroz cijev.

Izbušio sam rupe u srednjoj liniji poklopca prema promjeru olovke. Zatim sam olovke ugradio u rupe i vruće ih zalijepio na donju stranu poklopca pokušavajući držati stupove ravno.

Stavio sam i vruće ljepilo na vrh stupa da pričvrstim ploče semafora na stupove.

Korak 5: Sklapanje

Spojio sam žice na NodeMCU (pinout):

Lijevi semafor:

• crveno do D2 (GPIO4)
• žuto do D3 (GPIO0)
• zelena do D4 (GPIO2)
• uzemljen na GND (upravo sam odabrao jedan od GND pina NodeMCU -a)

DESNI semafor:

• crveno do D5 (GPIO14)
• žuto do D6 (GPIO12)
• zelena do D7 (GPIO13)
• uzemljen na GND (upravo sam odabrao jedan od GND pina NodeMCU -a)

… i zatvorio sam poklopac. Žice koje sam odabrao bile su prilično dugačke pa sam imao malih problema staviti ih sve u malu kutiju, ali nekako sam to uspio.

Korak 6: Poklopac svjetla

Nisam mogao pronaći nikakva gotova rješenja poput omota za svjetla - nekakve kutije od bombona. Stoga sam ih odlučio ručno izgraditi samo izrezivanjem kutije s papira.

Veličina kutije koju sam odabrao bila je: 20 mm x 15 mm x 85 mm.

Izrezao sam rupe tako da sam izrezao svojevrsne "zvijezde" na odgovarajućim mjestima gdje su LED diode bile postavljene. Zalijepila sam ih dvostranom ljepljivom trakom.

Za prekrivanje prozirnih stupova možete upotrijebiti neki trajni marker, neprozirnu ljepljivu traku, … Koristio sam crne slamke za piće koje sam rezao od kraja do kraja. Zatim sam pokrio stupove.

Bio sam više nego sretan zbog konačnog rezultata.

Korak 7: Softver

Postoji mnogo pristupa koji ukazuju na trenutno stanje izrade. Implementirao sam takvo ponašanje:

Crveno ili zeleno svjetlo svijetli kada gradnja propadne ili u skladu s tim prolazi. Žuto svjetlo treperi svaki put kada se uputi HTTP poziv i stalno se uključuje kada se plan trenutno gradi.

Možete jednostavno promijeniti implementaciju prema svojim potrebama - pokušajte eksperimentirati i provjerite što odgovara vama i/ili vašem timu.

Morate postaviti kôd prije nego što ga postavite na svoj NodeMCU. Morate postaviti maksimalno 2 WiFisa.

Također morate postaviti svoj korisnički token. Da biste dobili API token, kliknite svoje korisničko ime gore desno u Jenkinsu, a zatim Konfiguracija. Možete pronaći gumb "Prikaži API token". Da biste izgradili osnovnu vrijednost autentifikacije, stvorite niz pomoću uzorka:

USER_NAME: API_TOKEN

a zatim ga kodirajte pomoću Base64. Npr. za gornji lažni niz trebali biste dobiti vrijednost Base64:

VVNFUl9OQU1FOkFQSV9UT0tFTg ==

Morate također postaviti putove vašeg Jenkins hosta, porta i 2 posla.

Nakon ovog postavljanja i učitavanja skice - spremni ste za korištenje semafora.

Kod je dostupan i na GitHubu.

Korak 8: Posljednje riječi

Za uključivanje uređaja samo ga priključite u bilo koju USB utičnicu. Koristi WiFi povezivanje za pristup Internetu, tako da je svaka ispravna USB utičnica u redu - bilo na računalu ili na punjaču. Nakon pokretanja i povezivanja na WiFi, vaši će semafori početi prikazivati trenutni status izrade.

Smatram da je ovaj semafor vrlo koristan. Stoje pored mojih monitora u uredu i kad god se upali crveno svjetlo - odmah to primijetim. Ne moram gubiti vrijeme da provjerim statuse izrade izravno na Jenkinsu.

Jedno poboljšanje moglo bi se postići korištenjem neke igračke na semaforu umjesto da se sama izgradi od nule (smeće?).

Nadam se da ćete pronaći inspiraciju za izradu vlastitih Jenkinsovih integriranih semafora.