> ## Documentation Index
> Fetch the complete documentation index at: https://docs.layeron.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloud deploy

> Как Layeron запускает проект в Cloud, какие бывают статусы и как работает hibernation.

## Когда включать Cloud

Включайте Cloud, если проекту нужны:

* постоянный preview URL
* хранение пользовательских изображений или ассетов
* переменные окружения для внешних API
* логи и диагностика запуска
* публикация или подключение домена

Если вы просто проверяете первый дизайн или короткий прототип, обычно достаточно preview в редакторе.

## Как устроен deploy

<Steps>
  <Step title="Проект готовится к запуску">
    Layeron собирает файлы проекта, проверяет ограничения и исключает опасные пути вроде `.env`, `.npmrc`, `.ssh`, абсолютных путей и `..`.
  </Step>

  <Step title="Cloud получает deploy-задачу">
    Deploy-задача ставится в очередь. Layeron собирает проект и запускает его в отдельном контейнере.
  </Step>

  <Step title="Проект получает preview URL">
    После успешного запуска Layeron обновляет статус проекта и показывает ссылку на preview.
  </Step>

  <Step title="Вы проверяете результат">
    Если приложение не запускается, откройте вкладку логов и попросите чат исправить ошибку по тексту лога.
  </Step>
</Steps>

## Статусы проекта

| Статус       | Что значит                                | Что делать                             |
| ------------ | ----------------------------------------- | -------------------------------------- |
| `building`   | Layeron собирает или перезапускает проект | Подождите завершения сборки            |
| `deployed`   | Проект запущен и доступен по preview URL  | Проверьте сценарии и UI                |
| `failed`     | Сборка или запуск завершились ошибкой     | Откройте логи и отправьте ошибку в чат |
| `fixing`     | Layeron пытается исправить проблему       | Дождитесь новой генерации              |
| `hibernated` | Контейнер остановлен после простоя        | Откройте preview или нажмите wake up   |

## Ресурсы

Во вкладке ресурсов отображаются CPU, RAM, лимиты плана и текущее потребление. Эти значения помогают понять, почему проект может тормозить, не запускаться или требовать апгрейда.

Free-проекты могут уходить в hibernation после простоя. Это экономит ресурсы, но первый запрос после простоя может быть медленнее. На платных планах проекты рассчитаны на более стабильную работу.

## Hibernation

Hibernation останавливает неактивный контейнер. Файлы проекта и настройки сохраняются, но процесс приложения больше не работает до пробуждения.

<Tip>
  Если preview долго не открывается после hibernation, подождите холодный старт и затем обновите страницу. Если статус перешел в `failed`, проверьте логи.
</Tip>

## Что проверять перед публикацией

* главная страница открывается без ошибок
* формы, кнопки и навигация работают
* изображения загружены через Storage, а не вставлены временными ссылками
* внешние API-ключи добавлены через Env
* в логах нет повторяющихся ошибок
* проект не превышает лимиты тарифа

<Warning>
  Не добавляйте секреты в промпт, код или публичные файлы проекта. Используйте переменные окружения во вкладке Env.
</Warning>