Что такое приложение в Agnostic

Приложение в Agnostic — это сайт или API проекта с собственным кодом, публичным адресом и историей публикаций. На странице Приложения они собраны в одной галерее.

• Нужно понять, что уже опубликовано в проекте.
• Нужно перейти к коду, публикации, доменам или истории изменений конкретного сайта или сервиса.
• Нужно подготовить сайт и API одновременно, оставив каждому свой черновик и публикацию.

• Web-приложение или сайт.
• API или backend-сервис.
• Публичный адрес, если он уже доступен.
• Последние публикации и понятные статусы.
• Переход к коду и вкладки с доменами и настройками выбранного сайта или API.

Откройте Приложения, чтобы найти ресурс по имени или отфильтровать галерею по сайтам и API. Карточка показывает тип, состояние выбранного окружения и адрес после публикации. Время последней сохранённой версии находится в подробностях приложения. Если ресурс пока есть только в другом окружении, карточка не показывает чужой адрес как действующий. Нажмите карточку для подробностей. У сайта доступны вкладки Обзор, Доставка, Домены, История и Настройки; у API — Обзор, Метрики, Логи, Версии, Домены и Настройки. Вкладки сохраняют выбранное приложение и окружение. Кнопка Код открывает редактор, а К приложениям возвращает в галерею.

Название приложения и имя проекта под ним остаются на месте при переключении вкладок. Справа находятся действия Код, Открыть (когда доступен публичный адрес) и Опубликовать; ссылка К приложениям из любой вкладки возвращает в галерею.

Пока загружается галерея или вкладка, дождитесь появления её содержимого. При переключении вкладки плавно появляется только её содержимое. Если на устройстве включено уменьшение движения, анимация отключается. При ошибке загрузки раздел предложит повторить запрос.

Пустая карточка Создать приложение открывает короткую форму. Выберите Сайт, API или SSR или Сайт + API, при необходимости задайте имя и проверьте состав создаваемых ресурсов. Вариант API или SSR создаёт серверный контейнер со стартовым API-кодом; для страниц с SSR можно изменить его код. После создания откроется страница нового сайта или сервиса с подтверждением результата. Выбор Сайт + API создаёт сайт и отдельный API: откроется страница сайта, а API можно найти в общем списке приложений. У каждой части свой черновик и публикация. Подготовка контейнера идёт в фоне, поэтому API может появиться в состоянии подготовки до первой публикации.

В разделе App -> Код редактор открывает только рабочие файлы выбранного сайта или сервиса: исходный код, тесты, схемы и безопасные настройки. При первом входе открывается основной файл проекта, если он есть. Файлы сборки, кеши, зависимости, бинарные материалы и файлы с приватными ключами или токенами не показываются в редакторе, даже если они есть внутри проекта.

Если открыть Код из карточки приложения, над редактором появится ссылка К приложению «название». Она возвращает в исходное приложение, даже если вы выбрали в редакторе другое приложение или обновили страницу. При входе через пункт Код в левом меню этой ссылки нет.

В левом меню проекта пункт Код открывает редактор первого доступного сайта или сервиса. В верхней панели можно найти и выбрать другую часть приложения, сохранить черновик и начать публикацию. Поиск файла и команды находятся над вкладками. На рабочей ширине действия остаются в одной строке; на узком экране они переносятся, чтобы кнопки не обрезались.

Для работы с исходными файлами используйте Код. Сохранение версии, сборка и публикация доступны в редакторе выбранного приложения; логи и историю публикаций можно открыть из его карточки.

Рядом с заголовком дерева файлов есть отдельные кнопки создания файла и папки. Вложенные файлы и папки можно переименовывать, перемещать, копировать путь, дублировать и удалять. Меню … открывается у нужной строки; перенос в папку также доступен перетаскиванием. Несколько файлов остаются открытыми во вкладках. Кнопка Превью показывает последнюю опубликованную версию рядом с редактором. Перед закрытием файла или переключением части приложения редактор предупредит о несохранённых правках. Если содержимое файла не загрузилось, в строке вкладок останется имя файла и отметка ошибки: нажмите Повторить или откройте другой файл из дерева. Действия с файлами доступны ролям admin и developer; для platform_user редактор работает в режиме просмотра.

Авторизация находится на странице Приложения и в обзоре проекта. Она относится ко всем приложениям проекта и не зависит от выбранного файла в редакторе.

Перед сохранением изменений агент и редактор могут показать черновой diff по рабочим файлам. Приватные значения в таком diff скрываются.

На странице сайта или сервиса блок Разработка помогает выбрать один из трёх способов.

• Agent — добавьте текущий ресурс в Контекст, выберите Собрать и

опишите ожидаемый результат. Agent отдельно попросит подтвердить запись файлов, сохранение версии и сборку. Публикация выполняется отдельным подтверждаемым действием.

• Редактор в браузере — откройте Редактор, измените файл и сохраните

черновик. Проверьте diff в разделе Изменения, сохраните версию, запустите сборку, проверьте результат и затем отдельно опубликуйте его.

• Локальная разработка — установите Agnostic CLI, скачайте рабочую копию,

выполните npm install и npm run dev. После проверки отправьте изменения через CLI с запуском сборки, затем опубликуйте успешную сборку в Agnostic.

Роли admin и developer могут изменять код и запускать следующие этапы. platform_user может просматривать доступный код и получать локальные обновления, но не сохраняет изменения, не выполняет push и не публикует их.

Откройте приложение, перейдите на вкладку Настройки и нажмите Удалить сайт или Удалить API. В окне подтверждения проверьте название приложения. Кнопка удаления в этом окне запускает удаление; Отмена закрывает окно без изменений. Во время отправки запроса кнопки недоступны. Если запрос завершился ошибкой, окно останется открытым — можно повторить действие или отменить его.

После удаления сайт или backend-сервис остаётся в списке со статусом Удаляется на время отложенной очистки. В этот период ресурс уже не считается рабочим. Очистка ресурса начинается после семи дней; после её завершения ресурс исчезнет из списка.

На странице Приложения статус Удаляется заменяет Черновик или Работает. Наведите на статус или перейдите к нему с клавиатуры, чтобы увидеть срок очистки и возможность восстановления. Для восстановления нажмите Восстановить сайт или Восстановить сервис и подтвердите действие в окне.

Пока очистка не завершилась, откройте меню действий ресурса и выберите Восстановить сайт или Восстановить сервис. После восстановления проверьте публикацию и адрес. Если восстановление уже невозможно, обновите список: окончательно удалённые ресурсы больше не показываются и не доступны для восстановления.