shop
198 lines
6.2 KiB
Markdown
198 lines
6.2 KiB
Markdown
# Сервер: установка и обновление
|
||
|
||
Инструкция **без привязки к конкретному домену или хостингу**. Подставьте свои значения:
|
||
|
||
| Переменная | Что это | Пример |
|
||
|------------|---------|--------|
|
||
| `SHOP_ROOT` | Каталог клона, где лежат `package.json` и `scripts/` | `/opt/shop` |
|
||
| `GIT_REPO_URL` | URL вашего git-репозитория | `https://forge.example.com/user/shop.git` |
|
||
| `SITE_URL` | Публичный URL магазина (для писем и passkey) | `https://shop.example.com` |
|
||
|
||
Проверка каталога:
|
||
|
||
```bash
|
||
export SHOP_ROOT=/opt/shop
|
||
test -f "$SHOP_ROOT/package.json" && echo OK || echo "Неверный SHOP_ROOT"
|
||
```
|
||
|
||
---
|
||
|
||
## Первая установка (Ubuntu, без Docker)
|
||
|
||
```bash
|
||
export SHOP_ROOT=/opt/shop
|
||
export GIT_REPO_URL='https://ВАШ-FORGE/путь/к/shop.git'
|
||
|
||
apt update && apt install -y git curl
|
||
git clone "$GIT_REPO_URL" "$SHOP_ROOT"
|
||
cd "$SHOP_ROOT"
|
||
|
||
sudo SHOP_INSTALL_DIR="$SHOP_ROOT" SHOP_GIT_URL="$GIT_REPO_URL" \
|
||
bash scripts/quick-deploy-ubuntu.sh
|
||
```
|
||
|
||
Скрипт: Node.js (если нет), PostgreSQL (PGDG), `.env`, `npm install`, служба **shop** (systemd).
|
||
|
||
---
|
||
|
||
## Обновление кода (сайт уже работает)
|
||
|
||
**Рекомендуется** — две команды (можно из любого каталога, не нужен `cd`):
|
||
|
||
```bash
|
||
export SHOP_ROOT=/opt/shop/shop10
|
||
bash "$SHOP_ROOT/scripts/server-update.sh"
|
||
```
|
||
|
||
Подставьте свой путь к клону (где лежит `package.json`). Часто это `/opt/shop` или `/opt/shop/shop10`.
|
||
|
||
Почему так надёжнее, чем `cd /opt/shop && git pull`:
|
||
|
||
- явно задан каталог репозитория (`SHOP_ROOT`);
|
||
- внутри выполняются `git-sync` (ветка `main`), `npm install`, перезапуск `shop`, проверка `/health`;
|
||
- не перепутаете родительскую папку без `package.json` и скриптов.
|
||
|
||
Проверка после обновления:
|
||
|
||
```bash
|
||
systemctl status shop
|
||
curl -s http://127.0.0.1:3000/health
|
||
```
|
||
|
||
Если git в detached HEAD отдельно:
|
||
|
||
```bash
|
||
cd "$SHOP_ROOT"
|
||
bash scripts/git-sync.sh
|
||
bash scripts/server-update.sh
|
||
```
|
||
|
||
---
|
||
|
||
## Скрипты в `scripts/`
|
||
|
||
| Скрипт | Назначение |
|
||
|--------|------------|
|
||
| `quick-deploy-ubuntu.sh` | Первая установка / полный цикл |
|
||
| `server-update.sh` | `git pull`, `npm install`, перезапуск shop |
|
||
| `git-sync.sh` | Исправить detached HEAD, синхронизация с `main` |
|
||
| `install-postgresql-ubuntu.sh` | PostgreSQL 17 через PGDG |
|
||
| `setup-postgres-ubuntu.sh` | Пользователь и БД `shop` |
|
||
| `install-shop-service.sh` | Установка systemd unit |
|
||
| `free-port-3000.sh` | Освободить порт (старый `npm start`) |
|
||
| `fix-db-connection.sh` | ECONNREFUSED :5432 |
|
||
| `diagnose-502.sh` | HTTP 502, Caddy |
|
||
| `diagnose-shop-service.sh` | Падение shop.service |
|
||
|
||
Все скрипты сами ищут `SHOP_ROOT` (каталог, откуда вызван `scripts/`, или переменная окружения).
|
||
|
||
---
|
||
|
||
## Частые ошибки
|
||
|
||
### `Unable to locate package postgresql-17`
|
||
|
||
В стандартном Ubuntu нет пакета 17. Не копируйте `apt install postgresql-17` из старых заметок.
|
||
|
||
```bash
|
||
sudo bash "$SHOP_ROOT/scripts/install-postgresql-ubuntu.sh"
|
||
bash "$SHOP_ROOT/scripts/setup-postgres-ubuntu.sh"
|
||
```
|
||
|
||
### `URL_РЕПОЗИТОРИЯ: No such file` или placeholder в команде
|
||
|
||
В документации иногда указан **шаблон**, а не команда. Клонируйте так:
|
||
|
||
```bash
|
||
git clone 'https://ВАШ-FORGE/shop.git' "$SHOP_ROOT"
|
||
```
|
||
|
||
### `package.json` ENOENT в `/opt/shop`
|
||
|
||
Вы в **родительской** папке, а клон в подкаталоге (или наоборот).
|
||
|
||
```bash
|
||
find /opt -name package.json 2>/dev/null
|
||
export SHOP_ROOT=/путь/где/найден
|
||
cd "$SHOP_ROOT"
|
||
```
|
||
|
||
### `You are not currently on a branch`
|
||
|
||
После `git checkout v0.x.x` репозиторий в detached HEAD.
|
||
|
||
```bash
|
||
cd "$SHOP_ROOT"
|
||
bash scripts/git-sync.sh
|
||
```
|
||
|
||
### `scripts/...: No such file or directory`
|
||
|
||
Запуск не из клона. Используйте полный путь:
|
||
|
||
```bash
|
||
bash "$SHOP_ROOT/scripts/server-update.sh"
|
||
```
|
||
|
||
### `Служба shop не установлена` / `Unit shop.service could not be found`
|
||
|
||
```bash
|
||
cd "$SHOP_ROOT"
|
||
sudo bash scripts/install-shop-service.sh
|
||
```
|
||
|
||
В `/etc/systemd/system/shop.service` поля `WorkingDirectory` и `EnvironmentFile` должны указывать на **`$SHOP_ROOT`**.
|
||
|
||
### `shop.service: status=1/FAILURE`, `activating (auto-restart)`
|
||
|
||
1. **Порт 3000 занят** (старый ручной Node) — health отвечает, systemd падает:
|
||
|
||
```bash
|
||
sudo bash "$SHOP_ROOT/scripts/free-port-3000.sh"
|
||
sudo systemctl restart shop
|
||
systemctl status shop
|
||
```
|
||
|
||
2. **PostgreSQL** — смотрите лог:
|
||
|
||
```bash
|
||
journalctl -u shop -n 40 --no-pager
|
||
bash "$SHOP_ROOT/scripts/diagnose-shop-service.sh"
|
||
```
|
||
|
||
3. **`.env` не в `SHOP_ROOT`** — скопируйте с прежнего места:
|
||
|
||
```bash
|
||
cp /старый/путь/.env "$SHOP_ROOT/.env"
|
||
sudo bash "$SHOP_ROOT/scripts/install-shop-service.sh"
|
||
```
|
||
|
||
### Изменения в git не видны на сайте
|
||
|
||
Обновление делали не в том каталоге или служба смотрит на другой путь:
|
||
|
||
```bash
|
||
cd "$SHOP_ROOT" && git log -1 --oneline
|
||
grep WorkingDirectory /etc/systemd/system/shop.service
|
||
bash scripts/server-update.sh
|
||
```
|
||
|
||
---
|
||
|
||
## Проверка
|
||
|
||
```bash
|
||
systemctl status shop
|
||
curl -s http://127.0.0.1:3000/health
|
||
```
|
||
|
||
Ожидается: `{"ok":true,"service":"shop","database":"postgresql"}` и **`Active: active (running)`**.
|
||
|
||
---
|
||
|
||
## Caddy / HTTPS
|
||
|
||
Пока `curl http://127.0.0.1:3000/health` не OK, reverse proxy будет отдавать **502**. Сначала backend, потом Caddy.
|
||
|
||
См. также: [Решение проблем](Troubleshooting), [Установка без Docker](Install-Native).
|