Документация / Начало работы
Первый деплой
От репозитория GitHub до работающего HTTPS-адреса.
Перед началом
Нужны одобренный GitHub-аккаунт и репозиторий, доступный GitHub App Upferry. Откройте панель, войдите и разрешите доступ к нужному репозиторию. Если GitHub возвращает на страницу входа, проверьте, одобрен ли аккаунт и включён ли репозиторий в установку приложения.
Создайте проект и сервис
- Создайте проект и задайте имя.
- Добавьте сервис из GitHub. Выберите репозиторий и ветку.
- Для монорепозитория укажите корневую папку конкретного приложения.
- Проверьте определённые команды сборки и запуска. Вместо автоматической сборки можно использовать Dockerfile из исходников сервиса.
- Добавьте необходимые переменные и выполните деплой. Если сборка началась сразу при создании, после добавления недостающих переменных может понадобиться новый деплой.
HTTP-процесс должен слушать 0.0.0.0 и настроенный порт сервиса. Читайте предоставленную переменную PORT в коде приложения. Процесс, слушающий только localhost, недоступен прокси.
Проверьте результат
Откройте деплой: сначала смотрите логи сборки, затем логи процесса. Для HTTP-сервиса настройте сгенерированный домен в сетевых настройках и откройте показанный HTTPS-адрес. Добавьте проверку готовности, например /health, которая отвечает HTTP 2xx, когда приложение готово.
Пример проверки своего адреса:
curl -fsS https://YOUR-SERVICE.up.upferry.com/health
Замените адрес на значение из панели. Успешная сборка сама по себе не доказывает, что работают страница, подключение к базе, вход или фоновые задачи. Проверьте эти действия в самом приложении.
Добавьте хранение данных и свой домен
Файловая система контейнера временная. Для постоянных данных используйте volume или базу. Когда сгенерированный адрес работает, подключите свой домен. Включите и попробуйте восстановление до того, как данные станут критичны.