Настройка параметров через переменные окружения

Общие параметры

Переменная окружения Дефолт Описание

TNGRI_AUTH_TOKEN_DURATION

1h

Время жизни (TTL) токена доступа и сессии. Разбирается как длительность в стиле Go и применяется к JWT и Max-Age cookie аутентификации.

TNGRI_DEBUG

False

Устанавливает уровень логирования DEBUG (вместо INFO) и включает логирование доступа веб-сервера.

TENGRI_MASTER_KEY

""

Главный ключ развёртывания (hex).
Нет флага командной строки, исключён из --show-config, маскируется в логах.

Каталог

Переменная окружения Дефолт Описание

TNGRI_WAREHOUSE_PATH

(не задано)

Префикс расположения в S3, куда записываются файлы данных таблиц Iceberg.

TNGRI_CATALOG_URI

(не задано)

URI PostgreSQL хранилища метаданных каталога Iceberg (используется каталогом и журналом DDL).

Вычислитель

Переменная окружения Дефолт Описание

TNGRI_CACHE_DIR

/tmp/tngri-server

Корень дискового кэша (кэш запросов и файлов, данные сессий; также Python-окружение и корень языкового сервера на сервере). Создаётся при запуске. Агент переопределяет на /tmp/tngri-agent.

TNGRI_DEFAULT_MEM_PER_CORE

4

Память (ГБ) на ядро для вычисления лимита памяти каждого воркера.

TNGRI_DEDICATED_RAM_RATIO

0.75

Доля от общей оперативной памяти, зарезервированная под нужды вычислителя.

TNGRI_PIP_INDEX_URL

https://pypi.org/simple/

Адрес репозитория пакетов Python.

TNGRI_USE_FILE_CACHE

True

Кэширование файлов с данными.

TNGRI_USE_DECODE_CACHE

True

Кэширование декодированных данных.

Параметры эндпоинта

Переменная окружения Дефолт Описание

TNGRI_ENDPOINT_HOST

<advertized name>

Внешний адрес сервиса.

TNGRI_INTERNAL_HOST

<local net ip>

Внутренний IP-адрес.

TNGRI_CORS

http://<local net ip>:3000
http://<advertized name>
http://<advertized name>.<domain>

Список разрешенных CORS-источников.

Хранилище S3

Переменная окружения Дефолт Описание

TNGRI_S3_REGION

eu-central-1

Регион S3 для всех клиентов (boto3 / PyArrow / PyIceberg).
Экспортируется как AWS_REGION в Python-контейнеры.

TNGRI_S3_DEFAULT_REGION

eu-central-1

Экспортируется как AWS_DEFAULT_REGION для совместимости с boto3 / PyArrow.

TNGRI_S3_ACCESS_KEY_ID

(не задано)

Идентификатор ключа доступа S3, используемый всеми клиентами и Python-контейнерами.

TNGRI_S3_SECRET_ACCESS_KEY

(не задано)

Секретный ключ доступа S3, используемый всеми клиентами и Python-контейнерами. При установленном пакете tengri-minio генерируется при установке и хранится в /etc/tengri/secrets.env, см. Локальное хранилище MinIO.

TNGRI_S3_BUCKET_NAME

(не задано)

Бакет, содержащий данные хранилища Iceberg.
Экспортируется в контейнеры как TNGRI_S3_BUCKET_NAME.

TNGRI_S3_CONNECT_TIMEOUT

30

Таймаут установки соединения с S3 (в секундах).

TNGRI_S3_REQUEST_TIMEOUT

30

Таймаут выполнения запроса к S3 (в секундах).

TNGRI_S3_MAX_ATTEMPTS

20

Максимальное число повторных попыток соединения с S3.

TNGRI_S3_HTTP_KEEP_ALIVE

True

Использование открытых соединений для последующих запросов.

TNGRI_S3_MULTIPART_CONCURRENCY

10

Число параллельных соединений при многочастных передачах (boto3).

TLS веб-приложения

Переменная окружения Дефолт Описание

TNGRI_WEB_SSL_ENABLED

True, если задан ssl_key

Обслуживать веб-приложение по HTTPS.

TNGRI_WEB_SSL_KEY

= ssl_key

Ключ TLS для веб-приложения.

TNGRI_WEB_SSL_CERT

= ssl_cert

Сертификат TLS для веб-приложения.

TNGRI_WEB_SSL_CA

= ssl_ca

CA (Certificate Authority) TLS для веб-приложения.

TLS протокола PostgreSQL

Переменная окружения Дефолт Описание

TNGRI_PSQL_SSL_ENABLED

True, если задан psql_ssl_key

Предлагать TLS в протоколе PostgreSQL.

TNGRI_PSQL_SSL_KEY

= ssl_key

Ключ TLS для PostgreSQL.

TNGRI_PSQL_SSL_CERT

= ssl_cert

Сертификат TLS для PostgreSQL.

TNGRI_PSQL_SSL_CA

= ssl_ca

CA (Certificate Authority) для PostgreSQL.
Включает проверку клиентских сертификатов (взаимную аутентификацию).

TLS WebSocket

Переменная окружения Дефолт Описание

TNGRI_WEBSOCKET_SSL_ENABLED

True, если задан websocket_ssl_key

Обслуживать WebSocket по WSS.

TNGRI_WEBSOCKET_SSL_KEY

= ssl_key

Ключ TLS для WebSocket.

TNGRI_WEBSOCKET_SSL_CERT

= ssl_cert

Сертификат TLS для WebSocket.

TNGRI_WEBSOCKET_SSL_CA

= ssl_ca

CA (Certificate Authority) TLS для WebSocket.