fix(docker): แยก compose เป็น base (Dokploy) + override (ในเครื่อง) — แก้ port already allocated
Dokploy รัน `docker compose -f ./docker-compose.yml up -d --build` บน server
แล้วล้มที่ "Bind for 0.0.0.0:8095 failed: port is already allocated"
- docker-compose.yml: ถอด `ports:` ออก ใช้ `expose: ${PORT}` แทน (reverse proxy ต่อผ่าน compose network)
· ถอด `container_name` (ชนกันเมื่อมีหลาย deployment บนเครื่องเดียว)
· เปลี่ยน bind mount ./data → named volume `data` (Docker คัดลอก ownership uid 1000 จาก image
ทำให้ user `node` เขียน content/uploads/pglite ได้; bind mount บน Linux เป็น root:root = เขียนไม่ได้)
- docker-compose.override.yml (ใหม่): `ports: ${HOST_PORT}:${PORT}` + bind ./data — เฉพาะรันในเครื่อง
(Dokploy ระบุ `-f ./docker-compose.yml` ตรง ๆ จึงไม่โหลด override)
- README: อธิบาย compose 2 ชั้น, เหตุผลที่ห้าม publish พอร์ต/ใส่ container_name, และเตือนว่า data/ ไม่อยู่ใน git
This commit is contained in:
1 parent
b99e0940f7
commit
05487728a7
3 files changed
+37
-12
No files matched your search
@@ -98,7 +98,7 @@ AGENTS.md กฎสำหรับ agent/AI ที่แก้โค้
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
cp .env.example .env # ครั้งแรกเท่านั้น
|
cp .env.example .env # ครั้งแรกเท่านั้น
|
||||||
docker compose up -d --build
|
docker compose up -d --build # base + override (ในเครื่อง)
|
||||||
# → http://localhost:8095 (แก้พอร์ตด้วย HOST_PORT)
|
# → http://localhost:8095 (แก้พอร์ตด้วย HOST_PORT)
|
||||||
docker compose logs -f # ดู log
|
docker compose logs -f # ดู log
|
||||||
docker compose down # หยุด
|
docker compose down # หยุด
|
||||||
@@ -106,15 +106,25 @@ docker compose down # หยุด
|
|||||||
|
|
||||||
| env | ค่าตั้งต้น | หน้าที่ |
|
| env | ค่าตั้งต้น | หน้าที่ |
|
||||||
| ------------ | --------- | -------------------------------------------------- |
|
| ------------ | --------- | -------------------------------------------------- |
|
||||||
| `HOST_PORT` | `8095` | พอร์ตที่แมปออกเครื่อง host |
|
| `HOST_PORT` | `8095` | พอร์ตที่แมปออกเครื่อง host (มีเฉพาะ override) |
|
||||||
| `PORT` | `8080` | พอร์ตที่ Nitro ฟังในคอนเทนเนอร์ (`process.env.PORT`) |
|
| `PORT` | `8080` | พอร์ตที่ Nitro ฟังในคอนเทนเนอร์ (`process.env.PORT`) |
|
||||||
| `TZ` | — | โซนเวลาในคอนเทนเนอร์ (ส่งผ่าน `env_file: .env`) |
|
| `TZ` | `Asia/Bangkok` | โซนเวลาในคอนเทนเนอร์ |
|
||||||
|
|
||||||
ทั้งสองตัวอยู่ใน `.env` หรือสั่งตรงหน้า command ก็ได้: `PORT=9001 HOST_PORT=9001 docker compose up -d`
|
ทั้งสองตัวอยู่ใน `.env` หรือสั่งตรงหน้า command ก็ได้: `PORT=9001 HOST_PORT=9001 docker compose up -d`
|
||||||
|
|
||||||
- **ไฟล์**: `Dockerfile` (3 stage: deps → build → runtime, `node:22-bookworm-slim`, รันด้วย user `node`) · `docker-compose.yml` · `.dockerignore`
|
### ไฟล์ compose แยก 2 ชั้น
|
||||||
- **ข้อมูลไม่หาย**: `./data` ถูก mount เป็น volume → `content/content.json`, `uploads/`, `analytics/`, `pglite/` ยังอยู่หลัง `docker compose down` (ลบ volume = `docker compose down -v` เท่านั้นถึงจะหาย)
|
|
||||||
- **แก้เนื้อหาด้วยหลังบ้านแล้วไม่ต้อง rebuild** — `data/` เป็น mount ไม่ได้อบใน image · แต่ถ้าแก้ **โค้ด** ต้อง `docker compose up -d --build`
|
| ไฟล์ | ใครใช้ | มีอะไร |
|
||||||
|
| --------------------------- | ----------------------------------------- | ---------------------------------------------------------------------- |
|
||||||
|
| `docker-compose.yml` | **server / Dokploy** (`-f ./docker-compose.yml`) | `expose: PORT` อย่างเดียว ไม่ publish พอร์ต · named volume `data` · ไม่มี `container_name` |
|
||||||
|
| `docker-compose.override.yml` | **ในเครื่อง** (compose โหลดเองอัตโนมัติ) | `ports: HOST_PORT:PORT` + bind `./data` ให้เห็นไฟล์จริง |
|
||||||
|
|
||||||
|
- **ทำไมไม่ publish พอร์ตในไฟล์ base** — server มักมีพอร์ตนั้นถูกยึดอยู่แล้ว (`Bind for 0.0.0.0:8095 failed: port is already allocated`) และ Dokploy/Traefik ต่อเข้าพอร์ตในคอนเทนเนอร์ผ่าน network ของ compose อยู่แล้ว จึงใช้ `expose` พอ
|
||||||
|
- **ห้ามใส่ `container_name`** — ชื่อจะชนกันเมื่อมีหลาย deployment บนเครื่องเดียว (Dokploy ใช้ `-p <project>` อยู่แล้ว)
|
||||||
|
- **named volume บน server** — Docker คัดลอก ownership (uid 1000 = `node`) จาก image ให้ ทำให้แอปเขียน `content/`, `uploads/`, `pglite/` ได้ · bind mount `./data` บน Linux จะเป็น `root:root` แล้วเขียนไม่ได้
|
||||||
|
- **ข้อมูลไม่หาย**: ลบ volume = `docker compose down -v` เท่านั้นถึงจะหาย
|
||||||
|
- **แก้เนื้อหาด้วยหลังบ้านแล้วไม่ต้อง rebuild** — `data/` เป็น volume ไม่ได้อบใน image · แต่ถ้าแก้ **โค้ด** ต้อง `docker compose up -d --build`
|
||||||
|
- **ข้อมูลตั้งต้นบน server**: `data/` ไม่อยู่ใน git → volume เริ่มว่าง แอปจะ `seedContent()` จาก `app/lib/content-seed.ts` (เนื้อหาตัวอย่าง) ไม่ใช่ `content.json` ที่แก้ในเครื่อง — ต้องคัดลอก `data/content/content.json` ขึ้นไป หรือใส่ใหม่ผ่านหลังบ้านก่อนเปิดใช้งานจริง
|
||||||
- ถ้าพอร์ต 8080 บน host ถูกยึดอยู่แล้ว ให้ตั้ง `HOST_PORT` อื่น (ค่าตั้งต้น 8095)
|
- ถ้าพอร์ต 8080 บน host ถูกยึดอยู่แล้ว ให้ตั้ง `HOST_PORT` อื่น (ค่าตั้งต้น 8095)
|
||||||
- log ที่ขึ้น `DEPLOY_SETTINGS_REQUIRED` / `[automations] queued-run sweep failed` มาจากตัวจับเวลา automation/trigger ของ agent-native ที่ต้องใช้ hosted Postgres — ไม่กระทบหน้าเว็บ (ตั้ง `DATABASE_URL` ถ้าจะใช้จริง)
|
- log ที่ขึ้น `DEPLOY_SETTINGS_REQUIRED` / `[automations] queued-run sweep failed` มาจากตัวจับเวลา automation/trigger ของ agent-native ที่ต้องใช้ hosted Postgres — ไม่กระทบหน้าเว็บ (ตั้ง `DATABASE_URL` ถ้าจะใช้จริง)
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,10 @@
|
|||||||
|
# รันในเครื่อง (dev/preview) — compose โหลดไฟล์นี้อัตโนมัติเมื่อเรียก `docker compose up` เฉย ๆ
|
||||||
|
# Dokploy เรียก `-f ./docker-compose.yml` ตรง ๆ → ไม่โหลดไฟล์นี้ (จึงไม่ชนพอร์ตบน server)
|
||||||
|
services:
|
||||||
|
web:
|
||||||
|
ports:
|
||||||
|
# HOST_PORT = พอร์ตที่แมปออกเครื่อง host (8095 เพราะ 8080 มักถูกยึด)
|
||||||
|
- "${HOST_PORT:-8095}:${PORT:-8080}"
|
||||||
|
volumes:
|
||||||
|
# ในเครื่องเห็นไฟล์จริงที่ ./data (ใช้งาน/สำรองง่าย); บน server ใช้ named volume
|
||||||
|
- ./data:/app/data
|
||||||
+11
-6
@@ -4,7 +4,7 @@ services:
|
|||||||
context: .
|
context: .
|
||||||
dockerfile: Dockerfile
|
dockerfile: Dockerfile
|
||||||
image: alterflixhub-web:latest
|
image: alterflixhub-web:latest
|
||||||
container_name: alterflixhub-web
|
# ห้ามใส่ container_name: ชื่อต้องไม่ตายตัว ไม่งั้น Dokploy / หลายอินสแตนซ์บนเครื่องเดียวชนกัน
|
||||||
env_file:
|
env_file:
|
||||||
- path: .env
|
- path: .env
|
||||||
required: false
|
required: false
|
||||||
@@ -15,12 +15,14 @@ services:
|
|||||||
NODE_ENV: production
|
NODE_ENV: production
|
||||||
TZ: ${TZ:-Asia/Bangkok}
|
TZ: ${TZ:-Asia/Bangkok}
|
||||||
# SITE_URL / SHARE_ORIGIN ตั้งใน .env เมื่อต้องบังคับโดเมน
|
# SITE_URL / SHARE_ORIGIN ตั้งใน .env เมื่อต้องบังคับโดเมน
|
||||||
ports:
|
# ไม่ publish พอร์ตออก host: reverse proxy (Dokploy/Traefik) ต่อเข้าพอร์ตนี้ผ่าน network ของ compose
|
||||||
# HOST_PORT = พอร์ตที่แมปออกเครื่อง host (แยกจาก PORT เพื่อหลบพอร์ตที่ถูกยึด)
|
# ต้องเปิดพอร์ตออก host (รันในเครื่อง) → docker-compose.override.yml จัดการให้อัตโนมัติ
|
||||||
- "${HOST_PORT:-8095}:${PORT:-8080}"
|
expose:
|
||||||
|
- "${PORT:-8080}"
|
||||||
volumes:
|
volumes:
|
||||||
# เนื้อหาที่แก้ผ่านหลังบ้าน + รูปอัปโหลด + สถิติ + pglite
|
# named volume: Docker คัดลอก ownership (uid 1000 = user node) จาก image ให้ → เขียนไฟล์ได้
|
||||||
- ./data:/app/data
|
# (bind mount ./data บน Linux จะเป็น root:root ทำให้แอปเขียน content/uploads ไม่ได้)
|
||||||
|
- data:/app/data
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
healthcheck:
|
healthcheck:
|
||||||
test:
|
test:
|
||||||
@@ -31,3 +33,6 @@ services:
|
|||||||
start_period: 20s
|
start_period: 20s
|
||||||
retries: 3
|
retries: 3
|
||||||
|
|
||||||
|
volumes:
|
||||||
|
data:
|
||||||
|
|
||||||
Reference in new issue
Block a user