Шаг 1. Подключение репозитория
Вы можете подключить репозиторий одним из следующих способов:
- Из аккаунта GitHub, GitLab или Bitbucket
- По ссылке
- Перейдите в раздел «App Platform» и нажмите кнопку «Создать» или «Добавить».
- Если вы уже залогинены в Git-аккаунт, панель отобразит все доступные репозитории. Выберите нужный.
- Если нужно авторизоваться в другой Git-аккаунт, раскройте список репозиториев и кликните «Добавить аккаунт».
- Кликните на иконку нужной платформы.
- Авторизуйтесь в своем Git-аккаунте и разрешите Timeweb Cloud доступ ко всем или отдельным репозиториям.
- Выберите нужный репозиторий в панели Timeweb Cloud.
- Выберите ветку для деплоя. Панель отобразит 200 последних веток, а также ветку по умолчанию (
master,mainилиdefault). -
Оставьте опцию «Сборка по последнему выполненному коммиту» включенной, чтобы автоматически перезапускать деплой приложения при появлении новых коммитов в репозитории.
Если хотите выбирать коммит для деплоя вручную, отключите эту опцию.
Автодеплой можно отключить и позже, в любой момент.
После подключения репозитория App Platform автоматически определит язык, фреймворк и версию окружения вашего приложения, но вы также можете скорректировать их вручную.
Шаг 2. Регион и конфигурация
Приложения разворачиваются на отдельных облачных серверах. Выберите регион размещения и подходящую конфигурацию сервера. Вы можете выбрать один из готовых тарифов или настроить конфигурацию вручную на вкладке «Произвольная».
В дальнейшем, если потребуется, вы сможете перейти на более мощный тариф.
Шаг 3. Дополнительные настройки
Кликните «Показать расширенные настройки», чтобы задать дополнительные параметры.
App Platform автоматически определит основные параметры приложения:
- Команды сборки и запуска
- Системные зависимости
- Директорию сборки и точку входа
- Путь проверки состояния
Вы можете скорректировать их, если требуется, а также настроить приватную сеть и другие параметры.
Все эти параметры, кроме приватной сети, можно изменить позже и запустить деплой заново.
Приватная сеть
Выберите приватную сеть, в которую будет добавлено приложение, и укажите IP-адрес, который оно будет использовать. Если приватная сеть не нужна — выберите «Без приватной сети».
Изменить приватную сеть после деплоя нельзя.
Если для приложения настроен приватный IP-адрес, во время повторного деплоя возможна кратковременная недоступность приложения.
Команда сборки
Сервис автоматически предложит команду сборки для вашего проекта. При необходимости вы можете ее отредактировать, однако в большинстве случаев изменения не требуются.
Зависимости
Если нужны дополнительные системные пакеты (например, для сборки проекта), укажите их в разделе «Зависимости». Они будут переданы в команду apt install. Несколько зависимостей указываются через пробел.
Команда запуска
В большинстве случаев команда запуска определяется автоматически — ее можно не менять.
Путь до директории проекта
Если файлы вашего проекта размещены не в корне репозитория, а в поддиректории, укажите путь к ней в поле «Путь до директории проекта».
При указании пути:
- Рабочая директория переключается на указанную папку.
- Зависимости устанавливаются из файлов проекта в этой папке.
- Команды сборки и запуска также выполняются из этой папки.
Путь проверки состояния
Путь проверки состояния позволяет проверять, корректно ли работает приложение. Подробнее.
Переменные
Переменные можно использовать для передачи паролей, путей, токенов и других параметров окружения. Подробнее.
Сертификаты Минцифры / Сертификаты ТЦИ
Могут потребоваться для работы с API российских банков и государственных организаций. Подробнее.
Шаг 4. Информация о приложении
Задайте свое имя приложения, если требуется, и комментарий к нему. Это данные, которые будут отображаться в панели управления.
Также выберите, в какой проект его нужно добавить.
Эти настройки также можно изменить в дальнейшем.
Шаг 5. Деплой
Нажмите «Запустить деплой». Как только процесс начнется, вы увидите лог деплоя на вкладке «Деплой».
Как правило, он содержит всю необходимую информацию для устранения возможных ошибок. Если что-то пойдет не так, например, из-за наличия ошибок в коде, в логе будут выведены уведомления о них с уточнением причины проблемы.
При первом развертывании проекта установка сервера может занять некоторое время. Как только процесс завершится, статус приложения обновится, а также вы увидите сообщение об этом в логе.
IP-адрес приложения и бесплатный технический домен, привязанный к нему по умолчанию, можно найти на вкладе «Дашборд». Приложение будет доступно по 443 порту; порт 80 также открыт.
Привязать собственный домен можно по нашей инструкции.
В дальнейшем App Platform будет отслеживать обновления в репозитории и, если включен автодеплой, автоматически перезапускать проект с новыми изменениями.