Chuyển tới nội dung chính

🚀 Triển khai

Hướng dẫn triển khai Xbook bằng Docker và những điểm cần lưu ý khi vận hành.

Chạy bằng Docker Compose​

services:
  db:
    image: postgres:16
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: xbook
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - db-data:/var/lib/postgresql/data

  xbook:
    image: xbook:latest
    depends_on: [db]
    ports:
      - "8069:8069"
    volumes:
      - ./addons:/mnt/extra-addons
      - app-data:/var/lib/odoo

volumes:
  db-data:
  app-data:
docker compose up -d

Biến môi trường quan trọng​

BiếnÝ nghĩa
DB_PASSWORDMật khẩu PostgreSQL.
ADMIN_PASSWDMaster password để tạo/khôi phục database.
WORKERSSố tiến trình xử lý (đặt > 0 cho môi trường production).

Vận hành​

  • Sao lưu: backup định kỳ cả database và thư mục filestore (đính kèm/ảnh).
  • Nâng cấp: chạy trên bản sao trước, kiểm thử addon tùy biến rồi mới áp dụng production.
  • HTTPS: đặt reverse proxy (Nginx/Caddy) trước cổng ứng dụng.
  • CI/CD: build image kèm addon, kiểm thử rồi phát hành theo tag phiên bản.
cảnh báo

Luôn đổi ADMIN_PASSWD mặc định và đóng cổng database ra Internet ở môi trường production.