Da zarar aiki ya fara aiki a na'urarku, umarni huɗu ke kai shi zuwa rukunin yanar gizo mai aiki a kan ɗaukar nauyin Zinn Digital®: shiga ciki, danganta aikin da wani gurbi na karɓar baƙuncin yanar gizo, karanta shirin pre-flight, sannan tura shi (push). Wannan maƙala tana bayyana kowannensu daki-daki, abin da yake fitarwa, da kuma umarnin da za ku yi amfani da su bayan haka — sake turawa, tarihin turawa da kuma rajistar ginawa (build logs).
Shiga ciki ta amfani da maɓallin API
Ƙirƙiri maɓalli a allon sarrafawa a ƙarƙashin Settings → API keys, sannan:
zinnector login
Ana rubuta maɓallin a wurin da aka buƙata — ba a taɓa karɓarsa a layin umarni ba, don haka ba zai iya ƙarewa a tarihin harsashin kwamfutarku ko jerin tsare-tsare ba. A cikin CI, tura shi ta ciki: echo "$ZINN_API_KEY" | zinnector login --profile ci, ko saita ZINNECTOR_TOKEN kuma ku tsallake login gaba ɗaya. Ana tantance maɓallin kafin a adana shi, kuma ana adana shi da yanayin fayil na 600. zinnector whoami --scopes yana nuna ƙungiyar da kuka shiga da kuma izinin da maɓallin ke ɗauke da shi; ana sanya wa maɓallin sandbox alama a matsayin haka.
Danganta aikin da wani gurbi
zinnector link # zaɓi rukunin yanar gizo daga jeri
zinnector link example.com --repo acme/site --branch main
link yana rubuta id na rukunin yanar gizon a cikin zinnector.json kuma, sai dai idan kun shigar da --no-repo, yana haɗa git remote na aikin da rukunin yanar gizon da ke kan dandamalin domin turawa ta sa a tura shi kai tsaye. Adana zinnector.json: abokin aiki da ya ɗauki kwafin ma'ajiyar (repository) zai iya turawa zuwa wuri guda ba tare da an gaya masa ba. Ba ya ɗauke da wani sirri.
Karanta shirin pre-flight
zinnector check
Wannan shi ne ainihin umarnin da CLI take nan dominsa. Yana kwatanta aikinku da gurbin da ake shirin tura shi kuma yana fitar da kowane rashin daidaito — da kuma duk wani kwatantawa da ya kasa yi:
- Sigar PHP, tare da babban giɓin siga da aka sanya wa matsayin high saboda a tabbace yana lalata rukunin yanar gizo, da ƙaramin giɓi da aka sanya wa matsayi mai ƙasa, saboda sanya wa komai matsayin mai haɗari yana koya wa mutane tsallake gargaɗin.
- Ko gurbin zai iya canzawa zuwa sigar da kuka yi aikin da ita, ko PHP na gurbin ya wuce ƙarshen rayuwarsa, da kuma ko na'urar ta yi amfani da sigar ko kuma kawai an gaya mata ne.
- Girma da adadin fayilolin aikinku idan aka kwatanta da faɗin diski da inode da suka rage a ainihin gurbin — bishiyar WordPress za ta iya ƙarewa fayiloli alhali ba ta kai iyakar diskinta ba.
- Sigogin WordPress a kowane ɓangare, ko gurbin ya gama tanadi, da kuma ko an haɗa ma'ajiya don turawa zuwa gare ta.
Yana ba da gargaɗi; ba ya taɓa dakatarwa. Ana iya tsallake kowane sakamako tare da zinnector push --force, saboda kun san abubuwa game da rukunin yanar gizonku waɗanda mai dubawa bai sani ba. Duk kwatancen da aka kasa yi ana bayar da rahotonsa a matsayin unknown, ba a taɓa bayar da shi a matsayin wanda ya yi nasara ba, kuma taƙaitaccen bayanin koyaushe yana faɗin adadinsu. Ta asali sigar PHP ta na'urarku ita ce wadda aka bayyana a cikin zinnector.json; --probe tana tada yanayin aiki na na'urar kuma ta auna shi a maimakon haka. --strict yana fitar da sakamako wanda ba sifili ba a kan abubuwan da ba a sani ba, wanda shi ne abin da shingiyar CI ke buƙata.
Tura (Push)
zinnector push
push yana gudanar da pre-flight, yana tura sauye-sauyenku (commits), yana tayar da aikin turawa tare da bin diddiginsa har zuwa gamawa, yana nuna matsayin ƙarshe da sauyin da aka tura. --dry-run yana yin komai ban da tura aikin kansa; --no-wait yana tayar da shi kuma ya fita; --no-git yana tura duk abin da dandamalin ke da shi a halin yanzu ba tare da tura sabbi ba. Idan sauyin da aka tura ba shi ne wanda aka gama turawa yanzu ba, yana faɗin haka.
Idan wani abu ya sami matsala
zinnector deploys example.com # tarihin turawa — matsayi, commit, abin da ya tayar, saƙo
zinnector logs example.com --build # rajistar ginawa na turawar da ta fi kusa
zinnector logs example.com --error # rajistar kuskure na rukunin yanar gizon
zinnector deploy example.com # sake tura abin da dandamali ke da shi a halin yanzu
zinnector ai "why is my deploy failing?"
zinnector ai yana aiki a kan dandamalin tare da asusunku, don haka yana iya ganin tarihin turawa da rajistar guda ɗaya. Daga cikin aiki yana aika tsarin aikin — sunayen kundayen adireshi, sigogi da id na rukunin yanar gizo — kuma ba ya taɓa aika abubuwan da ke cikin fayiloli.
Masu dangantaka