mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-16 20:56:03 +00:00
78 lines
5.6 KiB
Markdown
78 lines
5.6 KiB
Markdown
# Развёртывание 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
|
||
к смонтированному файлу. Старый ключ использовать нельзя.
|