Hướng Dẫn Cài Đặt GitLab Runner Chi Tiết Trên Linux

Đăng ngày: 07-09-2025 15:50

tự động hóa cấu hình linux Docker cài đặt GitLab Runner CI/CD shell Kubernetes

GitLab Runner là một thành phần quan trọng. Nó được sử dụng trong quy trình CI/CD của GitLab. GitLab Runner giúp tự động hóa việc xây dựng, kiểm tra và triển khai ứng dụng.

Bài viết này sẽ hướng dẫn bạn cách cài đặt và cấu hình GitLab Runner trên máy chủ Linux. Chúng ta sẽ đi qua từng bước một cách chi tiết. Bạn sẽ có thể tự động hóa quy trình CI/CD của mình một cách hiệu quả.

Điều Kiện Tiên Quyết

Trước khi bắt đầu, bạn cần đảm bảo rằng bạn đã có:

Một máy chủ Linux đã được cài đặt.
Quyền truy cập sudo hoặc quyền root.
Một tài khoản GitLab.
Một dự án GitLab để cấu hình CI/CD.

Bước 1: Cài Đặt GitLab Runner

Đầu tiên, chúng ta cần tải xuống và cài đặt gói GitLab Runner. Các bước cài đặt có thể khác nhau tùy thuộc vào bản phân phối Linux bạn đang sử dụng. Dưới đây là hướng dẫn cho một số bản phân phối phổ biến.

Ubuntu/Debian

Cập nhật danh sách gói:

sudo apt update

Cài đặt các phụ thuộc cần thiết:

sudo apt install apt-transport-https ca-certificates curl gnupg

Thêm khóa GPG chính thức của GitLab:

curl -fsSL https://packages.gitlab.com/gitlab/runner/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/gitlab-runner-archive-keyring.gpg

Thêm kho lưu trữ GitLab Runner:

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/gitlab-runner-archive-keyring.gpg] https://packages.gitlab.com/gitlab/runner debian main" | sudo tee /etc/apt/sources.list.d/gitlab-runner.list > /dev/null

Cài đặt GitLab Runner:

sudo apt updatesudo apt install gitlab-runner

CentOS/RHEL

Thêm kho lưu trữ GitLab Runner:

curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh" | sudo bash

Cài đặt GitLab Runner:

sudo yum install gitlab-runner

Bước 2: Đăng Ký GitLab Runner

Sau khi cài đặt GitLab Runner, bạn cần đăng ký nó với GitLab. Điều này cho phép GitLab biết về Runner của bạn và sử dụng nó để chạy các công việc CI/CD. Để đăng ký Runner, hãy chạy lệnh sau:

sudo gitlab-runner register

Lệnh này sẽ yêu cầu bạn nhập một số thông tin:

