Implementare cu Zinnector®: conectați, verificați, trimiteți

Odată ce un proiect rulează local, patru comenzi îl transferă pe un site live pe găzduirea Zinn Digital®: conectați-vă, asociați proiectul la un slot de găzduire, citiți verificarea preliminară și efectuați push. Acest articol parcurge fiecare etapă, ceea ce afișează aceasta și comenzile pe care le utilizați ulterior — redeploy-uri, istoricul de deploy și jurnalele de compilare.

Conectați-vă cu o cheie API

Creați o cheie în panoul de control la Settings → API keys, apoi:

zinnector login

Cheia este introdusă la un prompt — nu este acceptată niciodată pe linia de comandă, astfel încât nu poate ajunge în istoricul shell-ului sau într-o listă de procese. În CI, transmiteți-o prin pipe: echo "$ZINN_API_KEY" | zinnector login --profile ci, sau setați ZINNECTOR_TOKEN și omiteți complet login. Cheia este verificată înainte de a fi stocată și este salvată cu modul de fișier 600. zinnector whoami --scopes arată organizația în care sunteți conectat și permisiunile pe care le are cheia; o cheie de tip sandbox este etichetată corespunzător.

Asociați proiectul la un slot

zinnector link                                   # alegeți un site dintr-o listă
zinnector link example.com --repo acme/site --branch main

link scrie ID-ul site-ului în zinnector.json și, dacă nu transmiteți --no-repo, conectează git remote-ul proiectului la site-ul de pe platformă, astfel încât o operațiune de push să declanșeze deploy-ul. Includeți zinnector.json într-un commit: un coleg care clonează depozitul va efectua apoi deploy în același loc fără indicații suplimentare. Acesta nu conține niciun secret.

Citiți verificarea preliminară

zinnector check

Aceasta este comanda pentru care există CLI-ul. Compară proiectul dumneavoastră cu slotul pe care urmează să fie implementat și afișează fiecare neconcordanță — precum și fiecare comparație pe care nu a putut să o realizeze:

• Versiunea PHP, cu o diferență de versiune majoră clasificată ca ridicată, deoarece întrerupe în mod cert funcționarea site-ului, și o diferență minoră clasificată mai jos, deoarece clasificarea tuturor elementelor ca fiind critice determină utilizatorii să ignore avertismentul.
• Dacă slotul poate comuta la versiunea pe care ați dezvoltat, dacă versiunea de PHP a slotului este depășită (past end of life) și dacă mașina a aplicat versiunea sau doar a primit instrucțiunea.
• Dimensiunea și numărul de fișiere ale proiectului dumneavoastră raportate la spațiul liber pe disc și de inode-uri rămas efectiv pe slot — o structură WordPress poate rămâne fără fișiere chiar dacă este mult sub limita de disc.
• Versiunile WordPress de pe fiecare parte, dacă slotul a finalizat provizionarea și dacă este conectat un depozit către care să se facă push.

Avertizează; nu blochează niciodată. Fiecare rezultat poate fi suprascris cu zinnector push --force, deoarece știți detalii despre propriul site pe care un instrument de verificare nu le cunoaște. O comparație care nu a putut fi efectuată este raportată ca necunoscută, niciodată ca reușită, iar rezumatul indică întotdeauna câte au fost. În mod implicit, versiunea PHP locală este cea declarată în zinnector.json; --probe pornește mediul de execuție local și o măsoară direct. --strict returnează un cod de ieșire diferit de zero și pentru necunoscute, ceea ce este util pentru o etapă de control CI.

Push

zinnector push

push rulează verificarea preliminară, trimite commit-urile dumneavoastră, declanșează deploy-ul și îl monitorizează până la finalizare, afișând starea finală și commit-ul implementat. --dry-run efectuează toate operațiunile cu excepția deploy-ului; --no-wait îl declanșează și iese; --no-git implementează ceea ce platforma deține deja, fără push. Dacă commit-ul implementat nu este cel care tocmai a fost trimis prin push, comanda semnalează acest lucru.

Când ceva nu funcționează corect

zinnector deploys example.com        # istoricul de deploy — stare, commit, declanșator, mesaj
zinnector logs example.com --build   # jurnalul de compilare al celui mai recent deploy
zinnector logs example.com --error   # jurnalul de erori al site-ului
zinnector deploy example.com         # reimplementează ceea ce platforma deține deja
zinnector ai "why is my deploy failing?"

zinnector ai rulează pe platformă asociat contului dumneavoastră, astfel încât poate vedea același istoric de deploy și aceleași jurnale. Din interiorul unui proiect, acesta trimite structura proiectului — numele directoarelor, versiunile și ID-ul site-ului — și niciodată conținutul fișierelor.

Articole conexe

• Ghid introductiv · Dezvoltare locală · Referință comenzi · Depanare