Опубликуйте свой проект

Если на кнопке Publish или Update отображается "Your Cloud Balance is insufficient to publish" или "Your Cloud Balance is insufficient to update", значит средства в вашем Cloud wallet закончились.

Чтобы это исправить:

1. Перейдите в Settings > Cloud & AI, чтобы проверить текущий баланс.

2. Выберите Top up now и пополните Cloud wallet.

3. Вернитесь на панель Publish и попробуйте снова.

Примечание: ваш Cloud wallet отделен от кредитов подписки. Средства Cloud wallet используются для хостинга и развертывания, а кредиты подписки — для разговоров с ИИ-агентом.

1. Проверьте представление использования хранилища и определите самые большие чаты, проекты и файлы.
2. Скачайте или создайте резервные копии всего, что может понадобиться позже.
3. Удаляйте только ненужные элементы. Если при удалении чата предлагается удалить связанные данные на диске, выбирайте этот вариант только после подтверждения, что данные можно безопасно удалить.
4. Обновите страницу и убедитесь, что доступное место в хранилище увеличилось.
5. Вернитесь в Publish и повторите попытку.

Удаление может быть необратимым и может нарушить работу проекта, который ссылается на удаленный файл. Если объем использования не уменьшается, обратитесь в Support и приложите представление хранилища, тариф, ссылку на проект и время неудачной публикации.

Дождитесь завершения сканирования безопасности, затем проверьте каждый отмеченный элемент перед публикацией.

1. Выберите Resolve All и проверьте затронутое поведение. Исправьте проблемы, связанные с раскрытыми секретами, аутентификацией, разрешениями, пользовательскими данными или небезопасным внешним доступом, прежде чем использовать проект в продакшне.
2. Если секрет мог быть раскрыт, удалите его из проекта и замените через соответствующего провайдера перед публикацией.
3. Запустите сканирование снова и проверьте затронутый сценарий.
4. Используйте Publish Anyway только если ответственный проверяющий понимает и принимает оставшийся некритичный риск. Зафиксируйте причину и не обходите неустраненный риск на продакшн-сайте.

Если вы не можете определить влияние результата, не публикуйте проект. Обратитесь в Support или к ответственному за безопасность и передайте текст результата и очищенные от чувствительных данных доказательства.

1. Проверьте production URL платформы и пользовательский домен по отдельности. Также сравните корневую страницу с конкретной страницей или путем API, где возникает ошибка.
2. Зафиксируйте точный код статуса, полный URL, время и часовой пояс, а также то, является ли ошибка постоянной или периодической.
3. Проверьте последний статус развертывания и не совпадает ли начало ошибки с недавним изменением зависимости, переменной окружения, базы данных или внешнего сервиса.
4. Сохраните соответствующие ошибки Console и Network.

Если проблема сохраняется, обратитесь в Support и укажите шаги воспроизведения, затронутую версию и очищенную диагностику. Перед отправкой HAR, вывода команды или скриншота удалите cookie, заголовки Authorization, токены, секретные параметры запроса, персональные данные и платежную информацию.

Если развертывание завершается по тайм-ауту или опубликованный сайт временно недоступен:

1. Проверьте, недоступны ли и платформенный поддомен Prod, и Preview, или только один из них.

2. Оставьте текущую страницу ошибки открытой — не нажимайте Publish многократно.

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

Если проблема сохраняется, обратитесь в Support и укажите:

- Ссылку на проект и опубликованный URL

- Время сбоя и ваш часовой пояс

- Номер версии и скриншот страницы ошибки

- Работает ли Preview нормально

- Изменяли ли вы недавно зависимости, точку входа запуска или подключение к базе данных

Если на панели Publish отображается "latest" с неактивной кнопкой или она зависла на "Building":

1. Не нажимайте Publish многократно — это не ускорит процесс и может создать дублирующиеся задачи сборки.

2. Подождите несколько минут и обновите страницу.

3. Если после обновления статус не изменился, обратитесь в Support.

При обращении в Support укажите следующее:

- Ссылку на чат

- Полный скриншот панели Publish (включая URL страницы, номер версии и статус кнопки)

- Время возникновения и ваш часовой пояс

- Текущий отображаемый номер версии

- На каком шаге начало отображаться "Building" или кнопка стала серой

1. Проверьте, отсутствует ли изображение в Просмотр приложений, на опубликованном сайте или в обоих местах.
2. Один раз выберите Reload App Viewer. Если проблема есть только на опубликованном сайте, убедитесь, что последняя версия была опубликована или обновлена.
3. Сообщите Agent страницу, изображение, которое должно отображаться, и откуда это изображение было изначально взято. Попросите его проверить, что текущий проект по-прежнему использует правильное имя и расположение изображения.
4. Если исходное изображение было удалено или переименовано, снова загрузите или выберите нужное изображение, затем повторно проверьте страницу.
5. Если изображение использует Хранилище приложения или другой подключенный сервис, убедитесь, что нужный сервис подключен и файл все еще существует в нем.

