Внедрявания, прегледи и връщане назад.
Как push-овете излизат на живо, прегледи на клонове, връщане към по-ранна версия, команда при издаване за миграции, настройки на билда, deploy hooks, режим на поддръжка и пароли за прегледите.
След като приложението заработи, рядко ще ви трябва панелът, за да публикувате промени: направете push към клона и новата версия излиза на живо сама. Тази статия описва всичко около това — раздела Внедрявания, Прегледи, раздела Процеси и няколко превключвателя в Настройки.
Автоматично внедряване при всеки push
Всеки push към клона на приложението изгражда последния commit и го внедрява. Новата версия стартира до работещата и започва да получава посетители едва когато отговори; ако не стартира, предишната версия продължава да работи и ви уведомяваме по имейл (и в Telegram, ако сте го свързали).
Push, направен докато друг билд още чака на опашката, се присъединява към този билд, така че поредица от push-ове не създава дълга опашка.
Можете да изключите това в Настройки → Внедряване при всеки push. Когато е изключено, внедрявате от панела, през API или с deploy hook.
Внедряване от панела
Разделът Внедрявания показва всяко внедряване: какво го е стартирало (push, панелът, връщане назад, deploy hook), commit-а, колко е продължило и статуса му. Щракнете върху внедряване, за да видите пълния му лог от билда.
Повторно внедряване предлага два варианта:
- Изграждане на последния commit — взима най-новия код от клона и го изгражда.
- Повторно внедряване на работещата версия — прилага променените променливи без нов билд. Използвайте го след редакция на Променливи.
Менюто до Отваряне има същите две действия, плюс Рестартиране.
Връщане назад
Можете да се върнете към всяка от последните 5 успешни версии. В раздела Внедрявания натиснете Връщане при желаната версия и потвърдете. По-ранната версия се стартира до текущата и поема, щом отговори — без нов билд.
Връщането назад не отменя промените в базата данни. Ако дадено издание е променило структурата на базата, възстановете и базата — вижте Бази данни.
Прегледи на клонове
Push към всеки друг клон получава собствен преглед — отделен адрес, където можете да проверите промените, преди да излязат на живо. Отваряте ги в раздела Прегледи.
- До 3 прегледа едновременно, включени в цената.
- Преглед без нови push-ове в продължение на 7 дни се премахва. Създава се отново при следващия push към този клон.
- Прегледите получават само предназначените за тях променливи — вижте Променливи на средата.
- Прегледи се създават за основната услуга на проекта, не за другите му услуги.
Парола за прегледите
В раздела Прегледи, Парола за прегледите → Изискване на парола. Въведете потребителско име и парола (поне 8 знака). Оттам нататък само хората с паролата могат да отварят прегледите; самото приложение остава отворено за всички.
Командата при издаване (миграции)
Раздел Процеси → Команда при издаване. Тя се изпълнява веднъж при всяко внедряване, преди новата версия да започне да получава посетители — обикновено миграции на базата данни. Ако се провали, внедряването спира и текущата версия продължава да работи, така че счупена миграция никога не стига до посетителите ви.
Предлагаме команда за фреймуърците, които имат такава:
| Фреймуърк | Препоръчителна команда при издаване |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Използване на препоръчителната команда я запазва; можете също да въведете своя или да изберете Без. Промените важат от следващото внедряване.
Настройки на билда
Настройки → Настройки на билда ви позволява да промените това, което сме разпознали:
- Команда за инсталиране — напр.
npm ci - Команда за билд — напр.
npm run build - Команда за стартиране — командата, която стартира приложението ви. То трябва да слуша на порта от
$PORT. - Папка с резултата — за статични сайтове, папката с изградените файлове.
- Папка на проекта — за хранилище с няколко проекта.
Оставете поле празно, за да се използва разпознатото от нас. Следващото внедряване се изгражда с новите настройки; Изграждане сега го стартира веднага.
В Настройки е и Клонът, който се внедрява.
Deploy hooks
Настройки → Deploy hooks → Създаване на hook. Deploy hook е частен адрес: когато друга услуга изпрати POST заявка към него, последният commit от вашия клон се изгражда и внедрява. Типичен пример е CMS, която изгражда сайта наново, след като публикувате.
curl -X POST "<адресът на hook-а от панела>"- Адресът се показва веднъж — копирайте го, когато създавате hook-а. Всеки, който го има, може да стартира внедряване, затова го пазете в тайна.
- До 10 внедрявания на час за hook. Извикване, което пристигне, докато билд още чака, се присъединява към него.
- Отнемане спира адреса веднага; услугите, които го извикват, ще имат нужда от нов.
Режим на поддръжка
Настройки → Режим на поддръжка → Показване на страницата за поддръжка. Посетителите виждат кратка страница с вашето съобщение вместо приложението; оставете съобщението празно, за да се покаже „Правим някои подобрения. Моля, проверете отново след малко.“
Самото приложение продължава да работи, така че можете да проверите всичко, преди да го отворите отново. Лична връзка за вас показва приложението както обикновено на устройството, което я отвори, в продължение на 12 часа. Нова връзка създава нова; старата спира да работи.
Изключете превключвателя, за да отворите приложението отново за посетители.
Известия за внедряванията
Изпращаме ви имейл (и съобщение в Telegram, ако сте го свързали), когато внедряване не завърши. За да изпращате събития и на екипа си — нова версия излезе на живо, внедряване не завърши, услуга спря или се възстанови, високо използване на памет или процесор, резервно копие или диск на база данни — добавете Slack, Discord или собствен webhook в Настройки → Известия към екипа. Съобщенията към webhook са JSON, подписани с тайна, която се показва веднъж, в хедъра X-Rivervo-Signature.