Розгортання, прев’ю та відкати.
Як push потрапляє в робочу версію, прев’ю для гілок, повернення до попередньої версії, команда релізу для міграцій, налаштування збирання, хуки розгортання, режим обслуговування й паролі для прев’ю.
Коли застосунок уже працює, панель для викочування змін потрібна рідко: зробіть push у гілку — і нова версія запрацює сама. У цій статті — усе, що довкола цього: вкладка Розгортання, Прев’ю, вкладка Процеси і кілька перемикачів у Налаштуваннях.
Автоматичне розгортання за кожним push
Кожен push у гілку застосунку збирає останній коміт і розгортає його. Нова версія запускається поруч із поточною й отримує відвідувачів лише тоді, коли почне відповідати; якщо вона не запуститься, попередня версія працює далі, а ми повідомимо вас електронною поштою (і в Telegram, якщо ви його підключили).
Push, зроблений, поки інше збирання ще чекає в черзі, приєднується до цього збирання, тож серія push-ів не створює довгої черги.
Це можна вимкнути в Налаштуваннях → Розгортати кожен push. Коли перемикач вимкнено, ви розгортаєте з панелі, через API або хук розгортання.
Розгортання з панелі
На вкладці Розгортання перелічено всі розгортання: що їх запустило (push, панель, відкат, хук розгортання), коміт, тривалість і статус. Натисніть на розгортання, щоб побачити повний журнал збирання.
Розгорнути знову пропонує два варіанти:
- Зібрати останній коміт — бере найновіший код із гілки й збирає його.
- Розгорнути поточну версію ще раз — застосовує змінені змінні без нового збирання. Користуйтеся цим після редагування Змінних.
У меню поруч із кнопкою Відкрити — ті самі дві дії плюс Перезапустити.
Відкат
Повернутися можна до будь-якої з останніх 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. - Папка з результатом — для статичних сайтів: папка зі зібраними файлами.
- Папка проєкту — для репозиторію з кількома проєктами.
Залиште поле порожнім, щоб використовувати визначене автоматично. Наступне розгортання збирається з новими налаштуваннями; Зібрати зараз запускає його одразу.
У Налаштуваннях також вибирається Гілка, яка розгортається.
Хуки розгортання
Налаштування → Хуки розгортання → Створити хук. Хук розгортання — це приватна адреса: коли інший сервіс надсилає на неї запит POST, останній коміт вашої гілки збирається й розгортається. Типовий приклад — CMS, яка перебудовує сайт після публікації.
curl -X POST "<the hook address from the panel>"- Адресу показано один раз — скопіюйте її під час створення хука. Будь-хто, хто її має, може запустити розгортання, тож тримайте її в таємниці.
- До 10 розгортань на годину на один хук. Виклик, що надходить, поки збирання ще чекає, приєднується до нього.
- Відкликати одразу деактивує адресу; сервісам, що її викликають, знадобиться нова.
Режим обслуговування
Налаштування → Режим обслуговування → Показувати сторінку обслуговування. Замість застосунку відвідувачі бачать коротку сторінку з вашим повідомленням; якщо залишити повідомлення порожнім, буде показано «Ми трохи вдосконалюємо сайт. Будь ласка, загляньте трохи згодом».
Сам застосунок працює далі, тож ви можете все перевірити, перш ніж знову відкрити його. Приватне посилання для вас показує застосунок як зазвичай на тому пристрої, де його відкрито, протягом 12 годин. Нове посилання створює свіже, а старе перестає працювати.
Щоб знову відкрити застосунок для відвідувачів, вимкніть перемикач.
Сповіщення про розгортання
Якщо розгортання не завершилося, ми надсилаємо вам лист (і повідомлення в Telegram, якщо ви його підключили). Щоб надсилати події й команді — нова версія запрацювала, розгортання не завершилося, сервіс зупинився або відновився, високе використання пам’яті чи процесора, резервна копія або диск бази даних, — додайте Slack, Discord або власний вебхук у Налаштуваннях → Сповіщення для команди. Повідомлення вебхука — це JSON, підписаний секретом (його показано один раз), у заголовку X-Rivervo-Signature.