Browse Source
- TZ.md: хостинг (Vercel), стек (актуальные версии Next.js 16/NestJS 11/Prisma 7/pnpm 10/Tailwind 4), раздел 12.2 с командой деплоя, закрыты ОВ-02 и ОВ-06 - SPRINTS.md: в Sprint 2 — ссылка на production URL; Sprint 12 — уточнены задачи деплоя - docs/DEPLOY.md: новый файл — инструкция по деплою фронтенда, локальной разработке, план автодеплоя через Gitea Actions, варианты хостинга бэкенда Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>sprint/3
AR 15 M4
1 week ago
3 changed files with 202 additions and 25 deletions
@ -0,0 +1,156 @@
|
||||
# Деплой — oclinica-brandbook |
||||
|
||||
## Текущее состояние |
||||
|
||||
| Сервис | Статус | URL | Платформа | |
||||
|------------|-------------|----------------------------------------|---------------| |
||||
| Фронтенд | ✅ Активен | https://web-oclinica.vercel.app | Vercel Hobby | |
||||
| Бэкенд | локально | http://localhost:3001 | Docker Compose | |
||||
| База данных | локально | localhost:5433 | PostgreSQL 16 | |
||||
|
||||
--- |
||||
|
||||
## Фронтенд — Vercel |
||||
|
||||
### Первоначальная настройка (уже выполнена) |
||||
|
||||
```bash |
||||
# 1. Установить Vercel CLI |
||||
npm install -g vercel |
||||
|
||||
# 2. Войти в аккаунт (однократно, открывает браузер) |
||||
vercel login |
||||
|
||||
# 3. Первый деплой из директории apps/web |
||||
cd apps/web |
||||
vercel --yes |
||||
``` |
||||
|
||||
### Деплой обновлений |
||||
|
||||
```bash |
||||
cd apps/web |
||||
vercel --prod --yes |
||||
``` |
||||
|
||||
Деплой занимает ~30 секунд. После завершения изменения сразу доступны по адресу: |
||||
**https://web-oclinica.vercel.app** |
||||
|
||||
### Как это работает |
||||
|
||||
- Vercel автоматически определяет Next.js и использует pnpm для сборки |
||||
- Каждый `vercel --prod` создаёт новый immutable deployment и привязывает его к production URL |
||||
- Предыдущие деплои остаются доступны по уникальным preview URL |
||||
- Логи билда: https://vercel.com/oclinica/web |
||||
|
||||
### Ограничения Vercel Hobby (бесплатный план) |
||||
|
||||
| Параметр | Лимит | |
||||
|-----------------------|-------------------------| |
||||
| Bandwidth | 100 GB / месяц | |
||||
| Builds | 6000 минут / месяц | |
||||
| Serverless Functions | 100 GB-hours / месяц | |
||||
| Тип использования | Только некоммерческие | |
||||
|
||||
Для брендбука (внутренний инструмент) лимитов более чем достаточно. |
||||
|
||||
--- |
||||
|
||||
## Локальная разработка |
||||
|
||||
### Запуск фронтенда |
||||
|
||||
```bash |
||||
# Из корня monorepo |
||||
pnpm dev |
||||
|
||||
# Или только фронтенд |
||||
cd apps/web && pnpm dev |
||||
``` |
||||
|
||||
Доступен на: http://localhost:3001 |
||||
|
||||
### Запуск бэкенда + БД |
||||
|
||||
```bash |
||||
# Запустить PostgreSQL |
||||
docker compose up -d |
||||
|
||||
# Запустить NestJS |
||||
cd apps/api && pnpm dev |
||||
``` |
||||
|
||||
### .env файлы |
||||
|
||||
```bash |
||||
# Скопировать и заполнить |
||||
cp .env.example .env |
||||
``` |
||||
|
||||
Содержимое `.env.example`: |
||||
``` |
||||
DATABASE_URL="postgresql://brandbook:brandbook@localhost:5433/brandbook" |
||||
API_PORT=3001 |
||||
NEXT_PUBLIC_API_URL=http://localhost:3001 |
||||
``` |
||||
|
||||
--- |
||||
|
||||
## Автодеплой через Gitea Actions (планируется в Sprint 12) |
||||
|
||||
Для автоматического деплоя при пуше в ветку `main` создать файл |
||||
`.gitea/workflows/deploy-frontend.yml`: |
||||
|
||||
```yaml |
||||
name: Deploy Frontend to Vercel |
||||
|
||||
on: |
||||
push: |
||||
branches: [main] |
||||
paths: |
||||
- 'apps/web/**' |
||||
|
||||
jobs: |
||||
deploy: |
||||
runs-on: ubuntu-latest |
||||
steps: |
||||
- uses: actions/checkout@v4 |
||||
|
||||
- name: Setup pnpm |
||||
uses: pnpm/action-setup@v4 |
||||
with: |
||||
version: 10 |
||||
|
||||
- name: Setup Node.js |
||||
uses: actions/setup-node@v4 |
||||
with: |
||||
node-version: 20 |
||||
cache: 'pnpm' |
||||
cache-dependency-path: apps/web/pnpm-lock.yaml |
||||
|
||||
- name: Install Vercel CLI |
||||
run: npm install -g vercel |
||||
|
||||
- name: Deploy to Vercel |
||||
run: cd apps/web && vercel --prod --yes --token ${{ secrets.VERCEL_TOKEN }} |
||||
``` |
||||
|
||||
**Настройка:** |
||||
1. Получить Vercel Token: https://vercel.com/account/tokens |
||||
2. Добавить в Gitea: Settings → Secrets → `VERCEL_TOKEN` |
||||
|
||||
--- |
||||
|
||||
## Хостинг бэкенда (планируется к Sprint 11) |
||||
|
||||
Бэкенд (NestJS + PostgreSQL) потребуется для экспериментальной секции (Sprint 11). |
||||
Варианты для рассмотрения: |
||||
|
||||
| Платформа | PostgreSQL | Бесплатно | Карта | |
||||
|-----------|-----------|-----------|-------| |
||||
| Railway | ✅ | $5 кредит / месяц | нужна | |
||||
| Supabase | ✅ | ✅ (PostgreSQL managed) | нет | |
||||
| Fly.io | ✅ | ✅ ограниченно | нет | |
||||
| VPS клиники | ✅ | ✅ (если есть) | нет | |
||||
|
||||
Рекомендация: **Supabase** для БД (бесплатно, managed PostgreSQL) + **Railway** или VPS для NestJS. |
||||
Loading…
Reference in new issue