Mradi unapofanya kazi ndani ya kifaa chako, amri nne huupeleka kwenye tovuti inayofanya kazi kwenye upangishaji wa Zinn Digital®: ingia, unganisha mradi kwenye nafasi ya upangishaji, soma ukaguzi wa awali, na kisha sukuma. Makala haya yanaelezea kila hatua, kile inachoonyesha, na amri unazotumia baadaye — kusambaza upya, historia ya usambazaji na kumbukumbu za uundaji.
Ingia ukitumia ufunguo wa API
Tengeneza ufunguo kwenye dashibodi chini ya Mipangilio → Vifunguo vya API, kisha:
zinnector login
Ufunguo huandikwa kwenye kiolesura cha amri — haukubaliwi kamwe kwenye mstari wa amri, kwa hivyo hauwezi kuishia kwenye historia ya kompyuta yako au orodha ya michakato. Kwenye mifumo ya CI, uingize kwa bomba: echo "$ZINN_API_KEY" | zinnector login --profile ci, au weka ZINNECTOR_TOKEN na uruke hatua ya login kabisa. Ufunguo huthibitishwa kabla ya kuhifadhiwa, na huhifadhiwa ukiwa na hali ya faili ya 600. zinnector whoami --scopes inaonyesha ni shirika gani umeingia, na ruhusa ambazo ufunguo huo unao; ufunguo wa majaribio (sandbox) huwekwa lebo kama ufunguo wa aina hiyo.
Unganisha mradi kwenye nafasi
zinnector link # chagua tovuti kutoka kwenye orodha
zinnector link example.com --repo acme/site --branch main
link huandika kitambulisho cha tovuti ndani ya zinnector.json na, isipokuwa ukitumia --no-repo, huunganisha hifadhi ya mbali ya git ya mradi huo kwenye tovuti iliyo kwenye jukwaa ili hatua ya kusukuma iweze kuisambaza. Wasilisha (commit) zinnector.json: mfanyakazi mwenzako anayenakili hazina hiyo kisha anasambaza kwenye eneo lile lile bila kuambiwa. Haina siri yoyote.
Soma ukaguzi wa awali
zinnector check
Hii ndiyo amri ambayo CLI ilitengenezwa kwa ajili yake. Inalinganisha mradi wako na nafasi inayokaribia kusambazwa na kuonyesha kila kutolingana — na kila ulinganisho ambao haikuweza kuufanya:
- Toleo la PHP, ikiwa na tofauti ya toleo kuu lililopewa daraja la juu kwa sababu mara nyingi huharibu tovuti, na tofauti ndogo ikikadiriwa chini, kwa sababu kukadiria kila kitu kama hatari hufanya watu kupuuza maonyo.
- Ikiwa nafasi inaweza kubadili toleo uliloundia mradi, ikiwa PHP ya nafasi hiyo imepita mwisho wa matumizi, na ikiwa mashine imetekeleza toleo hilo au iliambiwa tu.
- Ukubwa na idadi ya faili za mradi wako dhidi ya nafasi ya diski na idadi ya faili (inode) iliyobaki kwenye nafasi hiyo — mpangilio wa WordPress unaweza kuishiwa na faili ukiwa bado chini ya kikomo cha diski.
- Matoleo ya WordPress kwa kila upande, ikiwa nafasi imemaliza maandalizi, na ikiwa hazina imeunganishwa ili kusukuma mabadiliko.
Inatoa maonyo; haizuii kamwe. Kila hitimisho linaweza kubatilishwa kwa zinnector push --force, kwa sababu unajua mambo kuhusu tovuti yako mwenyewe ambayo mfumo wa ukaguzi hauyajui. Ulinganisho ambao haukuweza kufanywa huripotiwa kama haijulikani, kamwe hauripotiwi kama imefaulu, na muhtasari daima huonyesha ni ngapi zilikuwepo. Kwa chaguo-msingi toleo la ndani la PHP ni lile lililotangazwa katika zinnector.json; --probe huwasha mazingira ya ndani na kuyapima badala yake. --strict huondoka na hitilafu kwenye mambo yasiyojulikana pia, jambo ambalo mfumo wa CI hulihitaji.
Sukuma
zinnector push
push hufanya ukaguzi wa awali, husukuma masahihisho yako (commits), huanzisha usambazaji na kuufuatilia hadi ukamilike, ikionyesha hali ya mwisho na rekodi ya mabadiliko iliyosambazwa. --dry-run hufanya kila kitu isipokuwa usambazaji; --no-wait huuanzisha na kuondoka; --no-git husambaza chochote ambacho jukwaa tayari linacho bila kusukuma. Ikiwa mabadiliko yaliyosambazwa si yale yaliyosukumwa punde, hukutaarifu.
Hitilafu inapotokea
zinnector deploys example.com # historia ya usambazaji — hali, rekodi ya mabadiliko, kichochezi, ujumbe
zinnector logs example.com --build # kumbukumbu ya uundaji ya usambazaji wa hivi majuzi zaidi
zinnector logs example.com --error # kumbukumbu ya hitilafu za tovuti
zinnector deploy example.com # sambaza upya kile ambacho jukwaa tayari linacho
zinnector ai "kwa nini usambazaji wangu unafeli?"
zinnector ai hufanya kazi kwenye jukwaa dhidi ya akaunti yako mwenyewe, kwa hivyo inaweza kuona historia ile ile ya usambazaji na kumbukumbu. Kutoka ndani ya mradi hutuma muundo wa mradi — majina ya folda, matoleo na kitambulisho cha tovuti — na kamwe haitumi yaliyomo kwenye faili.
Husika