На этой странице

В панели#

  1. Добавить

    Сервис → «Переменные» → «Переменная»: имя и значение. Значение-секрет скрыто точками, глаз показывает его.

  2. Ссылки

    Кнопка «Ссылка на сервис» вставляет ${{ Сервис.ПЕРЕМЕННАЯ }} — например, адрес базы. Связи видны линиями на схеме.

  3. Много сразу

    «Редактор .env» — все переменные одним файлом: вставьте свой .env целиком, комментарии и порядок строк сохранятся. Вкладка «Общие» — переменные окружения для всех сервисов, «Итоговые» — что реально получит сервис.

  4. Применить

    Изменения применяются при следующем деплое: «Деплой» в обзоре или hangar redeploy.

Переменные сервиса
Переменные сервиса web: ссылки на Postgres и Redis и два секрета.

Управление переменными#

Переменные задаются на сервис и окружение. Изменения применяются при следующем деплое (hangar redeploy).

Терминал
hangar vars set NODE_ENV=production API_KEY=sk_live_… --seal
hangar vars set SENTRY_DSN=https://… --comment "куда шлём ошибки"
hangar vars list
hangar vars import .env.production
hangar vars import .env --replace   # удалить те, которых нет в файле
hangar vars export -o .env          # файл с комментариями, как был загружен
hangar vars resolved                # что реально получит сервис
hangar vars delete OLD_KEY

Комментарии в .env#

Файл .env загружается целиком, как есть. Hangar запоминает не только значения, но и сам документ: строки с #, пустые строки, порядок переменных, кавычки и комментарий после значения. «Редактор .env» в панели и hangar vars export возвращают тот же файл с текущими значениями.

Редактор .env с комментариями
Редактор .env: комментарии и разделы на месте, запечатанное значение записано как <sealed>.
env
# ===== База данных =====
# Основное подключение: API и воркер
DATABASE_URL=${{ Postgres.DATABASE_URL }}
DB_POOL=10  # соединений на реплику

# ===== Платежи =====
# Ключ меняем раз в год
STRIPE_KEY=<sealed>
#STRIPE_OLD_KEY=отключён
  • Комментарий над переменной виден в списке под её именем. Его можно править и без файла: «Изменить» → поле «Комментарий».
  • Новая переменная, добавленная кнопкой, встаёт в конец файла. Удалённая уходит вместе со своим комментарием.
  • Загрузка файла без «Удалить переменные, которых нет в списке» — частичная: комментарии остальных переменных остаются на месте.
  • Запечатанные значения записаны как NAME=<sealed>. Оставьте строку как есть — значение не изменится; файл можно скачать, поправить и загрузить обратно.
  • Строка-заголовок раздела (# ===== Платежи =====) относится ко всей группе под ней: она не считается комментарием первой переменной и остаётся, пока в группе есть хоть одна.
  • Комментарии хранятся зашифрованными, как значения: в них часто оказываются старые ключи.

Ссылки между сервисами#

Значение может ссылаться на переменные других сервисов: ${{ Postgres.DATABASE_URL }}, своего сервиса: ${{ PORT }}, или общие переменные окружения (--shared). Сгенерированный домен сервиса — ${{ HANGAR_PUBLIC_DOMAIN }}, приватный адрес — ${{ HANGAR_PRIVATE_DOMAIN }}.

Терминал
hangar vars set DATABASE_URL='${{ Postgres.DATABASE_URL }}'
hangar vars set --shared SENTRY_DSN=https://…

Локальный запуск с переменными сервиса#

Терминал
hangar run -- npm run migrate
hangar run -- python manage.py shell
hangar shell       # новый shell с переменными