# Развёртывание Govor в Timeweb App Platform ## Настройки и секреты appsettings.json содержит общие параметры без паролей. launchSettings.json действует только локально: HTTP localhost:7155, HTTPS localhost:7156. Timeweb собирает Dockerfile из корня репозитория. Контейнер слушает HTTP 8080; HTTPS клиентов обеспечивает Timeweb. Локальные секреты находятся в .NET User Secrets проекта Govor.API вне Git и автоматически загружаются в Development. Это локальный JSON, а не зашифрованное хранилище. Управлять им можно через Rider → Manage User Secrets. В Timeweb задайте переменные окружения только этого приложения, без флажка «Сохранить как глобальную». Имена есть в .env.example: - ASPNETCORE_ENVIRONMENT=Production - ASPNETCORE_HTTP_PORTS=8080 - Firebase__Enabled=false - ConnectionStrings__GovorDbContext — строка подключения с новым паролем - JwtAccessOption__SecretKey — случайный закрытый ключ не короче 32 байт - EncryptionOption__Secret — закрытый HMAC-ключ для refresh-токенов Переменные окружения переопределяют appsettings. Двойное подчёркивание обозначает вложенный параметр: ConnectionStrings__GovorDbContext → ConnectionStrings:GovorDbContext. Не помещайте секреты в Dockerfile, аргументы сборки или Git. Пустые обязательные секреты в Production останавливают сервер с указанием имени настройки. ## PostgreSQL и TLS Используйте домен из GovorDB → Подключение и сертификат Timeweb: ```text Host=<домен-БД>;Port=5432;Database=default_db;Username=gen_user;Password=<новый-пароль>;SSL Mode=VerifyFull;Root Certificate=/app/certs/postgres-ca.crt ``` Публичный CA находится в Govor.API/certs/postgres-ca.crt и включён в образ. Локально укажите абсолютный путь к этому файлу. После включения TLS дождитесь доступности домена в DNS; не отключайте проверку сертификата. Приватный IP работает при общей приватной сети приложения и БД — публичный IP БД тогда не нужен. Для приложения без этой сети используйте публичное подключение с TLS и firewall с учётом адресов приложения и разработчика. Мобильный клиент обращается к API по HTTPS, а не непосредственно к PostgreSQL. ## Миграции Перед обновлением существующей БД проверьте назначение подключения и сделайте бэкап. Миграция групп удаляет старую колонку и очищает дубли/осиротевшие записи. Запускайте из контейнера с теми же переменными окружения: ```sh dotnet Govor.API.dll --migrate-only ``` Команда применяет только отсутствующие миграции и завершает процесс. HTTP и push не запускаются; Firebase не нужен. Ошибка возвращает ненулевой код. Обычный запуск не меняет схему. При запуске опубликованного сервера на компьютере передайте настройки через окружение: User Secrets в Production не загружаются. ## Проверка - Путь проверки Timeweb: /server/ping. HTTP 200 означает, что API запущен. - /server/ready возвращает 200, когда доступна БД и нет неприменённых миграций, либо 503 без реквизитов подключения при проблемах БД/схемы. - Затем проверьте вход и SignalR по HTTPS/WSS. - Для uploads требуется постоянное хранилище: пересоздание контейнера может удалить файлы. ## Ранее опубликованные ключи Удаление значения из файла не удаляет его из истории Git. Смените опубликованные пароль PostgreSQL и JWT-ключ. Смена EncryptionOption:Secret делает старые refresh-токены недействительными и требует повторного входа; этот параметр не шифрует сообщения. Отзовите опубликованный ключ Firebase в Google Cloud, даже если Firebase отключён. Чтобы вернуть push позже, выпустите новый ключ вне репозитория и задайте Firebase__Enabled=true вместе с Firebase__CredentialsJson либо Firebase__CredentialsPath к смонтированному файлу. Старый ключ использовать нельзя.