Представляем Livops 2.0! ПромокодCEOдарит 8 000 сумов на ваш счёт.Что нового
Сборка и настройка / Переменные

Сборка и настройка

Переменные

Переменные окружения, общие переменные, секреты и ссылки между сервисами.

Переменные передаются сервису при запуске: 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_* и т. п.), и они записываются в файлы — любой в браузере может их увидеть. Никогда не передавайте статическому сайту секретный ключ или пароль базы данных.

Есть вопрос? — @livops_uz