Uvođenje u rad sa Zinnector®-om: povežite, proverite, pošaljite

Kada se projekat pokrene lokalno, četiri komande ga vode do live sajta na Zinn Digital® hostingu: prijava, povezivanje projekta sa hosting slotom, čitanje pre-flight provere i slanje (push). Ovaj članak vodi kroz svaku od njih, šta one ispisuju i komande koje ćete koristiti kasnije – ponovna postavljanja (redeploys), istoriju postavljanja i build logove.

Prijavite se pomoću API ključa

Kreirajte ključ na kontrolnoj tabli pod Settings → API keys, a zatim:

zinnector login

Ključ se unosi na upit – on se nikada ne prihvata u komandnoj liniji, tako da ne može završiti u istoriji vašeg šella ili na listi procesa. U CI okruženju, prosledite ga preko pipe-a: echo "$ZINN_API_KEY" | zinnector login --profile ci, ili podesite ZINNECTOR_TOKEN i u potpunosti preskočite login. Ključ se proverava pre nego što se sačuva, i čuva se sa dozvolama fajla 600. zinnector whoami --scopes prikazuje organizaciju na koju ste prijavljeni i koje dozvole ključ poseduje; sandbox ključ je označen kao takav.

Povežite projekat sa slotom

zinnector link                                   # izaberite sajt sa liste
zinnector link example.com --repo acme/site --branch main

link upisuje ID sajta u zinnector.json i, osim ako ne prosledite --no-repo, povezuje git remote projekta sa sajtom na platformi tako da ga push postavlja. Commit-ujte zinnector.json: kolega koji klonira repozitorijum tada postavlja sajt na isto mesto bez dodatnih objašnjenja. On ne sadrži nikakve tajne podatke.

Pročitajte pre-flight proveru

zinnector check

Ovo je komanda zbog koje CLI i postoji. Ona upoređuje vaš projekat sa slotom na koji treba da bude postavljen i ispisuje svaku neusklađenost – kao i svako poređenje koje nije moglo da se obavi:

• PHP verziju, pri čemu je razlika u glavnoj (major) verziji ocenjena kao visoka (high) jer pouzdano ruši sajt, dok je manja razlika ocenjena niže, pošto ocenjivanje svega kao kritičnog uči ljude da preskaču upozorenja.
• Da li slot može da pređe na verziju na kojoj ste gradili, da li je PHP verzija na slotu prešla kraj životnog ciklusa (end of life) i da li je mašina primenila verziju ili joj je to samo rečeno.
• Veličinu i broj fajl-ova vašeg projekta u odnosu na preostali prostor na disku i inode limit koji su zapravo ostali na slotu – WordPress stablo može da ostane bez fajlova iako je daleko ispod limita za disk.
• WordPress verzije sa svake strane, da li je slot završio sa podešavanjem (provisioning) i da li je repozitorijum povezan za slanje.

Ona upozorava; nikada ne blokira. Svaki nalaz se može ignorisati pomoću zinnector push --force, jer vi znate stvari o sopstvenom sajtu koje proveravač ne zna. Poređenje koje nije moglo da se obavi prijavljuje se kao nepoznato (unknown), nikada kao uspešno, i u sumarnom pregled se uvek navodi koliko ih je bilo. Podrazumevano, lokalna PHP verzija je ona koja je deklarisana u zinnector.json; --probe pokreće lokalno okruženje i meri ga umesto toga. --strict prekida rad sa kodom greške (non-zero) i kod nepoznatih stavki, što je ono što CI mehanizmi zahtevaju.

Slanje (Push)

zinnector push

push pokreće pre-flight proveru, šalje vaše commit-ove, pokreće postavljanje i prati ga do završetka, ispisujući konačni status i postavljeni commit. --dry-run obavlja sve osim postavljanja; --no-wait ga pokreće i izlazi; --no-git postavlja ono što platforma već ima bez slanja. Ako postavljeni commit nije onaj koji je upravo poslat, to biva naglašeno.

Kada nešto pođe po zlu

zinnector deploys example.com        # istorija postavljanja – status, commit, okidač, poruka
zinnector logs example.com --build   # build log najnovijeg postavljanja
zinnector logs example.com --error   # error log sajta
zinnector deploy example.com         # ponovno postavljanje onoga što platforma već ima
zinnector ai "why is my deploy failing?"

zinnector ai se pokreće na platformi u okviru vašeg naloga, tako da može da vidi istu istoriju postavljanja i logove. Unutar projekta, on šalje strukturu projekta – imena direktorijuma, verzije i ID sajta – a nikada sadržaj fajlova.

Povezano

• Početak rada · Lokalni razvoj · Referenca komandi · Rešavanje problema