Implementiranje uz Zinnector®: povežite, provjerite, pošaljite

Jednom kada projekt počne raditi lokalno, četiri naredbe vode ga do aktivne web-lokacije na poslužiteljskom okruženju Zinn Digital®: prijava, povezivanje projekta s utorom za web-lokaciju, čitanje rezultata provjere prije izvođenja i slanje. Ovaj članak vodi kroz svaku od njih, ono što ispisuju te naredbe koje ćete koristiti kasnije – ponovna objavljivanja, povijest objavljivanja i zapisnike izgradnje.

Prijavite se pomoću API ključa

Kreirajte ključ na nadzornoj ploči pod Postavke → API ključevi, a zatim:

zinnector login

Ključ se upisuje na upit – nikada se ne prihvaća u naredbenom retku, tako da ne može završiti u povijesti vaše ljuske (shell) ili popisu procesa. U CI-ju ga proslijedite cijevi (pipe): echo "$ZINN_API_KEY" | zinnector login --profile ci, ili postavite ZINNECTOR_TOKEN i u potpunosti preskočite login. Ključ se provjerava prije pohrane i sprema se s dopuštenjima datoteke 600. zinnector whoami --scopes prikazuje organizaciju u koju ste prijavljeni i dopuštenja koja ključ ima; ključ u okruženju za testiranje (sandbox) označen je kao takav.

Povežite projekt s utorom

zinnector link                                   # odaberite web-lokaciju s popisa
zinnector link example.com --repo acme/site --branch main

link zapisuje ID web-lokacije u datoteku zinnector.json i, osim ako ne proslijedite --no-repo, povezuje git udaljenu lokaciju projekta s web-lokacijom na platformi tako da je slanje (push) objavljuje. Učinite commit datoteke zinnector.json: kolega koji klonira spremište tada objavljuje na isto mjesto bez potrebe za dodatnim objašnjenjima. Ona ne sadrži nikakve tajne podatke.

Pročitajte provjeru prije izvođenja

zinnector check

Ovo je naredba zbog koje sučelje naredbenog retka (CLI) i postoji. Ona uspoređuje vaš projekt s utorom na koji će biti poslan i ispisuje svaku neusklađenost – kao i svaku usporedbu koju nije mogla izvršiti:

• PHP verzija, pri čemu je razlika u glavnoj verziji ocijenjena kao visoka jer pouzdano ruši web-lokaciju, dok je manja razlika ocijenjena nižom ocjenom, jer ocjenjivanje svega kao kritičnog uči ljude da preskaču upozorenje.
• Može li utor prebaciti na verziju na kojoj ste gradili, je li PHP utora prošao kraj životnog vijeka i je li stroj primijenio verziju ili mu je to samo rečeno.
• Veličina i broj datoteka vašeg projekta u odnosu na prostor na disku i preostali slobodni prostor inoda na utoru – WordPress stablo može ostati bez datoteka iako je znatno ispod ograničenja diska.
• WordPress verzije sa svake strane, je li utor završio s pripremom i je li spremište povezano za slanje.

Ona upozorava; nikada ne blokira. Svaki se nalaz može nadjačati s zinnector push --force, jer vi znate stvari o vlastitoj web-lokaciji koje alat za provjeru ne zna. Usporedba koja se nije mogla izvršiti prijavljuje se kao nepoznato, nikada kao uspješna, a sažetak uvijek navodi koliko ih je bilo. Prema zadanim postavkama lokalna PHP verzija je ona deklarirana u zinnector.json; --probe pokreće lokalno izvođenje i umjesto toga ga mjeri. --strict završava s kodom greške (non-zero) i za nepoznate stavke, što je ono što CI vrata traže.

Slanje (Push)

zinnector push

push pokreće provjeru prije izvođenja, šalje vaše commite, pokreće objavu i prati je do završetka, ispisujući konačni status i objavljeni commit. --dry-run radi sve osim objave; --no-wait pokreće je i izlazi; --no-git objavljuje ono što platforma već ima bez slanja. Ako objavljeni commit nije onaj koji je upravo poslan, to se ispisuje.

Kada nešto pođe po zlu

zinnector deploys example.com        # povijest objavljivanja – status, commit, pokretač, poruka
zinnector logs example.com --build   # zapisnik izgradnje najnovije objave
zinnector logs example.com --error   # zapisnik pogrešaka web-lokacije
zinnector deploy example.com         # ponovno objavi ono što platforma već ima
zinnector ai "why is my deploy failing?"

zinnector ai radi na platformi za vaš vlastiti račun, tako da može vidjeti istu povijest objavljivanja i zapisnike. Unutar projekta šalje oblik projekta – nazive direktorija, verzije i ID web-lokacije – i nikada sadržaj datoteka.

Povezano

• Početak rada · Lokalni razvoj · Referenca naredbi · Rješavanje problema