Začať

Nasadenia, náhľady a návrat k predchádzajúcej verzii.

Ako sa pushe dostanú do prevádzky, náhľady vetiev, návrat k staršej verzii, príkaz pri vydaní pre migrácie, nastavenia zostavenia, deploy hooky, režim údržby a heslá pre náhľady.

4 MIN. ČÍTANIA

Keď už aplikácia beží, na zverejnenie zmien panel takmer nepotrebujete: pushnite do vetvy a nová verzia sa nasadí sama. Tento článok opisuje všetko okolo toho — kartu Nasadenia, Náhľady, kartu Procesy a niekoľko prepínačov v Nastaveniach.

Automatické nasadenie pri každom pushi

Každý push do vetvy aplikácie zostaví posledný commit a nasadí ho. Nová verzia sa spustí vedľa bežiacej a návštevníkov dostane až vtedy, keď odpovedá; ak sa nespustí, ďalej beží predchádzajúca verzia a dáme vám vedieť e-mailom (a cez Telegram, ak ho máte pripojený).

Push, ktorý príde, kým iné zostavenie ešte čaká vo fronte, sa k tomuto zostaveniu pridá, takže séria pushov nevytvorí dlhú frontu.

Vypnúť to môžete v Nastaveniach → Nasadiť každý push. Keď je to vypnuté, nasadzujete z panela, cez API alebo deploy hook.

Nasadenie z panela

Karta Nasadenia obsahuje všetky nasadenia: čo ich spustilo (push, panel, návrat k verzii, deploy hook), commit, ako dlho trvali a ich stav. Kliknutím na nasadenie zobrazíte jeho úplný log zostavenia.

Znova nasadiť ponúka dve možnosti:

  • Zostaviť posledný commit — vezme najnovší kód z vetvy a zostaví ho.
  • Znova nasadiť bežiacu verziu — použije zmenené premenné bez nového zostavenia. Použite to po úprave Premenných.

Ponuka vedľa tlačidla Otvoriť má tie isté dve akcie a navyše Reštartovať.

Návrat k predchádzajúcej verzii

Vrátiť sa môžete k ktorejkoľvek z posledných 5 úspešných verzií. Na karte Nasadenia kliknite pri požadovanej verzii na Vrátiť a potvrďte. Staršia verzia sa spustí vedľa aktuálnej a prevezme ju, keď odpovedá — nové zostavenie sa nerobí.

Návrat k verzii nevráti zmeny v databáze. Ak vydanie zmenilo štruktúru databázy, obnovte aj databázu — pozrite si Databázy.

Náhľady vetiev

Push do akejkoľvek inej vetvy dostane vlastný náhľad — samostatnú adresu, kde si zmeny overíte ešte pred zverejnením. Otvoríte ich na karte Náhľady.

  • Naraz najviac 3 náhľady, v cene.
  • Náhľad bez nových pushov počas 7 dní sa odstráni. Pri ďalšom pushi do tej vetvy sa vytvorí znova.
  • Náhľady dostanú len premenné určené pre ne — pozrite si Premenné prostredia.
  • Náhľady sa vytvárajú pre hlavnú službu projektu, nie pre jeho ostatné služby.

Heslo pre náhľady

Na karte Náhľady zvoľte Heslo pre náhľady → Vyžadovať heslo. Zadajte meno používateľa a heslo (aspoň 8 znakov). Odvtedy náhľady otvoria len ľudia s heslom; samotná aplikácia zostáva prístupná všetkým.

Príkaz pri vydaní (migrácie)

Karta Procesy → Príkaz pri vydaní. Spustí sa raz pri každom nasadení, skôr ako nová verzia dostane návštevníkov — zvyčajne ide o migrácie databázy. Ak zlyhá, nasadenie sa zastaví a ďalej beží aktuálna verzia, takže chybná migrácia sa k návštevníkom nikdy nedostane.

Pre frameworky, ktoré ho majú, príkaz navrhneme:

FrameworkOdporúčaný príkaz pri vydaní
Laravelphp artisan migrate --force
Djangopython manage.py migrate --noinput
Prisma (Node.js)npx prisma migrate deploy

Použiť odporúčaný príkaz ho ponechá; môžete zadať aj vlastný alebo zvoliť Žiadny. Zmeny platia od ďalšieho nasadenia.

Nastavenia zostavenia

Nastavenia → Nastavenia zostavenia umožňujú zmeniť to, čo sme rozpoznali:

  • Príkaz na inštaláciu — napr. npm ci
  • Príkaz na zostavenie — napr. npm run build
  • Príkaz na spustenie — príkaz, ktorý spustí vašu aplikáciu. Musí počúvať na porte z $PORT.
  • Výstupný priečinok — pri statických weboch priečinok so zostavenými súbormi.
  • Priečinok projektu — pri repozitári s viacerými projektmi.

Ak pole necháte prázdne, použije sa to, čo sme rozpoznali. Ďalšie nasadenie sa zostaví s novými nastaveniami; Zostaviť teraz ho spustí hneď.

V Nastaveniach je aj Vetva, ktorá sa nasadzuje.

Deploy hooky

Nastavenia → Deploy hooky → Vytvoriť hook. Deploy hook je súkromná adresa: keď na ňu iná služba pošle požiadavku POST, zostaví sa a nasadí posledný commit vašej vetvy. Typické použitie je CMS, ktorý po zverejnení obsahu web znova zostaví.

curl -X POST "<adresa hooku z panela>"
  • Adresa sa zobrazí raz — skopírujte ju pri vytvorení hooku. Ktokoľvek, kto ju má, môže spustiť nasadenie, preto ju držte v tajnosti.
  • Najviac 10 nasadení za hodinu na hook. Volanie, ktoré príde, kým zostavenie ešte čaká, sa k nemu pridá.
  • Zrušiť okamžite zneplatní adresu; služby, ktoré ju volajú, potom potrebujú novú.

Režim údržby

Nastavenia → Režim údržby → Zobraziť stránku údržby. Návštevníci namiesto aplikácie uvidia krátku stránku s vašou správou; ak správu necháte prázdnu, zobrazí sa „Robíme niekoľko vylepšení. Skúste to prosím o chvíľu znova.“

Samotná aplikácia beží ďalej, takže pred opätovným otvorením si môžete všetko overiť. Súkromný odkaz pre vás zobrazí aplikáciu ako zvyčajne na zariadení, ktoré ho otvorí, na 12 hodín. Nový odkaz vytvorí nový; starý odkaz prestane fungovať.

Vypnutím prepínača aplikáciu znova sprístupníte návštevníkom.

Upozornenia na nasadenia

Keď sa nasadenie nedokončí, pošleme vám e-mail (a správu cez Telegram, ak ho máte pripojený). Ak chcete posielať udalosti aj svojmu tímu — nová verzia je v prevádzke, nasadenie sa nedokončilo, služba sa zastavila alebo znova beží, vysoké využitie pamäte či procesora, záloha alebo disk databázy — pridajte Slack, Discord alebo vlastný webhook v Nastaveniach → Upozornenia pre tím. Správy webhooku sú JSON podpísaný tajným kľúčom, ktorý sa zobrazí raz, v hlavičke X-Rivervo-Signature.

Stále si neviete rady?

Napíšte nám do chatu — AI odpovie okamžite a technik sa pripojí, keď treba, v ktorúkoľvek dennú hodinu.

Kontaktovať podporu