Telepítés a Zinnector® segítségével: összekapcsolás, ellenőrzés, küldés

Miután egy projekt helyben fut, négy parancs viszi át egy éles webhelyre a Zinn Digital® tárhelyen: a bejelentkezés, a projekt összekapcsolása egy tárhelyhelyhellyel, a repülés előtti ellenőrzés és a leküldés. Ez a cikk végigvezeti az egyes lépéseken, az általuk kiírt üzeneteken, valamint azon parancsokon, amelyeket utána használhat – újbóli üzembe helyezések, üzembe helyezési előzmények és buildnaplók.

Bejelentkezés API-kulccsal

Hozzon létre egy kulcsot a vezérlőpultban a Beállítások → API-kulcsok menüpont alatt, majd adja meg a következőt:

zinnector login

A kulcsot egy felszólításra kell beírni – a parancssorban soha nem fogadja el a rendszer, így az nem kerülhet be a shell-előzmények közé vagy a folyamatlistákba. CI környezetben irányítsa át csővezetéken keresztül: echo "$ZINN_API_KEY" | zinnector login --profile ci, vagy állítsa be a ZINNECTOR_TOKEN változót, és hagyja ki teljesen a login parancsot. A rendszer a tárolás előtt ellenőrzi a kulcsot, és a 600-as fájljogosultsággal menti el. A zinnector whoami --scopes parancs megmutatja, hogy melyik szervezetbe van bejelentkezve, és milyen jogosultságokkal rendelkezik a kulcs; a homokozókulcsok meg vannak jelölve.

A projekt összekapcsolása egy hellyel

zinnector link                                   # webhely kiválasztása listából
zinnector link example.com --repo acme/site --branch main

A link beírja a webhely azonosítóját a zinnector.json fájlba, és – hacsak nem adja meg a --no-repo kapcsolót – összeköti a projekt git-távoli elérését a platformon lévő webhellyel, így egy leküldés (push) üzembe helyezi azt. Végezze el a zinnector.json commitolását: az a kolléga, aki klónozza a tárolót, anélkül helyezheti üzembe az alkalmazást ugyanarra a helyre, hogy arra utasítást kapna. Ez nem tartalmaz titkos adatokat.

A repülés előtti ellenőrzés olvasása

zinnector check

Ez az a parancs, amiért a CLI létezik. Összehasonlítja a projektet azzal a hellyel, amelyre üzembe kívánják helyezni, és kiír minden eltérést – valamint minden olyan összehasonlítást, amelyet nem tudott elvégezni:

• PHP verzió, ahol a főverzióbeli eltérés magas besorolású, mivel az megbízhatóan hibásodást okoz egy webhelyen, a alverzióbeli eltérés pedig alacsonyabb besorolású, mivel ha mindent kritikusnak minősítenének, az arra tanítaná az embereket, hogy hagyják figyelmen kívül a figyelmeztetést.
• Hogy a hely át tud-e váltani arra a verzióra, amelyen a buildet készítette, hogy a hely PHP verziója túllépte-e a támogatási időszak végét, és hogy a gép alkalmazta-e a verziót, vagy csak kapott róla értesítést.
• A projekt mérete és fájlszáma a helyen ténylegesen maradt lemez- és inode-kapacitáshoz képest – egy WordPress fa kifogyhat a fájlokból úgy is, hogy jócskán a lemezkorlátja alatt van.
• A WordPress verziók mindkét oldalon, hogy a hely befejezte-e a kiépítést, és hogy csatlakozik-e tároló a leküldéshez.

Ez figyelmeztet; soha nem blokkol. Minden megállapítás felülbírálható a zinnector push --force paranccsal, mivel Ön jobban ismeri a saját webhelyét, mint egy ellenőrző eszköz. Az olyan összehasonlítást, amelyet nem lehetett elvégezni, ismeretlenként jelzi a rendszer, soha nem sikeresként, és az összegzés mindig megadja, hogy mennyi ilyen volt. Alapértelmezés szerint a helyi PHP verzió a zinnector.json fájlban meghatározott verzió; a --probe kapcsoló elindítja a helyi futtatókörnyezetet, és inkább méri azt. A --strict ismeretlenek esetén is nem nullás értékkel lép ki, amit egy CI-kapu megkövetel.

Leküldés (Push)

zinnector push

A push lefuttatja a repülés előtti ellenőrzést, leküldi a commitokat, elindítja az üzembe helyezést, és figyeli annak befejezését, majd kiírja a végső státuszt és az üzembe helyezett commitot. A --dry-run mindent elvégez az üzembe helyezés kivételével; a --no-wait elindítja azt és kilép; a --no-git üzembe helyezi azt, amivel a platform már rendelkezik, anélkül, hogy leküldést végezne. Ha az üzembe helyezett commit nem azonos a most lekülttel, a rendszer ezt jelzi.

Ha valami hiba történik

zinnector deploys example.com        # üzembe helyezési előzmények – státusz, commit, indító, üzenet
zinnector logs example.com --build   # a legutóbbi üzembe helyezés buildnaplója
zinnector logs example.com --error   # a webhely hibanaplója
zinnector deploy example.com         # annak újbóli üzembe helyezése, amivel a platform már rendelkezik
zinnector ai "why is my deploy failing?"

A zinnector ai a platformon fut az Ön saját fiókjához kapcsolódóan, így hozzáférhet ugyanezekhez az üzembe helyezési előzményekhez és naplókhoz. Egy projekten belül elküldi a projekt felépítését – a könyvtárneveket, verziókat és a webhelyazonosítót –, de a fájlok tartalmát soha.

Kapcsolódó

• Első lépések · Helyi fejlesztés · Parancsreference · Hibaelhárítás