Как подготовить репозиторий

AutoHoster определяет язык по файлам в корне репозитория. Dockerfile не обязателен, но если он есть — используется он. Если вы владелец бота, а не разработчик, покажите эту страницу тому, кто писал код.

Что платформа делает с репозиторием

В корне лежитЧто сделает платформа
requirements.txt или pyproject.tomlОбраз Python 3.12, pip install -r requirements.txt (или pip install . для pyproject.toml), запуск точки входа — см. ниже.
package.jsonОбраз Node 22, npm ci --omit=dev (без package-lock.json — npm install --omit=dev), запуск npm start.
DockerfileСобирается как есть. Команда запуска — из образа.

Если в корне нет ни одного из этих файлов, сборка завершится ошибкой «Не найден ни Dockerfile, ни requirements.txt/pyproject.toml, ни package.json».

Точка входа для Python

Порядок проверки:

  1. bot/__main__.py → python -m bot
  2. app/__main__.py → python -m app
  3. первый найденный из main.py, bot.py, app.py, run.py → python <файл>

Если ничего не найдено, сборка остановится с ошибкой «Не удалось определить точку входа: добавьте Dockerfile или укажите команду запуска».

Своя команда запуска

Если точка входа называется иначе или нужны аргументы, укажите команду запуска в параметрах бота, например python src/run.py или node dist/index.js. Команда выполняется через sh -c в рабочей папке /app и заменяет команду из образа (в том числе из вашего Dockerfile).

Требования к коду бота

  • Бот должен работать через long polling (getUpdates). Входящие порты у контейнера не открыты, поэтому webhook-режим Telegram работать не будет.
  • Токен читается из переменной окружения — по умолчанию TELEGRAM_BOT_TOKEN, имя можно поменять в параметрах бота. Не храните токен в коде.
  • Адрес Telegram Bot API не прописывайте в коде: берите его из переменной TELEGRAM_API_BASE, а если она пустая — https://api.telegram.org. Как это сделать в вашей библиотеке — см. раздел «Типовые ошибки», пункт про таймауты Telegram.
  • Файлы, которые должны пережить обновление (базы, загруженные фото), пишите в /app/data — см. раздел «Переменные окружения и данные».
  • Зависимости должны быть перечислены в requirements.txt / pyproject.toml / package.json: в контейнере нет ничего, кроме того, что установилось при сборке.

Как проходит сборка

  • Клонируется только выбранная ветка (git clone --depth 1). Папка .git в образ не попадает.
  • На сборку отводится 15 минут и 1 ГБ памяти; одновременно на сервере собирается не больше двух ботов.
  • Если в корне нет Dockerfile, платформа создаёт свой (Dockerfile.botplatform) по шаблону выше. Рабочая папка в контейнере — /app.
  • После запуска платформа ждёт 4 секунды: если контейнер за это время завершился, сборка считается неудачной, а последние строки лога бота попадают в лог сборки.

Закрытый (приватный) репозиторий GitHub

Чтобы подключить приватный (закрытый) репозиторий, нужен токен доступа GitHub — ключ, который даёт право только читать код одного репозитория. Без токена приватный репозиторий выглядит для платформы несуществующим, и сборка остановится на шаге клонирования. Токен создаётся за пару минут по шагам ниже и вставляется при добавлении бота или позже в «Параметрах».

Токен доступа GitHub: пошагово

1. Откройте форму нового токена

Перейдите по ссылке https://github.com/settings/personal-access-tokens/new (GitHub попросит войти). Это раздел Settings → Developer settings → Personal access tokens → Fine-grained tokens.

Задайте любое имя и срок действия: 90 дней или год. Когда срок выйдет, новые сборки перестанут скачивать код — создайте новый токен и замените его в «Параметрах» бота. Работающий бот при этом не останавливается.

Шаг 1. Имя токена и срок действия
Шаг 1. Имя токена и срок действия

2. Дайте доступ только к репозиторию бота

В Resource owner выберите свой аккаунт, а если репозиторий принадлежит организации — организацию (тогда её администратору нужно одобрить токен в настройках организации). В Repository access отметьте Only select repositories и выберите репозиторий бота.

Шаг 2. Доступ только к одному репозиторию
Шаг 2. Доступ только к одному репозиторию

3. Включите одно право: Contents — Read-only

В Permissions → Repository permissions найдите Contents и выберите Read-only. Metadata включится сама. Остальные права не нужны: платформа только читает код и ничего не меняет в репозитории.

Шаг 3. Contents: Read-only
Шаг 3. Contents: Read-only

4. Создайте и скопируйте токен

Нажмите Generate token внизу формы и сразу скопируйте токен — GitHub показывает его один раз. Он начинается с github_pat_.

Шаг 4. Generate token и копирование
Шаг 4. Generate token и копирование

5. Вставьте токен в AutoHoster

При добавлении бота раскройте «Репозиторий закрытый (private)» и вставьте токен в поле «Токен доступа GitHub». У уже добавленного бота токен меняется в «Параметрах». Токен хранится зашифрованным, а в логах сборки заменяется на ***.

Шаг 5. Поле «Токен доступа GitHub»
Шаг 5. Поле «Токен доступа GitHub»

Если сборка пишет, что GitHub не принял токен

  • Истёк срок — создайте новый токен и замените его в «Параметрах».
  • Токен выдан на другой репозиторий — в настройках токена на GitHub добавьте нужный репозиторий в Repository access.
  • Репозиторий организации — проверьте, что администратор организации одобрил токен (Settings организации → Personal access tokens → Pending requests).
  • Ветки нет — проверьте название ветки в «Параметрах»: обычно main или master.

На схемах выше — экраны GitHub в упрощённом виде: оформление у GitHub со временем меняется, названия полей остаются теми же.