Chạy Ở Máy Em Rất Ngon Nhưng Lên Server Thì Tạch" - Khai Sáng Cùng Docker

Docker là một hệ tư tưởng đã thay đổi hoàn toàn cục diện của ngành công nghệ phần mềm trong một thập kỷ qua.

Hãy pha một ly cà phê thật đặc, ngồi ngay ngắn lại, vì chúng ta chuẩn bị bước vào kỷ nguyên của Containerization!

PHẦN 1: NỖI ĐAU MANG TÊN "MÔI TRƯỜNG LẬP TRÌNH"

Bạn vừa hoàn thành một con API Node.js cực xịn. Trên chiếc Macbook M2 của bạn, mọi thứ chạy mượt như lụa. Bạn nén toàn bộ source code thành file .zip, gửi cho sếp hoặc tự tay copy lên con server Ubuntu mới toanh để deploy.

Và thảm họa bắt đầu:

1. Gõ npm start -> Lỗi: "Node.js version mismatch". Máy bạn xài Node 20, server đang cài Node 14.

2. Cập nhật Node xong, chạy lại -> Lỗi: "Cannot connect to Redis". Bạn quên mất là máy bạn có cài Redis, còn server thì chưa.

3. Cài Redis xong, chạy lại -> Lỗi: "Missing C++ Build Tools for bcrypt". Thư viện mã hóa mật khẩu không chịu chạy trên Linux vì thiếu trình biên dịch.

Bạn mất nguyên một ngày cuối tuần chỉ để lên Google gõ từng dòng lệnh cài đặt thư viện, cấu hình biến môi trường, mở port... để con Server có cấu hình giống hệt cái máy tính ở nhà của bạn.

Câu nói kinh điển: "Kỳ lạ thật, chạy ở máy em rất ngon mà!" vang lên trong vô vọng.

Giải pháp thô sơ ngày xưa là dùng Máy Ảo (Virtual Machine - VM). Bạn cài nguyên một hệ điều hành Windows/Linux vào trong một cái máy ảo (như VMWare, VirtualBox), cài code vào đó, rồi vác nguyên cái máy ảo nặng 20GB đó ném lên server. Nó chạy được, nhưng quá nặng nề, khởi động mất 5 phút và ngốn sạch RAM của hệ thống.

Đó là lúc Docker giáng trần.

PHẦN 2: LÝ THUYẾT NỀN TẢNG - DOCKER LÀ GÌ?

Thay vì đóng gói cả một Hệ điều hành nặng nề như Máy ảo (VM), Docker ra đời với triết lý Containerization (Đóng gói vào container).

Hãy tưởng tượng ngành vận tải biển trước khi có Container. Người ta vác từng bao gạo, từng thùng tivi, từng chiếc xe đạp xếp lên tàu. Mỗi loại hàng đòi hỏi một cách xếp khác nhau, rất dễ vỡ và cực kỳ chậm chạp. Khi Container bằng sắt ra đời, mọi thứ thay đổi: Bất kể bên trong bạn chứa gạo hay tivi, bạn cứ nhét nó vào cái thùng sắt tiêu chuẩn. Cần cẩu chỉ việc gắp cái thùng đó bỏ lên tàu, xe tải, hay xe lửa. Mọi nơi đều hỗ trợ kích thước của cái thùng đó.

Docker chính là những chiếc Container của thế giới phần mềm. Nó đóng gói Code của bạn, cùng với đúng phiên bản Node.js đó, đúng thư viện hệ thống đó... vào trong một "chiếc hộp". Bạn mang chiếc hộp đó vứt lên máy Windows, máy Mac, hay Server Linux, nó đều chạy Y CHANG NHAU. Không trật một nhịp!

2.1. Ma thuật kiến trúc: Docker khác gì Máy Ảo (VM)?

Để một Vibe Coder hiểu tận gốc, bạn phải nhìn thấy sự khác biệt về kiến trúc. Mời bạn xem mô hình trực quan dưới đây:

Nhìn vào mô hình trên, bạn thấy ngay: Docker không cõng thêm bất kỳ một hệ điều hành khách (Guest OS) nào cả. Nó dùng chung nhân (Kernel) với hệ điều hành gốc của máy chủ. Do đó, khởi động một Docker Container chỉ mất... 0.1 giây, và nó chỉ tốn vài chục Megabyte RAM!

2.2. Ba Trụ Cột Của Docker

Để xài Docker, bạn chỉ cần thuộc lòng 3 khái niệm này (hãy liên tưởng đến Lập trình hướng đối tượng - OOP):

1. Dockerfile (Kịch bản): Nó giống như bản vẽ thiết kế, hay tờ công thức nấu ăn. File này chứa các dòng lệnh hướng dẫn cách để tạo ra ứng dụng của bạn.
2. Image (Khuôn đúc / Class): Khi bạn lấy Dockerfile chạy lệnh build, nó đúc ra một cái Image. Nó giống như một file .iso cài win, chứa mọi thứ dạng chỉ-đọc (read-only). Image là thứ bạn sẽ gửi cho đồng nghiệp hoặc push lên mạng.
3. Container (Thực thể / Object): Khi bạn lấy cái Image đó đem ra chạy (run), nó biến thành một Container. Một Image có thể đẻ ra hàng trăm Container chạy song song (ví dụ: chạy 3 container API để cân bằng tải).

PHẦN 3: THỰC HÀNH TỪ A-Z - ĐÓNG GÓI APP NODE.JS

Học đi đôi với hành. Chúng ta sẽ lấy cái server chuẩn Vibe Coder mà chúng ta viết ở bài trước để đóng gói thành Docker nhé.

Giả sử thư mục dự án của bạn có các file sau:

my-vibe-app/
├── package.json
├── package-lock.json
├── server.js
└── app.js

Bước 1: Khai sinh Dockerfile

Tạo một file không có đuôi (không phải .txt nhé), tên chính xác là Dockerfile nằm ngay thư mục gốc.

Hãy viết theo mình, mình sẽ giải thích kỹ từng dòng. Đây là tư duy viết Dockerfile cấp độ Senior:

# 1. CHỌN HỆ ĐIỀU HÀNH NỀN
# Không dùng "node:18" thông thường vì nó nặng 1GB. 
# Vibe Coder dùng bản "alpine" (một bản Linux siêu nhẹ), size chỉ còn ~100MB.
FROM node:18-alpine 

# 2. CHỌN THƯ MỤC LÀM VIỆC BÊN TRONG CONTAINER
WORKDIR /usr/src/app

# 3. KỸ THUẬT CACHE LAYER CỦA VIBE CODER
# Chỉ copy 2 file package.json vào trước
COPY package*.json ./

# 4. CÀI ĐẶT THƯ VIỆN
# Chỉ chạy lệnh này nếu file package.json có sự thay đổi. 
# Cờ --omit=dev giúp bỏ qua các thư viện test (jest, nodemon) cho nhẹ file.
RUN npm ci --omit=dev

# 5. COPY TOÀN BỘ SOURCE CODE VÀO TRONG CONTAINER
# Copy từ thư mục hiện tại của máy tính (dấu chấm 1) vào thư mục làm việc của Container (dấu chấm 2)
COPY . .

# 6. KHAI BÁO PORT
# Báo cho Docker biết App này sẽ chạy ở port 3000 bên trong nó
EXPOSE 3000

# 7. KHỞI ĐỘNG APP
# Lệnh CMD này CHỈ CHẠY khi Container bắt đầu khởi động.
CMD ["node", "server.js"]

Bí kíp Layer Caching (Tại sao không copy code vào rồi cài NPM một thể?): Docker build image theo từng lớp (Layer). Nếu bạn thay đổi file server.js, Docker phát hiện lớp số 5 (COPY . .) bị đổi, nó sẽ build lại từ bước 5 trở đi. Nhờ việc ta tách bước 3 và 4 ra trước, nên nếu bạn CHỈ đổi code logic mà KHÔNG cài thêm thư viện mới, Docker sẽ lấy bộ nhớ đệm (Cache) của bước npm ci ra xài luôn, không cần tải lại thư viện. Thời gian build giảm từ 2 phút xuống còn... 1 giây!

Bước 2: Bỏ đi những thứ không cần thiết (.dockerignore)

Tạo một file tên là .dockerignore (giống y hệt .gitignore). Khi lệnh COPY . . ở bước 5 chạy, nó sẽ copy càn quét mọi thứ, bao gồm cả thư mục node_modules khổng lồ ở máy tính của bạn vào trong Container. Điều này làm Image bị phình to và có thể gây lỗi.

Nội dung file .dockerignore:

node_modules
npm-debug.log
.env
.git

Tuyệt đối không nhét .env vào trong Docker Image! (Nhớ bài quản lý bí mật AWS hôm trước chứ?).

Bước 3: Đúc Image (Build)

Mở Terminal, đứng ở thư mục dự án và gõ lệnh:

docker build -t vibe-coder-api:v1 .

Ý nghĩa: Ê Docker, hãy đúc cho tao một cái Image, đặt tên (-t = tag) là vibe-coder-api, phiên bản v1. Dùng cái Dockerfile ở thư mục hiện tại (.)).

Chờ nó chạy xong. Giờ bạn gõ docker images, bạn sẽ thấy "đứa con" của mình nằm sừng sững ở đó, sẵn sàng để deploy.

Bước 4: Chạy Container (Run)

Thành quả đây rồi! Hãy đánh thức cái Image đó thành một Container đang chạy bằng lệnh:

docker run -d -p 8080:3000 --name my-running-api vibe-coder-api:v1

(Ý nghĩa: Chạy cái image kia đi. Chạy ngầm dưới background (-d). Map cái cổng mạng (-p) số 8080 của cái Macbook của tao vào cái cổng 3000 bên trong thằng Container. Đặt tên gọi ở nhà cho nó là my-running-api).

Xong! Giờ bạn mở trình duyệt gõ http://localhost:8080, API của bạn đang hoạt động mượt mà. Bạn có thể mang cái Image kia quăng lên Server Ubuntu, gõ đúng lệnh run đó, nó sẽ chạy lên 8080 y chang máy bạn, bất chấp server đó có cài Node.js hay chưa!

PHẦN 4: NÂNG CẤP ĐẲNG CẤP - DOCKER COMPOSE

Sự thật phũ phàng: Một dự án thực tế hiếm khi chỉ có 1 cục code Node.js. Nó còn cần Database (MySQL) và Cache (Redis). Bạn không thể đi gõ 3 dòng lệnh docker run rườm rà và tự tay kết nối mạng lưới cho 3 cái container đó lại với nhau. Quá mệt mỏi!

Docker Compose sinh ra để bạn làm Nhạc trưởng, điều khiển cả dàn nhạc giao hưởng chỉ bằng 1 file cấu hình duy nhất.

Tạo file docker-compose.yml ở thư mục gốc:

version: '3.8'

services:
  # Cục 1: API của chúng ta
  backend_api:
    build: . # Bảo nó tự tìm Dockerfile ở thư mục hiện tại để build
    ports:
      - "8080:3000"
    environment:
      - REDIS_URL=redis://cache_db:6379 # Trỏ tên host sang cục Redis bên dưới
    depends_on:
      - cache_db # Chờ Redis khởi động xong mới được chạy API

  # Cục 2: Redis
  cache_db:
    image: redis:alpine # Không cần Dockerfile, mượn ảnh Redis gốc trên mạng về xài
    ports:
      - "6379:6379"

Bây giờ, thay vì gõ cả mớ lệnh, bạn chỉ cần gõ đúng 1 dòng này (dù là ở máy bạn hay trên Server):

docker-compose up -d

Docker sẽ tự động tải Redis, tự build API của bạn, tự động tạo ra một mạng LAN ảo kết nối 2 thằng này với nhau. Khi bạn muốn gỡ toàn bộ hệ thống xuống để nghỉ ngơi? Gõ:

docker-compose down

Sạch sẽ không tì vết, không rác hệ điều hành.

LỜI KẾT

Docker là ranh giới phân định rõ ràng giữa một Coder chỉ biết gõ logic và một Software Engineer có khả năng thiết kế và vận hành hệ thống. Bằng việc làm chủ Docker, bạn đã nắm trong tay chìa khóa để triển khai mọi loại ngôn ngữ (PHP, Python, Golang) lên bất kỳ môi trường đám mây nào (AWS, Google Cloud, DigitalOcean) mà không còn nỗi sợ hãi mang tên "Lỗi môi trường" nữa.

Đến đây, bạn đã biết đóng gói App thành Docker và chạy nó bằng Docker Compose. Nhưng nếu bạn có 5 con Server (Mỗi con 16GB RAM) thì sao? Chẳng lẽ bạn phải SSH vào từng con server rồi gõ docker-compose up 5 lần? Lỡ con số 3 bị sập phần cứng, làm sao các Container bên trong nó tự động "chạy giặc" sang con số 4 để hệ thống không bị gián đoạn?

Đây chính là lúc chúng ta cần đến một "Người Nhạc Trưởng Tối Cao" (Orchestration). Bạn có muốn bài tiếp theo chúng ta sẽ tiến thẳng vào vương quốc của Kubernetes (K8s) - Kẻ thống trị mọi cụm Server hiện đại không?