Переменные окружения серверной поставки CodeGraph

Этот справочник нужен администратору серверной установки. Он перечисляет все имена из поставляемого .env.example и подстановок docker-compose.yml текущей версии. Настраивайте их в защищённом /opt/codegraph/.env только для включённых сервисов и функций.

В столбце «Образец» показано значение из .env.example. Перед запуском нужных сервисов задайте учётные данные и замените адреса примера адресами своей установки. «Резерв Compose» применяется, когда переменная не задана. Если переменная задана пустой строкой, Compose может использовать резервное значение при форме ${VARIABLE:-value}. Прочерк означает отсутствие значения в данном источнике; «нет резерва» означает прямую подстановку ${VARIABLE}: при отсутствии значения Compose предупреждает и подставляет пустую строку. Для включённых сервисов задайте нужные секреты в .env. В config.yaml выберите провайдера и включите функции, которые будут использовать эти учётные данные.

Для настройки по шагам см. Конфигурацию развёртывания. Не публикуйте рабочий .env и не вставляйте секреты в обращения поддержки.

База данных, API и браузер

Здесь находятся параметры базы данных, начального администратора, браузерного доступа, публичных адресов API и разрешённых Git-серверов. Замените адреса codegraph.ru адресами своего развёртывания, если соответствующие интерфейсы доступны пользователям.

CODEGRAPH_OUTBOUND_GIT_ORIGIN_ALLOWLIST принимает точные HTTPS-источники (схема, имя хоста и порт) через запятую, например https://git.internal.example,https://git2.internal.example:8443. Пустое значение запрещает исключения для внутренних Git-серверов. Диапазоны адресов и шаблоны с * не поддерживаются.

Провайдеры моделей и OpenViking

Ключи задавайте только для выбранных провайдеров. OPENVIKING_CONFIG_TEMPLATE выбирает файл шаблона; OPENVIKING_API_KEY защищает его API. Чтобы локально строить векторные представления и повторно ранжировать результаты, дополнительно выберите профиль COMPOSE_PROFILES=local-models.

Оркестрация и финансовые артефакты

Эти параметры управляют Temporal, передачей задач и проверкой финансовых артефактов. Ключи подписи и проверки задавайте из одобренного хранилища секретов. TEMPORAL_WORKER_CONTAINER_MEMORY_LIMIT ограничивает память контейнера temporal-worker; его резервное значение — 4G. Учитывайте этот лимит вместе с лимитами GoCPG ниже.

Git и учётные данные интеграций

Здесь задаются подключения GitVerse и GitHub, а также параметры GoCPG. Для GitLab используйте разрешённый HTTPS-источник выше и задайте секрет подключения через интерфейс или API.

Память GoCPG и DuckDB

GOCPG_CONTAINER_MEMORY_LIMIT задаёт общий лимит памяти контейнера gocpg. GOCPG_DUCKDB_BULK_MEMORY_LIMIT ограничивает память DuckDB при построении и обновлении CPG, а GOCPG_DUCKDB_READONLY_MEMORY_LIMIT — при чтении. CPG — граф свойств кода, который CodeGraph использует для анализа проекта. Оба лимита DuckDB передаются контейнерам api, mcp, temporal-worker и gocpg: эти службы могут запускать нативный анализатор или читать CPG.

Лимит DuckDB не ограничивает всю память процесса. Парсер, граф и анализаторы GoCPG также занимают память. Оставьте для них запас внутри лимита контейнера; сумма лимитов контейнеров и потребностей остальных служб должна укладываться в доступную память сервера. Начните с 8G / 3GB / 1GB, измерьте потребление на своём проекте и скорректируйте лимиты по результатам.

На сервере с Docker Compose, из каталога поставки, добавьте в существующий файл .env следующие строки. Не заменяйте остальные настройки и секреты:

GOCPG_CONTAINER_MEMORY_LIMIT=8G
GOCPG_DUCKDB_BULK_MEMORY_LIMIT=3GB
GOCPG_DUCKDB_READONLY_MEMORY_LIMIT=1GB

Дождитесь завершения текущих импортов и аудитов. В Bash (Linux/macOS) или PowerShell выполните команды из того же каталога. Если поставка использует дополнительные Compose-файлы, укажите те же -f при перезапуске:

docker compose up -d --no-build --no-deps api mcp temporal-worker gocpg
docker compose exec -T gocpg sh -c 'printenv GOCPG_DUCKDB_BULK_MEMORY_LIMIT GOCPG_DUCKDB_READONLY_MEMORY_LIMIT'
docker inspect codegraph-gocpg --format '{{.HostConfig.Memory}}'
docker stats --no-stream codegraph-api codegraph-mcp codegraph-temporal-worker codegraph-gocpg

При этих значениях printenv выводит 3GB и 1GB, а docker inspect — 8589934592 (8 ГиБ в байтах). Повторите аудит и наблюдайте потребление памяти. После сбоя проверьте события Docker: автоматический перезапуск может скрыть предыдущий OOM в текущем состоянии контейнера.

docker events --since 30m --until 0s --filter container=codegraph-gocpg --filter event=oom

Если GoCPG запускается напрямую вне этой Compose-поставки, значения по умолчанию в нативном коде — 8GB для записи и 4GB для чтения. Переменные DuckDB переопределяют их, а GOCPG_CONTAINER_MEMORY_LIMIT действует только в Compose.

Безопасность и хранилище секретов

Флаги включают защитные функции, а параметры Vault и mTLS задают способ получения секретов и проверки клиентских сертификатов.

Мониторинг и уведомления

Адреса Sentry, почты и метрик в образце относятся к примерному окружению; замените их адресами своей инфраструктуры перед включением соответствующих сервисов.

Развёртывание и Docker

Эти параметры определяют метки развёртывания, версии образов и ограничения логов.

COMPOSE_PROFILES — переменная Docker Compose, а не подстановка в docker-compose.yml. Её исходное значение пусто: дополнительные профили выключены. Для локальных моделей задайте local-models; перечень профилей проверяйте в файле Compose вашей версии.