GitOps thực tế: Xây dựng hệ thống kiểm soát triển khai hạ tầng với Atlantis và OpenTofu trên VPS
Hướng dẫn chi tiết cách triển khai GitOps thực tế bằng Atlantis và OpenTofu trên VPS để kiểm soát hạ tầng mã nguồn mở, tự động hóa và đảm bảo tính nhất quán.
Nguồn ảnh: viarami · Pixabay Content License
Giới thiệu về GitOps và vai trò của Atlantis, OpenTofu
GitOps là một phương pháp triển khai hạ tầng (Infrastructure as Code - IaC) dựa trên mã nguồn, nơi mọi thay đổi về hạ tầng đều được quản lý qua Git. Với GitOps, mọi thay đổi được thực hiện thông qua Pull Request (PR), được kiểm tra, phê duyệt và tự động triển khai. Phương pháp này đảm bảo tính nhất quán, kiểm soát thay đổi và khả năng truy vết dễ dàng.
Atlantis là một công cụ tự động hóa cho quá trình triển khai IaC, hỗ trợ tích hợp với Git, tự động thực hiện terraform plan và apply khi có PR. OpenTofu, một nhánh mã nguồn mở của Terraform, cung cấp khả năng triển khai hạ tầng với các tính năng tương tự nhưng không phụ thuộc vào HashiCorp.
Trong hướng dẫn này, chúng ta sẽ xây dựng một hệ thống GitOps thực tế trên VPS bằng Atlantis và OpenTofu, cho phép triển khai hạ tầng một cách tự động, an toàn và kiểm soát.
Yêu cầu và thiết lập môi trường
Để triển khai hệ thống GitOps với Atlantis và OpenTofu, bạn cần:
- Một VPS có RAM tối thiểu 4GB (tham khảo: Cloud VPS RAM lớn cho Self-Host LLM & API Gateway)
- Linux (Ubuntu 22.04 hoặc Debian 11)
- Git, Docker, Docker Compose
- OpenTofu (phiên bản 1.10+)
- GitHub hoặc GitLab (để lưu trữ mã nguồn)
Thiết lập Atlantis và OpenTofu trên VPS
Thực hiện các bước sau để thiết lập môi trường:
- Cài đặt OpenTofu:
- Tạo thư mục dự án:
- Khởi tạo dự án OpenTofu:
- Chạy Atlantis bằng Docker:
sudo apt update
sudo apt install -y wget gnupg
wget -qO - https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update
sudo apt install -y tofutwo
mkdir -p /opt/gitops/infra
cd /opt/gitops/infra
tofutwo init
docker run -d --name atlantis -p 3000:3000 \
-e ATLANTIS_GITHUB_USER=your-username \
-e ATLANTIS_GITHUB_TOKEN=your-token \
-e ATLANTIS_GITHUB_HOST=github.com \
-e ATLANTIS_REPO_ALLOWLIST=* \
-e ATLANTIS_REPO_CONFIG=/atlantis/config.yaml \
-v /opt/gitops/infra:/atlantis/repos \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /root/.ssh:/root/.ssh \
-v /tmp/atlantis:/tmp/atlantis \
runatlantis/atlantis:latest
Thiết lập Git và tự động hóa triển khai
Để tích hợp với Git, bạn cần:
- Tạo một repository trên GitHub/GitLab và push mã nguồn OpenTofu.
- Trong thư mục dự án, tạo file
atlantis.yaml: - Chạy lệnh
tofutwo planđể kiểm tra cấu hình. - Đẩy thay đổi lên Git và tạo PR. Atlantis sẽ tự động thực hiện
planvà chờ phê duyệt. - Khi PR được phê duyệt, Atlantis sẽ thực hiện
apply.
version: 3
projects:
- name: infra
dir: .
workspace: default
terraform_version: 1.10.0
terraform_init_options:
- -upgrade
autoplan:
when_modified:
- "*.tf"
- "*.tfvars"
enabled: true
apply_requirements: [approved, mergeable]
Xác minh và khắc phục sự cố
Để kiểm tra hệ thống hoạt động đúng:
- Truy cập
http://để xem giao diện Atlantis.:3000 - Đảm bảo rằng các PR được xử lý đúng cách.
- Giải thích lỗi bằng cách kiểm tra log Docker:
docker logs atlantis. - Đảm bảo rằng OpenTofu có quyền truy cập vào VPS và các tài nguyên cần thiết.
Tài liệu tham khảo
Cấu hình Cloud VPS RAM cao tối ưu cho AI, Database & Cache
SSD NVMe Enterprise RAID 10, đường truyền CMC & FPT Quận 9 chống DDoS Anycast, Uptime SLA 99.99%.
VPS-4E
Đã gồm VAT 10%
- CPU: 4 vCPU
- RAM: 8 GB
- SSD: 50 GB NVMe
VPS-5E
Đã gồm VAT 10%
- CPU: 8 vCPU
- RAM: 16 GB
- SSD: 100 GB NVMe
