Добавить локацию: новый сервер в кластер одним шагом
Как из нового VPS за один шаг сделать воркер кластера: подключить его, клонировать сайт-мастер и запустить Horizon.
Обновлено 27 октября 2026 2 мин чтения
Мастер Добавить локацию принимает новый VPS и настраивает его как подчинённый сервер кластера. Сайт-мастер клонируется на новый сервер, и Horizon начинает обрабатывать очереди. Мастер доступен на тарифе Pro и выше.
Перед началом
В кластере должен быть сайт-мастер на Laravel с Git-репозиторием, см. статью «Деплой кода из GitHub: подключение репозитория и запуск». Если его нет, страница предупредит, что клонировать нечего. Также понадобится VPS с доступом по SSH: пароль root или SSH-ключ.
Шаги
- Откройте кластер и нажмите Добавить локацию.
- В блоке Новый сервер укажите Публичный IP, при необходимости Приватный IP (опционально) и SSH-порт. В блоке Аутентификация выберите Пароль root или SSH-ключ. Если выбран ключ, добавьте публичный ключ, который покажет страница.
- Назовите сервер по коду локации, например
ams-1. - В блоке с мастером выберите Мастер-сайт. Ветка по умолчанию совпадает с веткой мастера, при необходимости поменяйте её в поле Ветка.
- Укажите Процессы Horizon (по умолчанию 1) и Команду Horizon (по умолчанию
php artisan horizon). - В поле Оверрайды .env локации запишите строки вида КЛЮЧ=значение, которые отличаются в этой локации, например код локации. Ключи пишутся заглавными буквами. Строки, начинающиеся с #, пропускаются.
- Нажмите Запровижнить локацию.
Что происходит дальше
Всё выполняется фоновыми задачами по порядку:
- сервер настраивается с пакетами воркера и подключается к кластеру как подчинённый мастера;
- репозиторий клонируется, .env копируется с мастера, поверх него применяются оверрайды, а базы данных и Redis указывают на участников кластера;
- применяются деплой-скрипт кластера, если он задан, и шаблоны демонов и cron;
- проверка: база данных доступна, Redis доступен, Horizon берёт задачи из очереди.
Если не получается
- Мастер не даёт запуститься: в кластере нет сайта-мастера с репозиторием. Добавьте сайт и подключите репозиторий.
- Проверка не прошла: откройте задачи этого сервера в ленте задач, найдите причину, исправьте её и запустите недостающие шаги снова.