Опубликовать — не значит загрузить папку

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

В этом курсе мы пройдём путь от готового локального приложения до работающего сервиса на Linux-сервере. В конце у вас будет не набор разрозненных команд, а воспроизводимый выпуск: домен ведёт на сервер, HTTPS включён, данные переживают пересборку, миграции применяются отдельно, письма и оплата проверяются сквозным сценарием, а откат описан до первой аварии.

Что считается результатом

Проект опубликован только тогда, когда одновременно выполняются пять условий:

Доступность. Человек открывает домен по HTTPS, а не вводит порт или технический IP.
Повторяемость. Вы можете выпустить следующую версию тем же порядком, не вспоминая случайные команды из истории терминала.
Сохранность. Перезапуск приложения и пересборка контейнера не стирают базу и загруженные данные.
Наблюдаемость. Есть короткий способ понять, жив ли процесс, отвечает ли база и где читать ошибку.
Проверенный пользовательский путь. Вы проверили не только главную страницу, но и вход, письмо, оплату и выдачу результата.

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

Граница курса

Мы исходим из того, что у вас уже есть рабочий проект на компьютере, репозиторий и понятная команда локального запуска. Установку Claude Code, основы Git и разговор с агентом разбирает курс «Первый проект с Claude Code» — здесь мы ими пользуемся, но не проходим заново.

Безопасность публичного продукта шире настройки сервера. Юридические документы, работа с персональными данными, правила возвратов, коммуникация с клиентами и предзапусковой разбор рисков входят в отдельный курс «Как превратить проект в продукт». Здесь остаётся технический минимум, без которого публикация не работает: секреты вне репозитория, закрытый порт приложения, защищённая cookie, подпись webhook и резервная копия.

На чём построен маршрут

Это не универсальная схема для любого масштаба. Мы берём понятный путь небольшого веб-продукта:

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

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

Как работать с Claude Code

На сервере цена ошибки выше, чем локально. Не просите агента «выложить всё» одним сообщением. Делите работу на наблюдаемые шаги: сначала прочитать проект и составить карту, затем подготовить конфиги, затем проверить их локально, затем выполнить одну операцию на сервере и снять результат.

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

Практика

Откройте локальный проект и попросите Claude Code подготовить файл docs/publish-readiness.md. В нём должны быть четыре блока:

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

Попросите агента подтверждать каждый пункт ссылкой на конкретный файл или команду проекта. Фразы «обычно здесь используется» и «скорее всего настроено» в итог не принимаются. Ничего на сервере пока не запускайте.

Проверка

В документе есть факты именно о вашем проекте, а не общий список технологий.
Отдельно перечислены база, загружаемые файлы и другие постоянные данные.
Записана команда локального старта и способ остановки.
Названы минимум три сквозных сценария кроме открытия главной страницы.
Вы можете одним предложением объяснить, где заканчивается этот курс и начинается «Как превратить проект в продукт».

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