Phần 5: Tạo Docker Image với Gitlab runner – Kaniko

6 phút đọc

Giới thiệu #

Việc tạo Docker image có lẽ đã không còn quá xa lạ đối với mọi người trong thời buổi hiện nay. Với Docker image, người dùng có thể triển khai phần mềm của mình ở bất cứ nơi đâu, miễn là nơi đó đã được cài đặt Docker. Người dùng có thể sử dụng Gitlab-CI để tự động hóa quá trình tạo và lưu trữ Docker image của mình một cách dễ dàng.

kaniko

Kaniko là một trong những công cụ hỗ trợ tạo container image từ Dockerfile, thông qua một container hoặc Kubernetes cluster. Công cụ này giải quyết được 2 vấn đề gặp phải khi sử dụng “Docker-in-Docker” khi tạo container image:

Bảo mật: không yêu cầu chế độ đặc quyền (privileged mode)
Hiệu suất: thời gian xử lý và hiệu suất tốt hơn so với Docker-in-Docker

Yêu cầu #

Để có thể sử dụng kaniko với Gitlab, runner cần được cấu hình sử dụng một trong các executor sau:

Kubernetes
Dockerr
Docker machine

Lưu ý #

Khi tạo image với kaniko và Gitlab CI/CD, người dùng cần lưu ý một số vấn đề sau:

Nên sử dụng kaniko debug image (gcr.io/kaniko-project/executor:debug) vì image này hỗ trợ “shell”, thành phần bắt buộc để tạo image với Gitlab CI/CD.
“entrypoint” cần được ghi đè thì script build mới có thể hoạt động bình thường.
Để “push image” lên container registry, người dùng sẽ cần phải tạo một tập tin “config.json” chứa thông tin dùng để xác thực quyền truy cập registry của runner.

Các bước thực hiện #

Cài đặt Docker trên server
Cài đặt Gitlab runner (Ubuntu, Centos, Windows, macOS)

Đăng ký runner với executor là “docker”. Ví dụ:

sudo gitlab-runner register -n \
--url <Gitlab Domain> \
--registration-token <Token> \
--executor docker \
--docker-image "gcr.io/kaniko-project/executor:debug" \
--description "Tel4vn Docker executor - Kaniko"

Thêm “gitlab-runner” vào group được sử dụng Docker:
```
sudo usermod -aG docker gitlab-runner
```
Kiểm tra “gitlab-runner” đã có thể sử dụng Docker hay chưa bằng câu lệnh sau:
```
sudo -u gitlab-runner -H docker info
```

Khởi tạo job tạo Docker image với kaniko trong file “.gitlab-ci.yml“:

build_image:
  stage: build   // Khai báo job này thuộc stage "build" (có thể xóa nếu muốn)
  image:
    name: gcr.io/kaniko-project/executor:debug
    entrypoint: [""]
  before_script: // Câu lệnh dùng để đăng nhập vào Container Registry trên Gitlab
    - mkdir -p /kaniko/.docker
    - echo "{\"auths\":{\"${CI_REGISTRY}\":{\"auth\":\"$(printf "%s:%s" "${CI_REGISTRY_USER}" "${CI_REGISTRY_PASSWORD}" | base64 | tr -d '\n')\"}}}" > /kaniko/.docker/config.json
  script: // Tạo và lưu Docker image trên Container Registry
    -  >- 
       /kaniko/executor --context "${CI_PROJECT_DIR}" 
       --dockerfile "${CI_PROJECT_DIR}/Dockerfile"
       --destination "${CI_REGISTRY_IMAGE}:${CI_COMMIT_SHA}"

Trong đó:

CI_COMMIT_SHA: mã băm SHA-1 của commit kích hoạt CI/CD job dùng để tạo tag cho image. Bạn có thể thay thế nếu muốn
CI_PROJECT_DIR: đường dẫn đầy đủ của repository sau khi runner đã clone về.
CI_REGISTRY: Domain của Container Registry trên Gitlab
CI_REGISTRY_IMAGE: Domain của Container Registry của repository/project trên Gitlab
CI_REGISTRY_PASSWORD: mật khật dùng để đăng nhập vào Container Registry của Runner. Giá trị này tương đương với CI_JOB_TOKEN, và có thể sử dụng khi “job” vẫn còn đang xử lý. Nếu như job đã dừng vì bất kỳ lý do nào thì “mật khẩu” này sẽ không còn sử dụng được nữa
CI_REGISTRY_USER: user mặc định của gitlab-runner sử dụng để đăng nhập vào Gitlab Registry

