Kể từ bài viết cuối cùng về Feature Flags thì đã lâu lắm rồi mình chưa viết bài nào. Nay tranh thủ có chút thời gian thì mình sẽ viết bài chia sẻ về quá trình cấu hình và sử dụng CI/CD cho project Go của mình. Let’s start.
Vậy CI/CD là
I. CI/CD là gì
CI là quá trình tích hợp liên tục khi phát triển/bảo trì phần mềm. Các thành viên trong team sẽ tích hợp liên tục công việc của họ với nhau. Và mỗi khi tích hợp thì project sẽ được build và test tự động nhằm phát hiện lỗi sớm nhất có thể. Và nó cho phép phát triển phần mềm nhanh và chất lượng hơn.
CD hay Continue Delivery là quá trình chuyển giao liên tục. Mỗi khi quá trình tích hợp được build và test thành công thì hệ thống sẽ phân phối bản build tới kho chứa. Từ đó giảm thời gian mà các thành viên phải deploy source code lên các môi trường. Và sẵn sàng deploy bản build đó bất cứ lúc nào.
Vậy tóm gọn CI/CD là mô hình hiện đại được áp dụng nhiều tại các công ty lớn nhằm giảm thời gian phát triển phần mềm và nâng cao chất lượng.
II. CI/CD hoạt động như thế nào
Ở đây mình sẽ giải thích flow hoạt động của Github action. Các nền tảng CI/CD khác cũng tương tự hoặc khác 1 chút.
Khi developer push code lên trên github thì trigger thay đổi đó sang Github Actions. Nó sẽ kiểm tra cấu hình trong repo này và chạy các pipeline tương ứng như chúng ta đã cấu hình. Chút nữa thì chúng ta sẽ thực hiện test, build và push docker image lên docker hub.
III. Thiết lập CI/CD
Ở đây chúng ta sẽ thực hiện cấu hình CI/CD sử dụng Github Actions. Ngoài github Action thì các bạn có thể sử dụng rất nhiều platform khác như Gitlab, Travis CI, Circle CI hay thậm chí là Jenkins.
Github có 2 loại runner là GitHub-hosted runners và self-hosted runners. Github-hosted runners là các máy tính để chạy CI/CD được cung cấp và vận hành bởi Github. Còn self-hosted runners thì là máy tính của chúng ta nhưng được github hỗ trợ để sử dụng chạy CI/CD. Trong phạm vi bài viết này chúng ta sẽ sử dụng self-hosted runners.
1. Cấu hình môi trường để chạy CI/CD
Để thực hiện cấu hình thì các bạn bật terminal và thực hiện các bước sau.
2.1 Update apt source
sudo apt-get update
2.1 Cài đặt docker
sudo apt-get install docker.io docker-compose up
sudo systemctl enable docker
2.2 Cài đặt Go
sudo add-apt-repository ppa:longsleep/golang-backports
sudo apt update
sudo apt install golang-go
2.3 Thêm user vào docker group
sudo usermod -a -G docker $(whoami)
2. Cấu hình Github Actions self-hosted runners
2.1 Thêm self-hosted runners
Đầu tiên chúng ta truy cập vào setting Actions của repo trên Github.
Và sau đó chúng ta chọn thêm runner. Ở đây Github hướng dẫn chúng ta rất chi tiết từ việc download app về, cấu hình và chạy. Bước này chúng ta chỉ làm một lần. Khi nào khỏi động lại máy tính hoặc tắt runners đi rồi thì chỉ việc chạy ./run.sh để chạy lại thôi.
Sau khi thực hiện xong các bước thì back về trang cấu hình Actions để xem kết quả.
2.2 Thêm biến môi trường
Để push được docker image lên docker hub thì chúng ta cần phải login cho docker. Vì vậy chúng ta phải thêm cấu hình biến môi trường cho tài khoản và mật khẩu của docker hub.
Chúng ta vào trang cấu hình Secrets trong setting của repo.
New Secret
Chúng ta cần thêm 2 biến là DOCKER_USERNAME và DOCKER_PASSWORD
IV. Cấu hình CI/CD cho project Go
1. Viết Dockerfile
Chúng ta sẽ dùng docker để build project go này. Dockerfile là file cấu hình và từ đó chúng ta sẽ build nó thành docker image. Thực hiện tại file Dockerfile tại thư mục chính của project.
FROM golang:alpine as BUILDER WORKDIR /go/src/app COPY . . RUN go mod vendor RUN GOOS=linux go build -o main FROM alpine EXPOSE 80 WORKDIR /app COPY --from=BUILDER /go/src/app/main /app CMD /app/main
2. Cấu hình Github Actions
Tạo thư mục có tên .github tại gốc của project.
Trong thư mục .github tiếp tục tạo thư mục workflows.
Trong thư mục workflows chúng ta sẽ tạo file cấu hình cho Github Actions. File cấu hình được viết theo syntax YAML.
Thực hiện tạo file main.yml trong thư mục workflows
name: CI
on:
push:
branches: [ master, develop ]
pull_request:
branches: [ master, develop ]
jobs:
test:
runs-on: [self-hosted, Linux]
steps:
- uses: actions/checkout@v2
- name: Install dependency
run: go mod download
- name: Unit test
run: make test
continue-on-error: false
build:
runs-on: [self-hosted, Linux]
needs: [test]
steps:
- name: Login docker registry
run: sudo docker login -u ${DOCKER_USERNAME} -p ${DOCKER_PASSWORD}
env:
DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
- name: Change script permission
run: chmod +x build_image.sh
- name: Build
run: sudo ./build_image.sh
Sau khi commit file cấu hình và đẩy lên github thì Github Actions sẽ chạy. Thử vào check và kết quả như sau
Chúng ta thử vào trang docker hub để kiểm tra.
Code của chúng ta đã được build và đẩy lên docker hub rồi. Giờ chúng ta có thể deploy sử dụng image này.
V. Deploy sử dụng docker
Giờ để deploy lên server thì tất nhiên cần phải ssh lên server rồi 😀
Đầu tiên chúng ta thực hiện login vào docker hub nếu chưa login. Sau khi gọi lệnh login thì docker sẽ hỏi tài khoản và mật khẩu docker hub của chúng ta.
sudo docker login
Tiếp theo, chúng ta tạo file docker-compose.yml để cấu hình (nếu chưa có)
version: '3'
services:
api:
image: thanhdev2703/demogocicd
restart: always
ports:
- 80:80
volumes:
- /data/log:/app/log
- ./.env:/app/.env
network_mode: "host"
Sau khi tạo xong file docker-compose.yml thì thực hiện lệnh sau để deploy (lần đầu).
sudo docker-compose up -d
Để thực hiện deploy code mới thì thực hiện như sau
sudo docker-compose pull
sudo docker-compose down
sudo docker-compose up -d
VI. Tổng kết
Như vậy chúng ta đã cấu hình xong CI/CD cho project dùng go. Thật đơn giản phải không nào.
Các bạn có thể tham khảo repo tại đây: https://github.com/ThanhDev2703/DemoGo-CICD
Tham khảo:
– https://github.com/features/actions
– https://github.com/actions/setup-go
– https://docs.github.com/en/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration