---
title: "Инструкции по деплою backend-приложений в App Platform"
---

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

Создать backend-приложение можно из панели управления. Для этого перейдите в раздел «[App Platform](https://timeweb.cloud/my/apps)», нажмите кнопку «Добавить» и выберите тип «Backend».

### Шаг 1. Выбор приложения

В пункте «Тип» выберите фреймворк, который использует ваше приложение. Вы можете отсортировать фреймворки по языку программирования.

![Image4](https://content.timeweb.com/assets/863f303b-958c-4af1-95ea-868407ef0cae.png?width=501&height=712)

### Шаг 2. Подключение репозитория

![Image9](https://content.timeweb.com/assets/b7815c2e-bf78-40ec-a45b-6af45e15aff5.png?width=505&height=215)

Вы можете подключить репозиторий одним из способов:

-   Из своего аккаунта GitHub, GitLab или BitBucket. Кликните на название платформы, авторизуйтесь и выберите нужный репозиторий. Если вы уже авторизованы, панель сразу покажет доступные репозитории.
-   По URL, указав ссылку на репозиторий, созданный на любой платформе. Нажмите «Подключите git-репозиторий по URL» (или «Добавить аккаунт» → «Подключите git-репозиторий по URL») и укажите Git URL. Если репозиторий приватный — введите логин и пароль или токен доступа.

При подключении по ссылке автодеплой будет недоступен — для обновления приложения при изменениях в коде потребуется запускать деплой вручную.

Подробнее о подключении репозиториев — [здесь](https://timeweb.cloud/docs/apps/connecting-repositories).

### Шаг 3. Выбор ветки и коммита

![Image1](https://content.timeweb.com/assets/27b72f27-84ba-440e-abd7-981521d16f15.png?width=745&height=233)

Выберите ветку для деплоя.

В меню выбора ветки отображаются только 200 последних веток. При подключении репозитория GitLab, GitHub или Bitbucket также отображается ветка по умолчанию (`master`, `main` или `default`).

По умолчанию мы включаем опцию «Сборка по последнему выполненному коммиту». В этом случае App Platform выполнит деплой по самому актуальному коммиту, а в дальнейшем будет автоматически пересобирать приложение при добавлении новых коммитов в репозиторий.   
  
При необходимости вы сможете [отключить автодеплой](https://timeweb.cloud/docs/apps/upravlenie-apps-v-paneli#avtodeploj) в дальнейшем.  
  
Если вы хотите выбрать конкретный коммит вручную — отключите эту опцию.

![Image6](https://content.timeweb.com/assets/0c89ef1f-e432-41ee-bca5-bd2297eb33dd.png?width=763&height=470)

### Шаг 4. Регион и конфигурация сервера

Приложения разворачиваются на отдельных облачных серверах. Выберите регион размещения и подходящую конфигурацию сервера. Вы можете выбрать один из готовых тарифов или настроить конфигурацию вручную на вкладке «Произвольная».

В дальнейшем, если потребуется, вы сможете перейти на более мощный тариф.

![Be4444cf 7b4f 4ddf B9db A735db4d30ab](https://content.timeweb.com/assets/14af2fb6-4726-43ce-a85d-583abc04b9b0.png?width=759&height=817)

### Шаг 5. Настройка приватной сети

![Image2](https://content.timeweb.com/assets/30e5e420-a7e0-464f-89f8-4ba5bf129361.png?width=412&height=193)

На этом этапе вы можете выбрать приватную сеть, в которую будет добавлено приложение, и указать IP-адрес, который оно будет использовать. Обратите внимание, что изменить приватную сеть после деплоя нельзя.

Если для приложения настроен приватный IP-адрес, во время повторного деплоя возможна кратковременная недоступность приложения. Это связано с тем, что перед запуском новой версии необходимо освободить занятые порты.

### Шаг 6. Настройка приложения

![8900c053 7978 4e9c 83ce F58f5b8fbdcd](https://content.timeweb.com/assets/bf136a70-5a1f-4cad-8587-b2a1aaf8e379.png?width=660&height=713)

На этом этапе можно:

-   задать команду сборки;
-   установить зависимости;
-   указать команду запуска;
-   задать путь до директории проекта;
-   задать [путь проверки состояния](https://timeweb.cloud/docs/apps/healthcheck-path);
-   задать переменные окружения.

Если нужны дополнительные системные пакеты (например, для сборки проекта), укажите их в разделе «Зависимости». Они будут переданы в команду `apt install`. Несколько зависимостей указываются через пробел.

В большинстве случаев команда запуска определяется автоматически — ее можно не менять.

Если файлы вашего проекта размещены не в корне репозитория, а в поддиректории, укажите путь к ней в поле «Путь до директории проекта».

При указании пути:

-   Рабочая директория переключается на указанную папку.
-   Зависимости устанавливаются из файлов проекта в этой папке.
-   Команды сборки и запуска также выполняются из этой папки.

У вас будет возможность [внести изменения](https://timeweb.cloud/docs/apps/upravlenie-apps-v-paneli#smena-parametrov-i-novyj-deploj) в любые из этих параметров в дальнейшем и перезапустить деплой с новыми настройками, если потребуется.

### Шаг 7. Информация о приложении

Задайте свое имя приложения, если требуется, и комментарий к нему. Это данные, которые будут отображаться в панели управления.

Также выберите, в какой проект его нужно добавить.

![Image8](https://content.timeweb.com/assets/1f79ee3f-9784-48e0-9a55-191fe9eeb555.png?width=507&height=308)

Эти настройки также можно изменить в дальнейшем.

### Шаг 8. Деплой

Нажмите «Запустить деплой». Как только процесс начнется, вы увидите лог деплоя на вкладке «Деплой». 

Как правило, он содержит всю необходимую информацию для устранения возможных ошибок. Если что-то пойдет не так, например, из-за наличия ошибок в коде, в логе будут выведены уведомления о них с уточнением причины проблемы. 

При первом развертывании проекта установка сервера может занять некоторое время. Как только процесс завершится, статус приложения обновится, а также вы увидите сообщение об этом в логе. 

![Image5](https://content.timeweb.com/assets/41e738d6-5281-4e99-bc31-a8b0ad5b7c18.png?width=1022&height=846)

Готово!

IP-адрес приложения и бесплатный технический домен, привязанный к нему по умолчанию, можно найти на вкладе «Дашборд». Приложение будет доступно по 443 порту; порт 80 также открыт.

Привязать собственный домен можно [по нашей инструкции](https://timeweb.cloud/docs/apps/upravlenie-apps-v-paneli#privyazka-domena).

![Image10](https://content.timeweb.com/assets/ac357161-c86c-46fb-829c-d18cb6895dd4.png?width=1010&height=802)

В дальнейшем App Platform будет отслеживать обновления в репозитории и, если включен [автодеплой](https://timeweb.cloud/docs/apps/upravlenie-apps-v-paneli#avtodeploj), автоматически перезапускать проект с новыми изменениями.
