Hướng dẫn cài đặt Docker Compose

Tài liệu này cung cấp các bước chi tiết để triển khai 88API bằng Docker Compose.

Điều kiện tiên quyết

• Đã cài đặt Docker và Docker Compose
• Hệ thống được đề xuất: Linux (Ubuntu/CentOS/Debian, v.v.)

Triển khai với Docker Compose

Cách 1: Sử dụng Git Clone (Khuyến nghị)

Nếu bạn có thể truy cập GitHub bình thường thì nên sử dụng phương pháp này. Dự án bao gồm một tập tin cấu hình docker-compose.yml hoàn chỉnh:

# Download project source code
git clone https://github.com/QuantumNous/new-api.git

# Enter project directory
cd new-api

# Edit docker-compose.yml as needed
# Using nano editor
nano docker-compose.yml
# Or using vim editor
# vim docker-compose.yml

Cách 2: Tạo file cấu hình thủ công

Nếu bạn không thể truy cập GitHub hoặc sao chép kho lưu trữ, bạn có thể tạo tệp cấu hình theo cách thủ công:

1. Tạo thư mục triển khai 88API:

mkdir new-api
cd new-api

1. Tạo một tập tin docker-compose.yml trong thư mục này

Bạn có thể tham khảo các ví dụ về cấu hình trong tài liệu Hướng dẫn cấu hình Docker Compose và chọn dựa trên nhu cầu của bạn:

• Môi trường sản xuất: Khuyến nghị sử dụng cấu hình hoàn chỉnh (bao gồm MySQL và Redis)
• Môi trường thử nghiệm: Có thể sử dụng cấu hình đơn giản

1. Tạo tệp bằng trình soạn thảo văn bản:

# Using nano editor
nano docker-compose.yml

# Or using vim editor
vim docker-compose.yml

Sao chép nội dung cấu hình đã chọn vào tệp này và tùy chỉnh nó nếu cần.

Dịch vụ khởi đầu

Sau khi tệp cấu hình sẵn sàng, cho dù bạn sao chép qua Git hay được tạo thủ công, bạn có thể sử dụng lệnh sau để khởi động dịch vụ:

# Start services using Docker Compose
docker compose up -d

Lệnh này sẽ tự động kéo các hình ảnh cần thiết và bắt đầu các dịch vụ ở chế độ nền.

Xem nhật ký

• Tất cả các dịch vụ (theo dõi)

docker compose logs -f

• Nhật ký của một dịch vụ cụ thể (ví dụ: new-api, mysql, redis)

docker compose logs -f new-api
docker compose logs -f mysql
docker compose logs -f redis

• Chỉ hiển thị N dòng mới nhất

docker compose logs --tail=100 new-api

• Hiển thị nhật ký kể từ một cửa sổ thời gian

docker compose logs --since=10m new-api

• Bao gồm dấu thời gian

docker compose logs -f -t new-api

• Gỡ lỗi chế độ tiền cảnh (truyền nhật ký khi bắt đầu)

docker compose up
# Or start and follow a single service
docker compose up new-api

Nhấn Ctrl+C để thoát chế độ nền trước (dịch vụ sẽ dừng). Sử dụng -d cho chế độ nền.

• Liệt kê các dịch vụ/trạng thái

docker compose ps

• Sử dụng tên vùng chứa để xem nhật ký (khi container_name được đặt, ví dụ: new-api)

docker logs -f new-api

Dừng dịch vụ

# Stop services
docker compose down

Truy cập hệ thống

Sau khi dịch vụ khởi động thành công, hãy truy cập http://server-IP:3000. Bạn sẽ được hướng dẫn đến trang khởi tạo để tạo tài khoản quản trị và mật khẩu (chỉ yêu cầu trong lần cài đặt đầu tiên). Sau khi khởi tạo, hãy đăng nhập bằng thông tin đăng nhập bạn đã tạo.