Если изображение по-прежнему не загружается, обратитесь в Atoms Support и укажите Chat Link, URL затронутой страницы, имя или источник изображения и скриншот. Не включайте приватные ссылки доступа, пароли, ключи или токены.

Если экспортированный пакет для самостоятельного хостинга успешно скачивается, но не запускается:

1. Проверьте README, включенный в экспортированный пакет, на наличие требований к окружению и шагов настройки.

2. Убедитесь, что ваша среда выполнения соответствует требованиям (версия ОС, версия Docker, версия Node.js).

3. Выполните команду запуска и проверьте полный вывод на наличие сообщений об ошибках.

Если проблема сохраняется, обратитесь в Support и укажите:

- Версию экспорта и время скачивания

- Используемую ОС и версию Docker

- Полную выполненную команду и полный вывод

- Скрипт или путь API, где произошел сбой

- Ожидаемый способ развертывания

Важно: приложите очищенный пример конфигурации, но НЕ включайте пароли, секреты или токены.

Просмотр приложений и опубликованный сайт показывают разные стадии вашего проекта. Сохранение визуального изменения само по себе не обновляет работающий сайт.

1. В Design выберите Save и дождитесь завершения текущей задачи Agent или сборки.
2. Откройте Publish. Публикация использует последнюю версию проекта; на панели Publish нет выбора версии.
3. Выберите Publish для первого релиза или Update для последующего. Дождитесь, пока на панели не появится Up to date.
4. Откройте опубликованный сайт в новой вкладке и один раз обновите его.
5. Если адрес Atoms по умолчанию показывает изменение, а пользовательский домен — нет, проверьте подключение домена вместо многократной публикации одной и той же версии.

Если опубликованный сайт по-прежнему показывает неправильную версию, обратитесь в Atoms Support и укажите Chat Link, опубликованный URL, версию, которую вы собирались опубликовать, время и часовой пояс, а также скриншоты Просмотр приложений и опубликованного сайта.

1. Сразу ограничьте риск. Если релиз раскрывает чувствительные данные или создает небезопасное поведение, откройте App Status и используйте Pause для подходящего приложения Atoms Cloud или Unpublish, чтобы убрать публичный доступ. Если активного риска нет, не создавайте ненужный простой.
2. Зафиксируйте затронутый домен, время публикации, текущую версию, предполагаемую версию и влияние на бизнес.
3. После остановки текущей задачи агента откройте Версияs, выберите последнюю заведомо рабочую версию и нажмите Restore this version.
4. Проверьте восстановленную версию в Preview, включая критически важные сценарии входа, оплаты и работы с данными, затем опубликуйте или обновите ее.

Восстановление версии проекта может не отменить изменения в production-базе данных или внешние действия. Не перезаписывайте и не удаляйте production-данные, чтобы имитировать откат. Немедленно обратитесь в Support, если затронуты данные, учетные данные, платежи или разрушительные изменения.

1. Остановите текущую задачу агента или дождитесь ее завершения; версию нельзя восстановить, пока выполняется конфликтующая работа.
2. Откройте Версияs, найдите последнюю заведомо рабочую версию и выберите Restore this version.
3. Проверьте восстановленный проект в Preview и протестируйте критически важные сценарии, которые изменились.
4. Публикуйте или обновляйте проект только после того, как результат в Preview будет корректным.

Восстановление версии проекта не обязательно откатывает записи production-базы данных, изменения схемы, переменные окружения, платежи, письма или другие внешние действия. Если релиз изменил production-данные или нужная версия недоступна, остановитесь и обратитесь в Support, указав оба номера версий, затронутый домен и требуемый результат по сохранению данных.

Pause и Unpublish — это два разных действия:

Pause (только для проектов Atoms Cloud):

- Приложение становится недоступным для посетителей.

- Серверные ресурсы остаются выделенными, и оплата продолжается.

- Вы можете в любой момент возобновить приложение через App Status.

Unpublish (для всех проектов):

- Сайт полностью отключается. Все, кто использует опубликованный URL, теряют доступ.

- Для проектов Atoms Cloud серверные ресурсы освобождаются.

- Позже вы можете снова опубликовать проект, но до этого посетители не смогут получить к нему доступ.

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

Если браузер показывает "too many redirects" или страница постоянно перезагружается без отображения содержимого:

1. Попробуйте стандартный поддомен Prod платформы (не пользовательский домен), чтобы определить, вызван ли цикл перенаправления конфигурацией домена или самим приложением.
2. Если стандартный поддомен Prod работает, проверьте настройки DNS пользовательского домена и правила перенаправления у регистратора домена, которые могут конфликтовать с платформой.
3. Очистите кэш браузера или проверьте в режиме инкогнито, чтобы исключить влияние закэшированных перенаправлений.

Если проблема сохраняется, обратитесь в Support и укажите:

- Полный URL, на котором возникает цикл перенаправления

- Доступен ли стандартный поддомен Prod

- Имя домена и DNS-провайдера

- Полный скриншот ошибки

Если ваше приложение работает в Preview, но не работает в production из-за отсутствующих или пустых переменных окружения:

1. Проверьте, была ли переменная окружения сохранена до или после последней публикации. Если после, вам нужно снова опубликовать проект, чтобы изменение вступило в силу.
2. Убедитесь, что переменная задана для правильного окружения (Development или Production).
3. Проверьте, не дает ли сообщение об ошибке от нижестоящего сервиса подсказку — например, "unauthorized" часто означает, что ключ API пустой или неверный в этом окружении.

Если проблема сохраняется, обратитесь в Support и укажите:

- Ссылку на проект или опубликованный URL

- Имя затронутого ключа и окружение, в котором возникает проблема

- Полную ошибку от нижестоящего сервиса

- Очищенный скриншот страницы конфигурации

- Была ли конфигурация сохранена до или после публикации

Важно: указывайте только имена ключей. НЕ отправляйте секретные значения, пароли или токены.

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

1. Сравните название результата и место, указанное для каждого результата.
2. Проверьте каждое уникальное место, а не игнорируйте повторяющуюся формулировку.
3. Если несколько результатов имеют одну и ту же основную причину, устраните ее, а затем снова проверьте каждое место.
4. Запустите сканирование безопасности снова для обновленной версии.

Если один и тот же результат и место по-прежнему появляются более одного раза, обратитесь в Atoms Support и укажите Chat Link, время сканирования и часовой пояс, количество результатов и скриншот с удаленными чувствительными данными. Удалите все пароли, ключи, токены и другую конфиденциальную информацию, которая может отображаться в результате.

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

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

Если вы обнаружили проблему в production, которая может раскрыть учетные записи, личные данные, платежи или учетные данные, сначала прекратите использование затронутой функции или ограничьте к ней доступ. Замените все учетные данные, которые могли быть раскрыты, затем обратитесь в Atoms Support и укажите Chat Link, затронутую версию, шаги воспроизведения проблемы, время и часовой пояс, а также скриншот с удаленными чувствительными данными. Не передавайте сами раскрытые учетные данные.

Если сканирование сообщает, что действие только для администратора может быть незащищенным, считайте этот результат неустраненным, пока не подтвердите, что неавторизованные пользователи не могут его использовать. Скрыть кнопку администратора недостаточно, если действие все еще можно запросить другим способом.

1. Откройте результат и определите действие или место, которое в нем указано.
2. Определите, каким вошедшим в систему ролям должно быть разрешено использовать это действие.
3. Попросите Agent проверять разрешение пользователя в момент запроса действия, а не только при отображении кнопки.
4. Протестируйте действие в состоянии выхода из системы, с обычной тестовой учетной записью и с авторизованной тестовой учетной записью администратора.
5. Убедитесь, что отклоненные попытки не раскрывают личные данные и не вносят изменений, затем снова запустите сканирование безопасности.

Не публикуйте затронутую функцию, если неавторизованная учетная запись все еще может использовать это действие. Обратитесь в Atoms Support и укажите Chat Link, текст результата, затронутую версию и скриншот с удаленными чувствительными данными, если вы не можете решить проблему.

HTTPS защищает информацию во время передачи между пользователем и сервисом. Если сканирование сообщает о проблеме с HTTPS, используйте точный текст результата, чтобы определить затронутый адрес, ресурс, callback или конфигурацию домена.

1. Откройте результат и запишите точное место и адрес, указанные в нем.
2. Попросите Agent заменить это конкретное соединение на безопасный адрес, поддерживаемый его провайдером, или исправить связанную конфигурацию домена.
3. Не игнорируйте предупреждения сертификата и не меняйте адрес вслепую, если внешний сервис не документирует безопасный эквивалент.
4. Повторно протестируйте затронутый пользовательский сценарий и убедитесь, что ни пароль, ни токен, ни платежные данные, ни личная информация не передаются по небезопасному соединению.
5. Снова запустите сканирование безопасности для обновленной версии.

Если результат касается пользовательского домена или сертификата, который вы не можете исправить, обратитесь в Atoms Support и укажите Chat Link, затронутый URL, текст результата, время и часовой пояс, а также скриншот с удаленными чувствительными данными.

Row Level Security, или RLS, — это функция Supabase, которая управляет тем, какие строки базы данных каждый пользователь может читать или изменять. Этот результат актуален только если проект использует Supabase и сканирование указывает таблицу, правила доступа к которой нужно проверить.

1. Откройте результат и определите таблицу, указанную в нем.
2. Запишите, кто должен иметь возможность просматривать, добавлять, редактировать или удалять данные этой таблицы.
3. Попросите Agent создать политики Supabase с минимально необходимыми разрешениями, которые поддерживают эти пользовательские сценарии.
4. Протестируйте в состоянии выхода из системы и с отдельной тестовой учетной записью для каждой роли. Убедитесь, что каждая учетная запись может получать доступ только к предназначенным строкам и действиям.
5. После применения политик снова запустите сканирование безопасности.

Не отключайте RLS и не разрешайте доступ всем пользователям только ради устранения предупреждения. Перед внесением изменений, которые могут повлиять на существующие данные, подтвердите план и при необходимости сохраните безопасную резервную копию или экспорт. Никогда не передавайте ключи Supabase или учетные данные базы данных в Chat или на скриншотах.