Hướng dẫn dùng Docker để tạo môi trường test trước khi đưa lên hosting

Docker – Xây dựng môi trường Node.js đồng nhất từ máy phát triển đến máy chủ

Vì sao nên sử dụng Docker?

Trong quá trình phát triển ứng dụng Node.js, nhiều lập trình viên thường gặp tình trạng:

“Ứng dụng chạy được trên máy của mình nhưng khi đưa lên hosting hoặc máy chủ lại phát sinh lỗi.”

Nguyên nhân chủ yếu đến từ sự khác biệt về:

• Phiên bản Node.js
• Hệ điều hành
• Thư viện phụ thuộc
• Biến môi trường
• Công cụ build

Docker giúp đóng gói ứng dụng cùng toàn bộ môi trường chạy vào một container thống nhất. Nhờ đó, ứng dụng có thể hoạt động nhất quán trên máy phát triển, môi trường kiểm thử và máy chủ triển khai.

1. Cài đặt Docker

Windows và macOS

Tải và cài đặt Docker Desktop từ trang chủ Docker.

Ubuntu và Debian

1sudo apt update
2sudo apt install docker.io docker-compose-plugin
3sudo usermod -aG docker "$USER"

Sau khi cài đặt, hãy đăng xuất rồi đăng nhập lại để áp dụng quyền sử dụng Docker.

Kiểm tra phiên bản

1docker --version
2docker compose version

2. Tạo Dockerfile để kiểm tra quá trình build

Trong thư mục gốc của dự án, cùng cấp với tệp package.json, hãy tạo một tệp có tên Dockerfile:

1### Sử dụng Node.js LTS trên nền Alpine Linux
2FROM node:20-alpine
3
4#### Thiết lập thư mục làm việc
5WORKDIR /app
6
7#### Sao chép các tệp package trước để tận dụng bộ nhớ đệm
8COPY package*.json ./
9
10#### Cài đặt thư viện phụ thuộc
11RUN npm install
12
13#### Sao chép toàn bộ mã nguồn
14COPY . .
15
16#### Build dự án
17RUN npm run build
18
19#### Khai báo cổng ứng dụng
20EXPOSE 3000
21
22#### Lệnh chạy mặc định
23CMD ["npm", "start"]

Lưu ý: Nếu dự án sử dụng Yarn hoặc pnpm, hãy thay npm install và các lệnh npm khác bằng lệnh tương ứng của trình quản lý gói đó.

3. Kiểm tra quá trình build bằng Docker

Cách 1: Build image và mở container

Build image

1docker build -t my-app-test .

Mở terminal bên trong container

1docker run -it --rm my-app-test sh

Bên trong container, bạn có thể kiểm tra các tệp hoặc chạy lại quá trình build:

1ls -la
2npm run build

Cách 2: Chỉ chạy quá trình build

Trên Linux hoặc macOS:

1docker run --rm \
2  -v "$(pwd):/app" \
3  -w /app \
4  node:20-alpine \
5  sh -c "npm install && npm run build"

Lệnh trên sẽ:

1. Gắn thư mục dự án vào container.
2. Sử dụng image Node.js chính thức.
3. Cài đặt các thư viện phụ thuộc.
4. Thực hiện quá trình build.

Sau khi hoàn thành, thư mục đầu ra như dist, build hoặc .next sẽ được tạo ngay trong thư mục dự án trên máy tính.

4. Sử dụng Docker Compose

Docker Compose giúp đơn giản hóa việc cấu hình và chạy dự án.

Tạo tệp compose.yaml trong thư mục gốc của dự án:

1services:
2  app:
3    image: node:20-alpine
4    working_dir: /app
5
6    volumes:
7      - .:/app
8      - /app/node_modules
9
10    ports:
11      - "3000:3000"
12
13    command: sh -c "npm install && npm run build && npm start"

Chạy ứng dụng

1docker compose up

Chỉ chạy quá trình build

1docker compose run --rm app sh -c "npm install && npm run build"

5. Multi-stage build dành cho môi trường production

Multi-stage build là phương pháp phổ biến khi triển khai ứng dụng lên máy chủ. Cách này giúp tách biệt môi trường build và môi trường chạy thực tế, từ đó giảm kích thước image cuối cùng.

1#### Giai đoạn 1: Build ứng dụng
2FROM node:20-alpine AS builder
3
4WORKDIR /app
5
6COPY package*.json ./
7RUN npm ci
8
9COPY . .
10RUN npm run build
11
12#### Giai đoạn 2: Chạy ứng dụng trong môi trường production
13FROM node:20-alpine AS production
14
15WORKDIR /app
16
17COPY package*.json ./
18RUN npm ci --omit=dev
19
20COPY --from=builder /app/dist ./dist
21
22EXPOSE 3000
23
24CMD ["npm", "start"]

npm ci yêu cầu dự án có tệp package-lock.json. Nếu chưa có tệp khóa này, hãy sử dụng npm install.

Thư mục đầu ra phụ thuộc vào loại dự án:

Hãy thay đổi đường dẫn trong lệnh COPY --from=builder sao cho phù hợp với cấu trúc của dự án.

Build image production

1docker build -t my-app-prod .

Chạy container production

1docker run --rm -p 3000:3000 my-app-prod

6. Các lệnh Docker thường dùng

7. Một số lưu ý quan trọng

Tạo tệp .dockerignore

Tệp .dockerignore giúp giảm thời gian build và tránh sao chép những dữ liệu không cần thiết vào image:

1node_modules
2.git
3dist
4build
5.next
6.env
7.env.*
8*.log

Không nên đưa các tệp chứa thông tin nhạy cảm như .env vào Docker image.

Truyền biến môi trường

Nếu dự án sử dụng tệp .env, có thể truyền các biến môi trường khi chạy container:

1docker run --rm \
2  -v "$(pwd):/app" \
3  -w /app \
4  --env-file .env \
5  node:20-alpine \
6  sh -c "npm install && npm run build"

Lưu ý khi sử dụng Windows PowerShell

Trong PowerShell, hãy thay:

1$(pwd)

bằng:

1${PWD}

Ví dụ:

1docker run --rm `
2  -v "${PWD}:/app" `
3  -w /app `
4  node:20-alpine `
5  sh -c "npm install && npm run build"

Kết luận

Docker giúp tạo ra môi trường phát triển và triển khai đồng nhất, qua đó giảm thiểu lỗi phát sinh do sự khác biệt giữa máy lập trình và máy chủ.

Việc sử dụng Docker ngay từ giai đoạn phát triển mang lại nhiều lợi ích:

• Kiểm tra quá trình build trong môi trường độc lập.
• Quản lý thư viện phụ thuộc nhất quán.
• Hạn chế lỗi do khác biệt về hệ điều hành hoặc phiên bản Node.js.
• Đơn giản hóa quá trình kiểm thử và triển khai.
• Giúp ứng dụng Node.js vận hành ổn định và chuyên nghiệp hơn.