Files
Govor/docs/timeweb-deployment.md
T

78 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Развёртывание 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
к смонтированному файлу. Старый ключ использовать нельзя.