Việc cài đặt gitlab-runner sử dụng docker được hướng dẫn khá đầy đủ tại tài liệu chính thống. Nhưng thực tế quá trình cài đặt và sử dụng thường không diễn ra suôn sẻ với mình lắm nên mình chắc nhiều bạn cũng gặp vấn đề giống mình. Bài viết này chủ yếu chỉ ra những điều cần chú ý khi bạn cài đặt và sau khi cài thành công mà pipeline có thể vẫn báo tình trạng stuck (job không thể kích hoạt bởi gitlab-runner).

Triển khai gitlab-runner

Để cài đặt gitlab-runner bạn chỉ cần 2 câu lệnh sau là đủ:

1: Cài đặt gitlab-runner

 sudo docker run -d --name gitlab-runner --restart always \
   -v /srv/gitlab-runner/config:/etc/gitlab-runner \
   -v /var/run/docker.sock:/var/run/docker.sock \
   gitlab/gitlab-runner:latest

2: Cấu hình gitlab-runner

 sudo docker run --rm -t -i \
   -v /srv/gitlab-runner/config:/etc/gitlab-runner \
   gitlab/gitlab-runner register

Để điền thông tin cấu hình bạn chỉ cần theo sát hướng dẫn tại đây. Vậy là xong rồi!

Chú ý

  • Cài đặt xong rồi nhưng pipeline của tôi vẫn không được kích hoạt? – Rất có thể bạn cần cấu hình thêm một chút để Runners có thể kích hoạt các jobs không được tags, việc này có thể làm ngay trên giao diện web gitlab. (Link tham khảo)
  • Tôi cần build docker image trên CI nhưng khi chạy thì báo không tìm thấy docker? – Chắc là quên bật --privileged (link tham khảo).
  • Nếu bạn muốn sử dụng gitlab-runner cho docker swarm thì có thể tham khải tại đây.