deytenit
b3638f4d63
🤖 PR generated for branch `fix/cyrillic-fonts-dev-certs-and-page-head`.
### Changes Summary
- **Fonts**: Add Cyrillic glyph subsets for Lato, EB Garamond, and Fira
Code.
- **Dev**: Support remote Root CA and encrypted dev CA key in
`.env.dev`.
- **UI & Kits**: Add size variant to `Breadcrumbs` component and enlarge
`PageHead` breadcrumbs with tuned collapse scroll threshold.
- **ESLint**: Add `no-hanging-particles` i18n & markdown typography rule
with auto-fixer.
- **Content & i18n**: Apply `ru-text` editorial and typography polish
(em dashes, number ranges, «ё» restoration, non-breaking spaces) across
`services/www` and `services/docs`.
78 lines
2.7 KiB
Markdown
78 lines
2.7 KiB
Markdown
---
|
|
title: Развёртывание и эксплуатация
|
|
weight: 2
|
|
---
|
|
|
|
**Цель:** настроить, развернуть и контролировать работу бота Quetza.
|
|
|
|
## 1. Подготовка окружения
|
|
|
|
Quetza настраивается через переменные окружения. **Никогда** не сохраняйте их в систему контроля версий.
|
|
|
|
| Переменная | Описание | Обязательно |
|
|
| :--- | :--- | :--- |
|
|
| `DISCORD_TOKEN` | Токен бота из Discord Developer Portal | **Да** |
|
|
| `CLIENT_ID` | Идентификатор приложения для регистрации слэш-команд | **Да** |
|
|
| `LLAMA_API_KEY` | Требуется для модуля ИИ | Нет |
|
|
|
|
## 2. Способы развёртывания
|
|
|
|
{{< tabs >}}
|
|
{{< tab name="Docker (рекомендуется)" >}}
|
|
**Docker** обеспечивает предсказуемое и изолированное окружение.
|
|
|
|
1. **Сборка** образа:
|
|
|
|
```bash
|
|
docker build -t quetza-bot .
|
|
```
|
|
|
|
2. **Запуск** контейнера:
|
|
```bash
|
|
docker run -d \
|
|
--env-file .env \
|
|
--name quetza \
|
|
quetza-bot
|
|
```
|
|
{{< /tab >}}
|
|
{{< tab name="Из исходного кода" >}}
|
|
Развёртывание **из исходного кода** подходит для разработки и отладки.
|
|
|
|
1. **Установка** зависимостей:
|
|
|
|
```bash
|
|
pnpm install
|
|
```
|
|
|
|
2. **Сборка** проекта:
|
|
|
|
```bash
|
|
pnpm build
|
|
```
|
|
|
|
3. **Запуск** бота:
|
|
```bash
|
|
pnpm start
|
|
```
|
|
{{< /tab >}}
|
|
{{< /tabs >}}
|
|
|
|
## 3. Мониторинг
|
|
|
|
После запуска проверьте состояние бота:
|
|
|
|
- **Логи:** проверьте стандартный вывод (логи Docker) на ошибки инициализации.
|
|
- **Команда `/ping`:** измеряет задержку сети и отзывчивость API.
|
|
- **Команда `/modules`:** выводит список загруженных модулей, подтверждая доступность функций.
|
|
|
|
> [!WARNING]
|
|
> **Ограничение масштабирования:**
|
|
> Quetza работает по модели «один экземпляр на один токен». Не запускайте несколько копий бота с одним токеном: это вызовет конфликты соединений WebSocket.
|
|
|
|
---
|
|
|
|
**См. также:**
|
|
|
|
- [Документация Docker](https://docs.docker.com/)
|
|
- [Discord Developer Portal](https://discord.com/developers/applications)
|