Files
Alvand-P/docs/QA-troubleshooting.md
2026-08-13 19:42:08 +03:30

95 lines
3.3 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.
<div dir="rtl">
# Alvand-P — QA و عیب‌یابی (Fibitex)
چک‌لیست عملیاتی برای staging (`beta.fibitex.com`) و لوکال. جزئیات deploy: [`Docs/Fibitex-staging-deploy.md`](../../Docs/Fibitex-staging-deploy.md).
## قبل از deploy
- [ ] `git pull` روی `Update2026`
- [ ] `bundle install` (در صورت تغییر Gemfile)
- [ ] `rake render:config`**بدون EPERM** روی `config/frontend/shahoo.env.js`
- [ ] Vault unsealed — [`scripts/unseal-vault.ps1`](../../scripts/unseal-vault.ps1) یا `rake vault:setup`
- [ ] `COMPOSE_FILE` درست (همه composeهای لازم)
## render:config / EPERM
| علامت | رفع |
|--------|-----|
| `shahoo.env.js` directory به‌جای فایل | پوشهٔ اشتباه را حذف؛ `rake render:config` دوباره |
| EPERM روی Windows | ترمینال admin یا exclude antivirus روی `config/` |
| تغییر template اعمال نشد | `rake render:config` نه فقط `restart` |
## Vault sealed
<div dir="ltr">
```bash
docker compose exec vault vault status
# Sealed → unseal با keys از ops
```
</div>
لوکال: `.\scripts\unseal-vault.ps1`
## Compose logging — recreate نه restart
`logging:` در compose فقط هنگام **create** کانتینر اعمال می‌شود.
<div dir="ltr">
```bash
export COMPOSE_FILE=compose/app.yaml:compose/backend.yaml:compose/gateway.yaml:compose/proxy.yaml:compose/daemons.yaml:compose/frontend.yaml
docker compose -p fibitex up -d --force-recreate
docker inspect fibitex_peatio_1 --format '{{.HostConfig.LogConfig.Type}} {{.HostConfig.LogConfig.Config}}'
```
</div>
## دو stack Carbon موازی
**هرگز** هم‌زمان `carbon` (legacy path) و `carbon_platform` با `-p carbon` up نکنید — لاگ و دیتا duplicate می‌شود.
فقط: `docker compose -p carbon -f docker-compose.prod.yml -f docker-compose.traefik.yml`
## Smoke tests
<div dir="ltr">
```bash
curl -sS -o /dev/null -w '%{http_code}\n' https://beta.fibitex.com/
curl -sS -o /dev/null -w '%{http_code}\n' https://shahoo.fibitex.com/health
docker compose -p fibitex ps
bash ~/main-code/scripts/check-docker-log-disk.sh
```
</div>
## دیسک / لاگ Docker
| علامت | اقدام |
|--------|--------|
| root >85% | `check-docker-log-disk.sh` exit 1 — `sudo truncate-docker-logs.sh` |
| لاگ یک کانتینر >100MB | truncate (نیاز sudo) یا `--force-recreate` بعد از log rotation |
| cron | `crontab -l` — هر ۶ ساعت → `~/log-disk-check.log` |
ارجاع: [`Docs/Fibitex-staging-deploy.md`](../../Docs/Fibitex-staging-deploy.md) §۸.۳، [`Docs/07-setup-server.md`](../../Docs/07-setup-server.md) §۶.۲
## Shahoo / BFF
- BFF: [`Shahoo-BFF/README.md`](../../Shahoo-BFF/README.md)
- E2E: `.\scripts\test-shahoo-e2e.ps1`
## مستندات مرتبط
| سند | موضوع |
|-----|--------|
| [`Docs/Fibitex-staging-deploy.md`](../../Docs/Fibitex-staging-deploy.md) | Deploy staging |
| [`Docs/07-setup-server.md`](../../Docs/07-setup-server.md) | Production |
| [`Docs/06-setup-local.md`](../../Docs/06-setup-local.md) | لوکال |
| [`Docs/troubleshoot-barong-authz.md`](troubleshoot-barong-authz.md) | Barong authz |
| [`carbon_platform/Docs/QA-troubleshooting.md`](../../carbon_platform/Docs/QA-troubleshooting.md) | Carbon |
</div>