Các giá trị này được lấy từ biến môi trường của Gitlab runner, người dùng có thể thay đổi các thông tin nếu không muốn sử dụng Container registry của Gitlab.

Trong trường hợp bạn cần xác thực với “Dependency Proxy”, người dùng cần thêm một số biến CI/CD vào trong tập tin “config.json” thông qua câu lệnh sau (trong phần “before_script” của job bên trên):

- echo "{\"auths\":{\"$CI_REGISTRY\":{\"auth\":\"$(printf "%s:%s" "${CI_REGISTRY_USER}" "${CI_REGISTRY_PASSWORD}" | base64 | tr -d '\n')\"},\"$CI_DEPENDENCY_PROXY_SERVER\":{\"auth\":\"$(printf "%s:%s" ${CI_DEPENDENCY_PROXY_USER} "${CI_DEPENDENCY_PROXY_PASSWORD}" | base64 | tr -d '\n')\"}}}" > /kaniko/.docker/config.json

Trong đó:

CI_DEPENDENCY_PROXY_SERVER: Server dùgn để đăng nhập Dependency Proxy (tương đương với: $CI_SERVER_HOST:$CI_SERVER_PORT)
CI_DEPENDENCY_PROXY_USER: Username dùng để pull image thông qua Dependency proxy.
CI_DEPENDENCY_PROXY_PASSWORD: Password dùng để pull image thông qua Dependency proxy.

Tạo Docker image với kaniko thông qua Proxy #

Trong trường hợp Gitlab runner của bạn hoạt động phía sau một HTTP(s) Proxy, kaniko sẽ cần được cấu hình thêm thông tin proxy này để có thể push image lên Container registry thành công nhé. Job tạo Docker image sẽ có nội dung như sau:

build_image:  
  stage: build // Khai báo job này thuộc stage "build" (có thể xóa nếu muốn)
  image:
    name: gcr.io/kaniko-project/executor:debug
    entrypoint: [""]
  before_script: // Câu lệnh dùng để đăng nhập vào Container Registry trên Gitlab 
    - mkdir -p /kaniko/.docker
    - |- 
       KANIKOPROXYBUILDARGS="" 
       KANIKOCFG="\"auths\":{\"${CI_REGISTRY}\":{\"auth\":\"$(printf "%s:%s" "${CI_REGISTRY_USER}" "${CI_REGISTRY_PASSWORD}" | base64 | tr -d '\n')\"}}" 
       if [ "x${http_server}" != "x" -o "x${https_server}" != "x" ]; then 
         KANIKOCFG="${KANIKOCFG}, \"proxies\": { \"default\": { \"httpProxy\": \"${http_server}\", \"httpsProxy\": \"${https_server}\", \"noProxy\": \"${no_proxy}\"}}" 
         KANIKOPROXYBUILDARGS="--build-arg http_proxy=${http_server} --build-arg https_proxy=${http_server} --build-arg no_proxy=${no_proxy}" 
       fi 
       KANIKOCFG="{ ${KANIKOCFG} }" 
       echo "${KANIKOCFG}" > /kaniko/.docker/config.json
  script: // Tạo và lưu Docker image trên Container Registry
    - >-
      /kaniko/executor 
      --context "${CI_PROJECT_DIR}" 
      --dockerfile "${CI_PROJECT_DIR}/Dockerfile" 
      "${KANIKOPROXYBUILDARGS}"
      --destination "${CI_REGISTRY_IMAGE}:${CI_COMMIT_SHA}"

Trong đó:

http_server / https_server: thông tin Proxy server
no_proxy: danh sách các domain không “đi qua” proxy

Xem thêm #

Nguồn tham khảo: Gitlab

Trung tâm đào tạo Viễn thông và Công nghệ thông tin TEL4VN (TEL4VN) chuyên đào tạo các khóa học về DevOps như: Docker, Kubernetes, Ansible, Jenkins, Linux…….Ngoài ra, TEL4VN còn là Trung tâm đào tạo duy nhất về VoIP mã nguồn mở.

🌐Website: https://tel4vn.edu.vn/
🔗 Fanpage: https://www.facebook.com/tel4vn
🔗 Youtube: TEL4VN

🏠Địa chỉ: 82/2/9 Đinh Bộ Lĩnh, P.26, Q.Bình Thạnh, TP.HCM
☎️SĐT: 028 3622 0868
📩 Email: tuyensinh@tel4vn.com

Cập nhật vào 27/08/2022

Git, Gitlab, Gitlab Runner

Cảm xúc của bạn là gì

Happy
Bình thường
Sad

Được cung cấp bởi BetterDocs