GitLab instance URL: Địa chỉ URL của GitLab instance của bạn (ví dụ: https://gitlab.com).
Registration token: Mã thông báo đăng ký cho dự án hoặc nhóm của bạn. Bạn có thể tìm thấy mã thông báo này trong cài đặt CI/CD của dự án hoặc nhóm.
Description: Mô tả cho Runner của bạn. Điều này giúp bạn dễ dàng phân biệt các Runner khác nhau.
Tags: Các thẻ để xác định loại công việc mà Runner có thể xử lý.
Executor: Loại executor mà Runner sẽ sử dụng. Các executor phổ biến bao gồm shell, docker và kubernetes.

Ví dụ:

sudo gitlab-runner register --url https://gitlab.com --registration-token YOUR_REGISTRATION_TOKEN --description "My Runner" --tag-list "docker,linux" --executor docker --docker-image "ubuntu:latest"

Thay thế `YOUR_REGISTRATION_TOKEN` bằng mã thông báo đăng ký thực tế của bạn.

Bước 3: Cấu Hình GitLab Runner

Sau khi đăng ký, bạn có thể cấu hình GitLab Runner bằng cách chỉnh sửa tệp `config.toml`. Tệp này thường nằm trong thư mục `/etc/gitlab-runner/`. Bạn có thể chỉnh sửa tệp này để thay đổi các cài đặt như:

concurrent: Số lượng công việc tối đa mà Runner có thể chạy đồng thời.
check_interval: Khoảng thời gian (giây) mà Runner kiểm tra GitLab để tìm công việc mới.
runners.executor: Loại executor mà Runner sẽ sử dụng.
runners.docker.image: Hình ảnh Docker mặc định mà Runner sẽ sử dụng cho các công việc Docker.

Ví dụ về một tệp `config.toml`:

concurrent = 1check_interval = 30[session_server]  listen_address = "[::]:8093"  advertise_address = "127.0.0.1:8093"  session_timeout = 1800[[runners]]  name = "My Runner"  url = "https://gitlab.com"  token = "YOUR_RUNNER_TOKEN"  executor = "docker"  [runners.docker]    tls_verify = false    image = "ubuntu:latest"    privileged = false    disable_cache = false    volumes = ["/cache"]    shm_size = 0  [runners.cache]    [runners.cache.s3]    [runners.cache.gcs]

Thay thế `YOUR_RUNNER_TOKEN` bằng mã thông báo Runner thực tế của bạn.

Bước 4: Khởi Động Lại GitLab Runner

Sau khi bạn đã chỉnh sửa tệp `config.toml`, bạn cần khởi động lại GitLab Runner để các thay đổi có hiệu lực. Để khởi động lại Runner, hãy chạy lệnh sau:

sudo gitlab-runner restart

Bước 5: Kiểm Tra GitLab Runner

Để kiểm tra xem GitLab Runner đã được cài đặt và cấu hình đúng cách hay chưa, bạn có thể tạo một tệp `.gitlab-ci.yml` đơn giản trong dự án GitLab của mình. Tệp này sẽ định nghĩa một công việc đơn giản mà Runner sẽ chạy.

Ví dụ về một tệp `.gitlab-ci.yml`:

stages:  - testtest:  stage: test  script:    - echo "Hello, world!"

Khi bạn đẩy tệp này lên GitLab, Runner sẽ tự động chọn công việc và chạy nó. Bạn có thể xem kết quả của công việc trong giao diện GitLab CI/CD.

Các Loại Executor Phổ Biến

GitLab Runner hỗ trợ nhiều loại executor khác nhau. Mỗi loại executor có ưu và nhược điểm riêng. Dưới đây là một số loại executor phổ biến:

Shell: Executor này chạy các công việc trực tiếp trên máy chủ mà Runner đang chạy. Nó đơn giản để cấu hình, nhưng có thể gây ra các vấn đề về bảo mật và khả năng mở rộng.
Docker: Executor này chạy các công việc trong các container Docker. Nó cung cấp một môi trường cách ly và dễ dàng tái tạo.
Kubernetes: Executor này chạy các công việc trong một cụm Kubernetes. Nó cung cấp khả năng mở rộng và quản lý tài nguyên tốt.

Lời Khuyên và Mẹo

Dưới đây là một số lời khuyên và mẹo để giúp bạn sử dụng GitLab Runner một cách hiệu quả:

Sử dụng tags để xác định loại công việc mà Runner có thể xử lý.
Sử dụng Docker executor để cung cấp một môi trường cách ly và dễ dàng tái tạo.
Sử dụng cache để tăng tốc thời gian xây dựng.
Giám sát hiệu suất của Runner để đảm bảo rằng nó hoạt động tốt.

Kết luận

Bài viết này đã cung cấp hướng dẫn chi tiết về cách cài đặt và cấu hình GitLab Runner trên máy chủ Linux. Hy vọng rằng bạn đã có thể tự động hóa quy trình CI/CD của mình một cách hiệu quả. Hãy bắt đầu khám phá và tận dụng sức mạnh của GitLab Runner ngay hôm nay để tối ưu hóa quy trình phát triển phần mềm của bạn.