ПеременныеУстранение неполадокСекрет или ссылка не отображаются

Секрет или ссылка не отображается в моем сервисе

Вы задали секрет или ${{name.KEY}} ссылку, переразвернули сервис, но работающий сервис всё равно не видит ожидаемое значение.

Что это значит

Заданное значение никогда не попало в объединённое окружение сервиса — или что-то другое при слиянии перезаписало его до запуска приложения.

Почему это может происходить

  • Цель ссылки или ключ не существует. Ссылка на несуществующее имя сервиса/аддона или на ключ, который аддон не предоставляет, преобразуется в пустую строку вместо ошибки развёртывания. В логе сборки для каждой пустой ссылки выводится предупреждение с указанием причины; если изменение переменной применено перезапуском, без сборки, предупреждения не будет. Переименованная цель считается отсутствующей для ссылок, заданных через lizard secrets set или дашборд: они сопоставляются с текущим именем. Цель-сервис не предоставляет DATABASE_URL или REDIS_URL, которые Lizard подставляет в него; вместо этого ссылайтесь на аддон.
  • Что-то с более высоким приоритетом перекрыло его. Значения объединяются в фиксированном порядке — addon-issued env < project secrets < project env < app env < app secrets < platform vars — поэтому секрет уровня проекта (--global) может быть неявно перекрыт секретом уровня сервиса с тем же ключом, а платформенные переменные (PORT, LIZARD_SERVICE_NAME, LIZARD_PROJECT_ID, LIZARD_PUBLIC_DOMAIN, LIZARD_PRIVATE_DOMAIN) всегда побеждают. PORT, который вы задали, меняет маршрутизацию только у сервиса, которому порт ни разу не задавали. У сервиса, созданного через lizard up или получившего порт через --port, lizard port или дашборд, Lizard перезаписывает его; меняйте порт командой lizard port <n>.
  • Значение времени сборки не попало в сборку. Большинство изменений переменных применяются без пересборки — сервис перезапускается, чтобы их подхватить. VITE_* и NEXT_PUBLIC_* запекаются в собранные артефакты, и их изменение через lizard secrets set или в настройках сервиса сразу запускает пересборку работающих сервисов. Правка на странице Secrets проекта в дашборде пересборку не запускает. Сервис, который в этот момент упал или был остановлен, пропускается, а сервис с собственным dockerfilePath или загруженный через lizard up без команд сборки/запуска никогда не получает эти значения во время сборки.

Возможные решения

Проверьте лог сборки на пустые ссылки

Доступ к оболочке сервисов (lizard ssh) отключён. Смотреть нужно в лог сборки: для каждой пустой ссылки там есть строка вида ==> Warning: ... is empty с указанием причины.

lizard logs --build --service api

Затем выведите ключи аддонов и ключи LIZARD_* и PORT каждого сервиса и сравните имя и ключ со своими. Ссылки на собственные переменные и секреты другого сервиса работают, но в этом списке их нет; проверьте их командой lizard secrets list --service <target>. Ключи проверяйте по документированным переменным аддона:

lizard secrets list --service api --ref

Проверьте на предмет коллизии областей

Выведите секреты в обеих областях и сравните:

lizard secrets list --service api --show
lizard secrets list --global --show

Помните: секреты приложения перекрывают секреты проекта — если существует значение уровня сервиса для того же ключа, оно побеждает всё, что задано через --global.

Пересоберите после изменения на этапе сборки

Если изменённый ключ — VITE_* или NEXT_PUBLIC_*, а сервис в момент изменения был упавшим или остановленным либо вы изменили ключ на странице Secrets проекта в дашборде, запустите пересборку:

lizard redeploy --service api

См. Время сборки vs. время выполнения и Сборка Pipeline → что запускает пересборку.

См. также

Перекрёстные ссылки между сервисамиСеть

Обновлено