Сборка и настройка
Переменные
Переменные окружения, общие переменные, секреты и ссылки между сервисами.
Переменные передаются сервису при запуске: API-ключи, токен бота, адрес базы данных. Они хранятся не в коде, а в Livops, и лежат в базе в зашифрованном виде.
Переменные сервиса
В разделе Переменные сервиса добавьте имя и значение.
- Имя: начинается с буквы или
_, далее буквы, цифры или_(^[A-Za-z_][A-Za-z0-9_]*$), до 128 символов. - Значение: до 4096 байт.
- До 100 переменных на сервис. Одно имя не может повторяться.
Новые значения вступают в силу со следующего деплоя. Чтобы применить их сейчас, перезапустите сервис.
Секреты
Если отметить переменную как секрет, после сохранения её значение больше никогда не возвращается — ни в кабинете, ни в API, ни даже звёздочками. Видно только имя.
- Чтобы обновить секрет, введите новое значение. Если оставить поле пустым, сохранится старое значение.
- Ассистент тоже видит только имена, но не значения.
Общие переменные
Значения, нужные всем сервисам одного окружения (например, SENTRY_DSN), хранятся на уровне окружения как общие переменные. Они передаются каждому сервису окружения.
Если в сервисе есть переменная с таким же именем, приоритет у сервиса.
Общие переменные меняет только пользователь в кабинете — API-токен может их читать, но не изменять.
Ссылки
Внутри значения можно сослаться на переменную другого сервиса или окружения:
API_URL=${{api.URL}}
DB_HOST=${{api.HOST}}
SENTRY_DSN=${{shared.SENTRY_DSN}}
TOKEN=${{worker.TOKEN}}
${{<сервис>.<ИМЯ>}}— переменная другого сервиса.${{shared.<ИМЯ>}}— общая переменная окружения.${{<сервис>.URL}},${{<сервис>.HOST}},${{<сервис>.PORT}}— адрес, известный платформе.
Ссылки работают только внутри своего окружения: сервис в staging не видит сервис в production.
Переменные от платформы
PORT— порт, который должно слушать серверное приложение (по умолчанию3000; для Docker-образа — указанный вами порт).- При подключении баз данных:
DATABASE_URL,REDIS_URL,MONGO_URL,MYSQL_URLи другие — Базы данных. - При подключении хранилища:
S3_*иAWS_*— Хранилища.
На статических сайтах
Статический сайт читает переменные во время сборки (VITE_*, NEXT_PUBLIC_* и т. п.), и они записываются в файлы — любой в браузере может их увидеть. Никогда не передавайте статическому сайту секретный ключ или пароль базы данных.