137 lines
3.5 KiB
Markdown
137 lines
3.5 KiB
Markdown
# Конфигурация
|
||
|
||
## Переменные окружения
|
||
|
||
Quoter использует следующие переменные окружения для настройки:
|
||
|
||
### Обязательные переменные
|
||
|
||
| Переменная | Описание | Пример |
|
||
|------------|----------|--------|
|
||
| `REDIS_URL` | URL для подключения к Redis | `redis://localhost:6379` |
|
||
| `CORE_URL` | URL для подключения к API ядра | `https://api.example.com/graphql` |
|
||
| `STORJ_ACCESS_KEY` | Ключ доступа к Storj S3 | `your-storj-access-key` |
|
||
| `STORJ_SECRET_KEY` | Секретный ключ Storj S3 | `your-storj-secret-key` |
|
||
| `AWS_ACCESS_KEY` | Ключ доступа к AWS S3 | `your-aws-access-key` |
|
||
| `AWS_SECRET_KEY` | Секретный ключ AWS S3 | `your-aws-secret-key` |
|
||
|
||
### Опциональные переменные
|
||
|
||
| Переменная | Описание | По умолчанию |
|
||
|------------|----------|--------------|
|
||
| `PORT` | Порт для запуска сервера | `8080` |
|
||
| `STORJ_END_POINT` | Endpoint Storj S3 | `https://gateway.storjshare.io` |
|
||
| `STORJ_BUCKET_NAME` | Имя bucket в Storj | `discours-io` |
|
||
| `AWS_END_POINT` | Endpoint AWS S3 | `https://s3.amazonaws.com` |
|
||
| `RUST_LOG` | Уровень логирования | `info` |
|
||
|
||
## Пример .env файла
|
||
|
||
```bash
|
||
# Redis
|
||
REDIS_URL=redis://localhost:6379
|
||
|
||
# Core API
|
||
CORE_URL=https://api.example.com/graphql
|
||
|
||
# Storj S3
|
||
STORJ_ACCESS_KEY=your-storj-access-key
|
||
STORJ_SECRET_KEY=your-storj-secret-key
|
||
STORJ_END_POINT=https://gateway.storjshare.io
|
||
STORJ_BUCKET_NAME=discours-io
|
||
|
||
# AWS S3
|
||
AWS_ACCESS_KEY=your-aws-access-key
|
||
AWS_SECRET_KEY=your-aws-secret-key
|
||
AWS_END_POINT=https://s3.amazonaws.com
|
||
|
||
# Server
|
||
PORT=8080
|
||
RUST_LOG=info
|
||
```
|
||
|
||
## Настройка Redis
|
||
|
||
### Минимальная конфигурация Redis
|
||
|
||
```redis
|
||
# redis.conf
|
||
maxmemory 2gb
|
||
maxmemory-policy allkeys-lru
|
||
save 900 1
|
||
save 300 10
|
||
save 60 10000
|
||
```
|
||
|
||
### Проверка подключения
|
||
|
||
```bash
|
||
redis-cli ping
|
||
```
|
||
|
||
## Настройка S3
|
||
|
||
### Storj S3
|
||
|
||
1. Создайте аккаунт на [Storj](https://storj.io)
|
||
2. Создайте API ключи в консоли
|
||
3. Создайте bucket для файлов
|
||
4. Настройте CORS для bucket:
|
||
|
||
```json
|
||
{
|
||
"CORSRules": [
|
||
{
|
||
"AllowedOrigins": ["*"],
|
||
"AllowedMethods": ["GET", "POST", "PUT", "DELETE"],
|
||
"AllowedHeaders": ["*"],
|
||
"ExposeHeaders": ["ETag"]
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### AWS S3
|
||
|
||
1. Создайте IAM пользователя с правами S3
|
||
2. Создайте bucket для файлов
|
||
3. Настройте CORS аналогично Storj
|
||
|
||
## Логирование
|
||
|
||
### Уровни логирования
|
||
|
||
- `error` - только ошибки
|
||
- `warn` - предупреждения и ошибки
|
||
- `info` - информационные сообщения, предупреждения и ошибки
|
||
- `debug` - отладочная информация
|
||
- `trace` - максимальная детализация
|
||
|
||
### Примеры
|
||
|
||
```bash
|
||
# Только ошибки
|
||
RUST_LOG=error cargo run
|
||
|
||
# Информационные сообщения
|
||
RUST_LOG=info cargo run
|
||
|
||
# Отладка
|
||
RUST_LOG=debug cargo run
|
||
```
|
||
|
||
## Проверка конфигурации
|
||
|
||
Запустите сервер и проверьте логи:
|
||
|
||
```bash
|
||
RUST_LOG=info cargo run
|
||
```
|
||
|
||
Успешный запуск должен показать:
|
||
|
||
```
|
||
[INFO] Started
|
||
[WARN] caching AWS filelist...
|
||
[WARN] cached 1234 files
|
||
``` |