Nasazení, náhledy a návrat k předchozí verzi.
Jak se push dostane do provozu, náhledy větví, návrat k dřívější verzi, příkaz při vydání pro migrace, nastavení sestavení, deploy hooky, režim údržby a hesla pro náhledy.
Jakmile aplikace běží, k vydávání změn panel skoro nepotřebujete: pushnete do větve a nová verze se nasadí sama. Tento článek popisuje vše okolo — kartu Nasazení, Náhledy, kartu Procesy a několik přepínačů v Nastavení.
Automatické nasazení při každém push
Každý push do větve aplikace sestaví poslední commit a nasadí ho. Nová verze se spustí vedle té běžící a návštěvníky začne dostávat, až když odpovídá; pokud se nespustí, dál běží předchozí verze a my vám dáme vědět e-mailem (a přes Telegram, pokud ho máte připojený).
Push, který přijde, zatímco jiné sestavení ještě čeká ve frontě, se k němu připojí, takže série pushů nevytvoří dlouhou frontu.
Vypnout to můžete v Nastavení → Nasadit každý push. Když je volba vypnutá, nasazujete z panelu, přes API nebo deploy hookem.
Nasazení z panelu
Karta Nasazení obsahuje všechna nasazení: čím bylo spuštěno (push, panel, návrat k verzi, deploy hook), commit, jak dlouho trvalo a jeho stav. Kliknutím na nasazení zobrazíte celý log sestavení.
Znovu nasadit nabízí dvě možnosti:
- Sestavit poslední commit — vezme nejnovější kód z větve a sestaví ho.
- Znovu nasadit běžící verzi — použije změněné proměnné, bez nového sestavení. Použijte po úpravě Proměnných.
Nabídka vedle Otevřít obsahuje stejné dvě akce a navíc Restartovat.
Návrat k předchozí verzi
Vrátit se můžete k libovolné z posledních 5 úspěšných verzí. Na kartě Nasazení klikněte u požadované verze na Vrátit a potvrďte. Dřívější verze se spustí vedle aktuální a převezme provoz, jakmile odpovídá — nové sestavení neprobíhá.
Návrat k verzi nevrací změny v databázi. Pokud vydání změnilo strukturu databáze, obnovte i databázi — viz Databáze.
Náhledy větví
Push do jakékoli jiné větve dostane vlastní náhled — samostatnou adresu, kde si změny zkontrolujete dřív, než půjdou do provozu. Otevřete je na kartě Náhledy.
- Najednou až 3 náhledy, v ceně.
- Náhled, do kterého 7 dní nepřišel žádný push, se odstraní. Znovu vznikne s dalším push do dané větve.
- Náhledy dostanou jen proměnné, které jsou pro ně určené — viz Proměnné prostředí.
- Náhledy vznikají pro hlavní službu projektu, ne pro jeho ostatní služby.
Heslo pro náhledy
Na kartě Náhledy: Heslo pro náhledy → Vyžadovat heslo. Zadejte uživatelské jméno a heslo (nejméně 8 znaků). Od té chvíle náhledy otevřou jen lidé s heslem; samotná aplikace zůstává přístupná všem.
Příkaz při vydání (migrace)
Karta Procesy → Příkaz při vydání. Spustí se jednou při každém nasazení, dřív než nová verze dostane návštěvníky — obvykle jde o migrace databáze. Pokud selže, nasazení se zastaví a dál běží aktuální verze, takže se nepovedená migrace k návštěvníkům nikdy nedostane.
Pro frameworky, které takový příkaz mají, ho navrhneme:
| Framework | Doporučený příkaz při vydání |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Použít doporučený příkaz ho ponechá; můžete také zadat vlastní nebo zvolit Žádný. Změny platí od dalšího nasazení.
Nastavení sestavení
V Nastavení → Nastavení sestavení můžete změnit, co jsme rozpoznali:
- Příkaz pro instalaci — např.
npm ci - Příkaz pro sestavení — např.
npm run build - Příkaz pro spuštění — příkaz, který spouští vaši aplikaci. Musí naslouchat na portu z
$PORT. - Výstupní složka — u statických webů složka se sestavenými soubory.
- Složka projektu — pro repozitář s více projekty.
Když pole necháte prázdné, použije se to, co jsme rozpoznali. Další nasazení se sestaví s novým nastavením; Sestavit nyní ho spustí hned.
V Nastavení je také Větev, která se nasazuje.
Deploy hooky
Nastavení → Deploy hooky → Vytvořit hook. Deploy hook je soukromá adresa: když na ni jiná služba pošle požadavek POST, sestaví a nasadí se poslední commit vaší větve. Typické použití je CMS, který po publikování znovu sestaví web.
curl -X POST "<the hook address from the panel>"- Adresa se zobrazí jen jednou — zkopírujte si ji při vytváření hooku. Kdokoli ji má, může spustit nasazení, proto ji nikomu nedávejte.
- Nejvýše 10 nasazení za hodinu na jeden hook. Volání, které přijde, zatímco sestavení ještě čeká, se k němu připojí.
- Zneplatnit adresu okamžitě vypne; služby, které ji volají, pak potřebují novou.
Režim údržby
Nastavení → Režim údržby → Zobrazit stránku údržby. Návštěvníci místo aplikace uvidí krátkou stránku s vaší zprávou; když zprávu necháte prázdnou, zobrazí se „Provádíme několik vylepšení. Zkuste to prosím za chvíli znovu.“
Samotná aplikace dál běží, takže si vše můžete zkontrolovat, než ji znovu otevřete. Soukromý odkaz pro vás zobrazí aplikaci jako obvykle na zařízení, které ho otevře, po dobu 12 hodin. Nový odkaz vytvoří čerstvý; starý odkaz přestane fungovat.
Vypnutím přepínače aplikaci návštěvníkům znovu otevřete.
Upozornění na nasazení
Když se nasazení nedokončí, pošleme vám e-mail (a zprávu přes Telegram, pokud ho máte připojený). Chcete-li události posílat i svému týmu — nová verze je v provozu, nasazení se nedokončilo, služba se zastavila nebo znovu naběhla, vysoké využití paměti či procesoru, záloha nebo disk databáze — přidejte Slack, Discord nebo vlastní webhook v Nastavení → Upozornění pro tým. Zprávy webhooku jsou JSON podepsaný tajným klíčem, který se zobrazí jen jednou, v hlavičce X-Rivervo-Signature.