Üzembe helyezés a Zinnector® használatával: összekapcsolás, ellenőrzés, feltöltés

Amint egy projekt helyileg már fut, négy paranccsal éles webhelyre juttatható a Zinn Digital® tárhelyén: bejelentkezés, a projekt összekapcsolása egy tárhelyslottal, az ellenőrzés (pre-flight) áttekintése és a push. Ez a cikk végigvezeti Önt mindegyiken, bemutatja a kimenetüket, valamint azokat a parancsokat, amelyekre ezt követően szüksége lehet — újratelepítések, telepítési előzmények és buildnaplók.

Bejelentkezés API-kulccsal

Hozzon létre egy kulcsot a vezérlőpulton a Settings → API keys menüpont alatt, majd:

zinnector login

A kulcsot egy bekérőmezőbe kell beírni — a parancssorban soha nem fogadja el a rendszer, így nem kerülhet be a shell-előzményekbe vagy a folyamatlistába. CI-környezetben csővezetéken keresztül adja át: echo "$ZINN_API_KEY" | zinnector login --profile ci, vagy állítsa be a ZINNECTOR_TOKEN változót, és hagyja ki teljesen a login lépést. A kulcs ellenőrzése a tárolás előtt megtörténik, a tárolása pedig 600-as fájljogosultsággal történik. A zinnector whoami --scopes megmutatja, melyik szervezethez jelentkezett be, és milyen jogosultságokkal rendelkezik a kulcs; a tesztkörnyezeti kulcsok megfelelő jelölést kapnak.

A projekt összekapcsolása egy slottal

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

A link parancs beírja a webhely azonosítóját a zinnector.json fájlba, és – hacsak nem adja meg a --no-repo kapcsolót – összekapcsolja a projekt távoli git-tárhelyét a platformon lévő webhellyel, így egy push parancs automatikusan telepíti azt. Commitálja a zinnector.json fájlt: így az a munkatársa, aki klónozza a tárolót, külön tájékoztatás nélkül is ugyanoda fog telepíteni. A fájl nem tartalmaz titkos adatot.

Az ellenőrzés (pre-flight) áttekintése

zinnector check

Ez az a parancs, amiért a CLI létezik. Összehasonlítja a projektet azzal a slottal, amelyre a telepítés történni fog, és kiír minden eltérést — valamint minden olyan összehasonlítást, amelyet nem tudott elvégezni:

• PHP-verzió, ahol a főverzió-eltérés besorolása magas, mivel ez biztosan működési hibát okoz a webhelyen, az alverzió-eltérés besorolása pedig alacsonyabb, mivel ha mindent kritikusnak minősítenénk, a felhasználók megszoknák a figyelmeztetések figyelmen kívül hagyását.
• Hogy a slot képes-e átváltani arra a verzióra, amelyen a build készült, hogy a slot PHP-verziója túl van-e az életciklusa végén, és hogy a gép alkalmazta-e a verziót, vagy csupán az utasítást kapta meg rá.
• A projekt mérete és fájlszáma a sloton ténylegesen rendelkezésre álló lemezterülethez és inode-tartalékhoz viszonyítva — egy WordPress fa fájlszáma úgy is elérheti a limitet, hogy közben jóval a lemezterület-korlát alatt marad.
• A két oldalon lévő WordPress-verziók, hogy a slot befejezte-e a provizionálást, és hogy van-e összekapcsolt tároló, ahová a push történhet.

Figyelmeztet, de soha nem blokkol. Minden megállapítás felülbírálható a zinnector push --force paranccsal, mivel Ön olyan részleteket is tudhat a saját webhelyéről, amelyeket egy ellenőrző nem ismerhet. Az el nem végezhető összehasonlítások státusza ismeretlen, soha nem minősülnek sikeresnek, és az összesítés mindig jelzi a számukat. Alapértelmezés szerint a helyi PHP-verzió a zinnector.json fájlban deklarált verzió; a --probe kapcsoló elindítja a helyi futtatókörnyezetet, és közvetlenül méri azt. A --strict kapcsoló hatására ismeretlen státuszok esetén is nem nulla hibakóddal lép ki, ami a CI-kapuk elvárása.

Push

zinnector push

A push lefuttatja az ellenőrzést, elküldi a commitokat, elindítja a telepítést, és figyelemmel kíséri annak befejezését, kiírva a végső állapotot és a telepített commitot. A --dry-run a telepítésen kívül mindent végrehajt; a --no-wait elindítja azt, majd kilép; a --no-git git push nélkül telepíti mindazt, ami a platformon már rendelkezésre áll. Ha a telepített commit nem azonos a most elküldöttel, azt a rendszer jelzi.

Ha valami hiba történik

zinnector deploys example.com        # telepítési előzmények — állapot, commit, indító, üzenet
zinnector logs example.com --build   # a legutóbbi telepítés buildnaplója
zinnector logs example.com --error   # a webhely hibanaplója
zinnector deploy example.com         # a platformon már elérhető verzió újratelepítése
zinnector ai "why is my deploy failing?"

A zinnector ai a platformon fut az Ön saját fiókjához kapcsolódva, így ugyanazokat a telepítési előzményeket és naplókat látja. Egy projekten belülről a projekt szerkezetét küldi el — könyvtárneveket, verziókat és a webhelyazonosítót —, de fájltartalmakat soha.

Kapcsolódó anyagok

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