Files
ermnvldmr.com/services/docs/content/ru/quetza/guides/deployment.md
T

2.8 KiB

title, weight
title weight
Развертывание и эксплуатация 2

Цель: Настроить, развернуть и мониторить экземпляр бота Quetza.

1. Подготовка окружения

Quetza полагается на переменные окружения для конфигурации. Никогда не сохраняйте их в систему контроля версий.

Переменная Описание Обязательно
DISCORD_TOKEN Токен бота из Discord Developer Portal Да
CLIENT_ID ID приложения для регистрации slash-команд Да
LLAMA_API_KEY Требуется при использовании модуля ИИ Нет

2. Стратегии развертывания

{{< tabs >}} {{< tab name="Docker (Рекомендуется)" >}} Docker обеспечивает стабильное окружение выполнения.

  1. Сборка образа:

    docker build -t quetza-bot .
    
  2. Запуск контейнера:

    docker run -d \
      --env-file .env \
      --name quetza \
      quetza-bot
    

{{< /tab >}} {{< tab name="Из исходников (Source)" >}} Развертывание из исходников полезно для разработки.

  1. Установка зависимостей:

    pnpm install
    
  2. Сборка проекта:

    pnpm build
    
  3. Запуск бота:

    pnpm start
    

{{< /tab >}} {{< /tabs >}}

3. Операционный мониторинг

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

  • Логи: Проверьте стандартный вывод (логи Docker) на наличие ошибок инициализации.
  • Команда /ping: Проверяет задержку сети и отзывчивость API.
  • Команда /modules: Перечисляет все загруженные модули, чтобы подтвердить доступность функций.

Warning

Ограничение масштабирования: Quetza следует модели "один экземпляр на один токен". Не запускайте несколько экземпляров с одним и тем же токеном, так как это вызовет конфликты WebSocket.


См. также: