1. Cơn ác mộng máy chủ CI/CD: Khi môi trường build biến thành “bãi rác”
Hình dung một căn bếp có 10 đầu bếp cùng nấu nướng nhưng dùng chung một chiếc thớt. Vừa thái cá sống xong, người kế tiếp lập tức cắt hoa quả mà không rửa lại. Kết quả ra sao chắc bạn cũng đoán được. Việc nhiều dev đẩy code lên một server chung để build và test cũng hỗn loạn y hệt như vậy.
Ngày trước, các team hay dựng sẵn một con VPS rồi cài Shell Runner để chạy thẳng lệnh build. Vấn đề bắt đầu từ đây: repo A đòi Node 16, repo B ép dùng Node 20, còn repo C lại cần Python 3.9. Chỉ sau vài tuần, máy chủ đầy nghẹt các phiên bản runtime chéo ngoe. Pipeline vừa báo đỏ, anh em đã phải nháo nhào SSH vào máy chủ để xóa rác ổ cứng hoặc gỡ thư viện xung đột. Muốn dứt điểm cảnh này, bạn cần một môi trường dùng xong là xóa sạch: Docker Executor.
2. GitLab Runner và Docker Executor vận hành thế nào?
Mô hình này gồm các thành phần phối hợp rất nhịp nhàng:
- GitLab Server: Nhận code khi bạn push, đọc file
.gitlab-ci.ymlvà lên lịch giao việc cho Runner. - GitLab Runner: Ứng dụng nền (daemon) túc trực để nhận lệnh rồi điều phối quá trình chạy job.
- Docker Executor: Cơ chế chạy job trong container cô lập. Thay vì cài cắm trực tiếp lên OS chủ, Runner dựng một container mới tinh theo đúng image bạn chọn. Mọi thao tác tải package, compile hay chạy test đều gói gọn bên trong. Job chạy xong, container bị xóa sạch ngay lập tức. Máy chủ chính hoàn toàn sạch sẽ.
- Bộ nhớ Cache: Điểm trừ của container sạch là bên trong trống rỗng. Lần nào chạy cũng kéo hàng gigabyte thư viện thì pipeline chậm phát bực. Cache giải quyết đúng bài toán này. Nó lưu sẵn các thư mục nặng như
node_modules/hayvendor/ở ổ đĩa ngoài rồi gắn ngược vào container khi cần.
3. Từng bước cài đặt và cấu hình tối ưu
Bước 1: Chạy GitLab Runner bằng Docker Compose
Cú pháp Docker Compose v2 (docker compose) hiện nay quản lý container rất gọn gàng. Bạn chuẩn bị sẵn một thư mục trên VPS:
mkdir -p /opt/gitlab-runner && cd /opt/gitlab-runner
nano docker-compose.yml
Dán cấu hình sau vào file:
services:
gitlab-runner:
image: gitlab/gitlab-runner:latest
container_name: gitlab-runner
restart: always
volumes:
- /opt/gitlab-runner/config:/etc/gitlab-runner
- /var/run/docker.sock:/var/run/docker.sock
Khởi chạy container ở chế độ chạy nền:
docker compose up -d
Bước 2: Đăng ký Runner với GitLab instance
Truy cập vào Settings > CI/CD > Runners trên GitLab để lấy Runner Authentication Token (tiền tố thường là glrt-). Tiếp theo, chạy lệnh đăng ký:
docker compose exec gitlab-runner gitlab-runner register \n --non-interactive \n --url "https://gitlab.com/" \n --token "glrt-your-runner-token" \n --executor "docker" \n --docker-image "alpine:latest" \n --description "Production Docker Runner"
Bước 3: Tối ưu config.toml để kéo cache và image siêu tốc
Mở file cấu hình vừa sinh ra tại /opt/gitlab-runner/config/config.toml:
nano /opt/gitlab-runner/config/config.toml
Chỉnh sửa các tham số then chốt để mở rộng tài nguyên và bật cơ chế cache cục bộ:
concurrent = 4
check_interval = 0
[session_server]
session_timeout = 1800
[[runners]]
name = "Production Docker Runner"
url = "https://gitlab.com/"
id = 1
token = "glrt-your-runner-token"
executor = "docker"
[runners.custom_build_dir]
[runners.docker]
tls_verify = false
image = "alpine:latest"
privileged = false
disable_entrypoint_overwrite = false
oom_kill_disable = false
disable_cache = false
volumes = ["/cache", "/var/run/docker.sock:/var/run/docker.sock:ro"]
shm_size = 0
pull_policy = ["if-not-present"]
Tham số pull_policy = ["if-not-present"] cực kỳ đáng giá. Runner sẽ ưu tiên dùng image đã có sẵn trên máy thay vì tốn thời gian kéo lại qua mạng ở mỗi job.
Bước 4: Thiết lập .gitlab-ci.yml tận dụng cache thông minh
Tạo file .gitlab-ci.yml ở thư mục gốc của dự án:
stages:
- test
- build
default:
image: node:20-alpine
variables:
npm_config_cache: "$CI_PROJECT_DIR/.npm"
cache:
key:
files:
- package-lock.json
paths:
- .npm/
- node_modules/
policy: pull-push
unit_test:
stage: test
script:
- npm ci --cache .npm --prefer-offline
- npm run test
build_artifact:
stage: build
script:
- npm run build
artifacts:
paths:
- dist/
expire_in: 1 week
cache:
key:
files:
- package-lock.json
paths:
- .npm/
- node_modules/
policy: pull
Mẹo nhỏ ở stage build_artifact là dùng policy: pull. Runner chỉ tải cache về dùng mà không tốn công nén rồi upload ngược lại. Nhờ đó, tổng thời gian pipeline thường giảm từ 4-5 phút xuống chỉ còn khoảng 25-35 giây.
4. Đạt được gì sau khi chuẩn hóa?
Môi trường build sạch đồng nghĩa với việc loại bỏ tận gốc lỗi “máy dev chạy được nhưng CI thì tèo”. Đĩa cứng không còn bị đầy bất thình lình vì file log rác. Kết hợp Docker Executor cùng cache cục bộ vừa bảo vệ máy chủ, vừa giúp pipeline phản hồi nhanh chóng cho từng commit code.
