Nasazení pomocí Zinnector®: propojit, zkontrolovat, odeslat

Jakmile projekt běží lokálně, čtyři příkazy ho přenesou na živý web na hostingu Zinn Digital®: přihlášení, propojení projektu s hostingovým slotem, kontrola před startem a nahrání (push). Tento článek vás provede každým z nich, tím, co vypisují, a příkazy, které využijete následně – opětovnými nasazeními, historií nasazení a protokoly sestavení.

Přihlášení pomocí API klíče

Vytvořte klíč v administraci v sekci Nastavení → API klíče a poté zadejte:

zinnector login

Klíč se zadává na výzvu – nikdy není akceptován v příkazovém řádku, takže nemůže skončit v historii vašeho shellu ani v seznamu procesů. V CI jej zadejte přes rouru: echo "$ZINN_API_KEY" | zinnector login --profile ci, nebo nastavte ZINNECTOR_TOKEN a login zcela vynechte. Klíč je před uložením ověřen a uloží se s oprávněním souboru 600. zinnector whoami --scopes ukazuje, ke které organizaci jste přihlášeni a jaká oprávnění klíč nese; klíč pro sandbox je takto označen.

Propojení projektu se slotem

zinnector link                                   # výběr webu ze seznamu
zinnector link example.com --repo acme/site --branch main

Příkaz link zapíše ID webu do souboru zinnector.json a, pokud nezadáte --no-repo, propojí git remote projektu s webem na platformě, aby jej příkaz push mohl nasadit. Zacommitujte zinnector.json: kolega, který klonuje repozitář, pak může nasadit na stejné místo bez nutnosti dalších instrukcí. Neobsahuje žádné citlivé údaje.

Kontrola před startem

zinnector check

Toto je příkaz, pro který CLI existuje. Porovnává váš projekt se slotem, kam má být nasazen, a vypisuje každou neshodu – a každé porovnání, které se nepodařilo provést:

• Verze PHP, přičemž mezera v hlavní verzi je hodnocena jako vysoká (high), protože spolehlivě rozbije web, a menší mezera je hodnocena níže, protože hodnocení všeho jako kritického vede lidi k přehlížení varování.
• Zda slot může přepnout na verzi, na které jste stavěli, zda je PHP slotu po konci životnosti a zda stroj verzi aplikoval, nebo mu to bylo pouze řečeno.
• Velikost projektu a počet souborů v porovnání s diskovým prostorem a volnými inody, které na slotu ve skutečnosti zbývají – strom WordPress může vyčerpat soubory, přestože je hluboko pod limitem disku.
• Verze WordPress na každé straně, zda slot dokončil zřizování a zda je k němu připojen repozitář pro nahrávání.

Varuje, nikdy neblokuje. Každé zjištění lze přepsat pomocí zinnector push --force, protože o svém vlastním webu víte věci, které kontrolní nástroj nezná. Porovnání, které nebylo možné provést, je nahlášeno jako neznámé (unknown), nikdy jako úspěšné, a souhrn vždy uvádí, kolik jich bylo. Ve výchozím nastavení je lokální verze PHP ta, která je deklarována v souboru zinnector.json; --probe spustí lokální prostředí a místo toho ji změřit. --strict ukončí program nenulovým kódem i v případě neznámých položek, což vyžaduje CI brána.

Nahrání (Push)

zinnector push

Příkaz push spustí kontrolu před startem, odešle vaše commity, spustí nasazení a sleduje ho až do dokončení, přičemž vypíše konečný stav a nasazený commit. --dry-run provede vše kromě samotného nasazení; --no-wait jej spustí a ukončí se; --no-git nasadí to, co již platforma má, bez odesílání změn. Pokud nasazený commit není ten, který byl právě odeslán, upozorní na to.

Když se něco pokazí

zinnector deploys example.com        # historie nasazení – stav, commit, spouštěč, zpráva
zinnector logs example.com --build   # protokol sestavení nejnovějšího nasazení
zinnector logs example.com --error   # chybový protokol webu
zinnector deploy example.com         # opětovné nasazení toho, co již platforma má
zinnector ai "proč mé nasazení selhává?"

zinnector ai běží na platformě proti vašemu vlastnímu účtu, takže vidí stejnou historii nasazení a protokoly. Zevnitř projektu odešle strukturu projektu – názvy adresářů, verze a ID webu – a nikdy obsah souborů.

Související

• Začínáme · Lokální vývoj · Seznam příkazů · Řešení problémů