cirruslabs / cirrus-cli

Cirrus CLI este un instrument pentru executarea sarcinilor containerizate reproductibil in orice mediu. Cel mai frecvent, sarcinile Cirrus sunt utilizate ca parte a fluxurilor de lucru de integrare continua, dar pot fi folosite si ca parte a procesului de dezvoltare locala ca inlocuire ermetica a scripturilor de ajutor / Makefiles. Cirrus CLI va executa sarcinile la nivel local in acelasi mod in care sunt executate in CI sau pe computerul colegului dvs. Imuabilitatea containerelor asigura ca sarcinile vor fi executate in acelasi mod de ani de zile, indiferent de ce versiuni de pachete veti avea la nivel local.

Instalare

• Homebrew
• Binar pre-construit
• Golang
• Integrari CI
  • Actiuni GitHub
  • Travis CI
  • Cercul CI
  • TeamCity
  • Cloud Build
  • Cirrus CI

Utilizare

Cirrus CLI reutilizeaza acelasi format de configurare YAML ca Cirrus CI care permite reutilizarea unei liste mari de exemple create de comunitatea Cirrus CI.

Nota: Cirrus CLI poate fi utilizat in orice mediu care are instalat Docker sau Podman. Poate fi laptopul dvs. sau orice sistem CI pe care il aveti, cum ar fi Jenkins, GitHub Actions, Travis CI etc. Cu Cirrus CLI nu mai este o cerinta sa utilizati Cirrus CI pentru a beneficia de formatul de configurare Cirrus pe care il avem (Cirrus Labs) creat atat de mult timp si cu adevarat mandru de.

Iata un exemplu de fisier de configurare .cirrus.yml pentru testarea unei aplicatii Go cu mai multe versiuni Go:

Rularea sarcinilor Cirrus

Pentru a rula sarcini Cirrus, pur si simplu comutati la un director in care se afla .cirrus.yml si rulati:

In mod implicit, directorul de lucru va fi resincronizat intr-un container respectand configuratia .gitignore. Acest lucru asigura faptul ca Sarcinile Cirrus sunt executate dintr-o stare curata numai cu modificari ale codului sursa.

In cazul in care rsincronizarea intregului director de lucru este prea costisitoare, puteti trece un semnalizator –dirty care va duce la efectuarea tuturor operatiunilor fata de directorul de lucru real (si nu la copierea rsincronizata):

Deoarece majoritatea linterelor si instrumentelor de analiza a codului sunt doar de citire prin natura lor, nu este nevoie de masuri de precautie suplimentare si rsincronizarea potential costisitoare poate fi evitata in siguranta.

De asemenea, este posibil sa rulati o anumita sarcina dupa nume:

Sau treceti cateva variabile de mediu suplimentare cu steagul -e:

Nota: Cirrus CLI accepta doar instante de containere Linux in acest moment, inclusiv Dockerfile ca o caracteristica de mediu CI.

Validarea configuratiei Cirrus

Pentru a valida o configuratie Cirrus, pur si simplu comutati la un director in care se afla .cirrus.yml si rulati:

Caching

In mod implicit, Cirrus CLI stocheaza artefacte blob produse de instructiunile cache in folderul de date cache specific utilizatorului. Similar cu Cirrus Cloud, CLI poate utiliza un server HTTP in cache pentru partajarea mai eficienta a artefactelor cache intre sarcinile executate pe diferite gazde fizice.

Memorarea in cache a serverului HTTP ar trebui sa accepte un singur punct final / <key> REST cu metode PUT, GET si HEAD disponibile pentru incarcarea, descarcarea si verificarea disponibilitatii unui artefact stocat in cache sub cheia <key>. Exista implementari de referinta ale unor astfel de servere HTTP pentru Google Cloud Storage si AWS S3 si Azure’s Blob Storage.

Pentru a incepe sa utilizati propriul server de cache HTTP pur si simplu treceti numele de gazda ca CIRRUS_HTTP_CACHE_HOST pentru a rula comanda:

Securitate

Cirrus CLI isi propune sa ruleze in medii diferite, dar in unele medii alegem sa oferim mai multa utilizare la costul unor compromisuri de securitate:

• SELinux
  • atat containerul de sarcini, cat si containerul de ajutor (care copiaza directorul proiectului intr-un volum de container per sarcina utilizand rsync) ruleaza neconfigurat

Va rugam sa deschideti o problema daca cazul dvs. de utilizare necesita o abordare diferita.

FAQ

Care este relatia dintre Cirrus CI si Cirrus CLI?

Cirrus CI a fost lansat la inceputul anului 2018 cu ideea de a aduce ceva inovatie in spatiul CI. Multe lucruri s-au schimbat in spatiul CI-as-a-service de atunci, dar Cirrus CI a initiat multe idei in spatiul CI-as-a-service, inclusiv facturarea pe secunda si suport pentru Linux, Windows si macOS, impreuna.

In ultimii doi ani si jumatate am auzit doar feedback pozitiv despre formatul de configurare YAML al Cirrus CI. Utilizatorilor le-a placut cat de concisa arata configuratia lor si ca este usor de argumentat.

Un alt feedback pe care l-am auzit de la utilizatori a fost ca este greu sa migrezi de la un CI la altul. Este necesar sa rescrieti configuratiile CI dintr-un format in altul, care practic se blocheaza inca intr-un alt furnizor.

Si acum, in 2020, cu Cirrus CLI incercam sa rezolvam problema „blocarii furnizorului” popularizand formatul de configurare Cirrus si construind comunitatea in jurul acestuia. Ramaneti la curent cu urmatoarea optiune de utilizare a sabloanelor Starlark in loc de YAML!

Ganditi-va la Cirrus CLI ca la un executor al Cirrus Tasks pe o singura masina numai in containere Docker pentru un scenariu simplu CI. Si Cirrus CI ca optiune pentru cazuri mai specifice in care Sarcinile Cirrus pot fi executate in containere si VM utilizand o varietate de servicii de calcul acceptate sau folosind o infrastructura gestionata cu facturare pe secunda.