Posted inVirtualization

Tự tay đóng gói Vagrant Box từ KVM/Libvirt: Giải pháp tối ưu môi trường Lab cho Team IT

Virtualization tutorial - IT technology blog
Virtualization tutorial - IT technology blog

Tại sao phải tự tạo Vagrant Box khi kho hàng có sẵn đã quá đồ sộ?

Trong các dự án thực tế, mình thường xuyên đụng trần với các bản Vagrant Box mặc định trên Vagrant Cloud. Một bản Ubuntu hay CentOS “trắng” thường thiếu hụt các công cụ đặc thù như Docker, Proxy nội bộ hoặc các kernel module đã được tinh chỉnh. Bắt đồng nghiệp chạy một sớ lệnh dài dằng dặc sau khi vagrant up là một cực hình. Nó vừa tốn thời gian, vừa dễ phát sinh lỗi do sự khác biệt về mirror repository hoặc đường truyền network.

Từ khi chuyển hẳn sang Linux, mình coi KVM/Libvirt là “chân ái” nhờ hiệu năng vượt trội so với VirtualBox. Tại homelab cá nhân, mình quản lý khoảng 15 VM trên Proxmox để test tính năng trước khi đẩy lên Production. Khi một setup đã chạy mượt, việc đóng gói nó thành file .box giúp tiết kiệm tới 80% thời gian triển khai cho thành viên mới. Anh em chỉ cần tải về, up một phát là có ngay môi trường chuẩn chỉ.

Ba hướng tiếp cận phổ biến khi xây dựng môi trường Lab

1. Public Box kết hợp Shell Provisioner

Đây là cách đơn giản nhất: lấy OS gốc rồi viết script cài cắm. Tuy nhiên, nếu project cần compile mã nguồn nặng hoặc cài các bộ công cụ hàng GB, mỗi lần vagrant destroy rồi dựng lại sẽ cực kỳ chậm chạp.

2. Infrastructure as Code (Ansible/Terraform)

Cách này chuyên nghiệp, phù hợp để quản lý hệ thống lớn. Dù vậy, với các nhu cầu test nhanh hoặc Lab cá nhân, việc duy trì thêm một bộ Playbook đôi khi lại gây lãng phí nguồn lực không cần thiết.

3. Đóng gói Custom Vagrant Box (Lựa chọn tối ưu)

Bạn cấu hình mọi thứ chuẩn xác một lần duy nhất trên KVM. Sau khi dọn dẹp rác, bạn đóng gói tất cả vào một file duy nhất. Đồng nghiệp chỉ mất vài giây để sở hữu một môi trường giống hệt bạn, không sai một li.

Chuẩn bị máy ảo KVM nguồn: Những quy tắc ngầm

Để Vagrant điều khiển được máy ảo, hệ thống cần được cấu hình theo đúng chuẩn. Quy trình này khá thẳng bước, không hề đánh đố như bạn tưởng.

Bước 1: Thiết lập User vagrant và quyền Sudo

Vagrant mặc định truy cập qua SSH bằng user vagrant. Hãy tạo user này và cấp quyền thực thi lệnh sudo mà không cần hỏi mật khẩu.

# Tạo user và đặt mật khẩu mặc định là 'vagrant'
sudo useradd -m -s /bin/bash vagrant
sudo passwd vagrant 

# Cấp quyền sudo không mật khẩu
echo "vagrant ALL=(ALL) NOPASSWD:ALL" | sudo tee /etc/sudoers.d/vagrant
sudo chmod 0440 /etc/sudoers.d/vagrant

Bước 2: Cấu hình Insecure Key để tự động hóa Login

Thay vì dùng mật khẩu, Vagrant dùng một cặp Public Key mặc định để kết nối lần đầu. Bạn cần đưa key này vào danh sách tin cậy của máy ảo.

mkdir -p /home/vagrant/.ssh
chmod 700 /home/vagrant/.ssh
# Tải public key từ repository chính thức của Hashicorp
curl -L https://raw.githubusercontent.com/hashicorp/vagrant/master/keys/vagrant.pub -o /home/vagrant/.ssh/authorized_keys
chmod 600 /home/vagrant/.ssh/authorized_keys
chown -R vagrant:vagrant /home/vagrant/.ssh

Bước 3: “Làm sạch” hệ thống trước khi đóng gói

File box càng nhẹ, tốc độ chia sẻ càng nhanh. Hãy xóa bỏ các file tạm, log cũ và reset cấu hình network để tránh lỗi trùng địa chỉ MAC sau này.

sudo apt-get clean
sudo rm -rf /var/lib/apt/lists/*
# Xóa quy tắc udev để Vagrant tự nhận diện card mạng mới
sudo rm -f /etc/udev/rules.d/70-persistent-net.rules

Quy trình đóng gói máy ảo sang định dạng .box

Hãy đảm bảo máy ảo nguồn đang ở trạng thái Shut off. Với Libvirt, chúng ta sẽ thực hiện thủ công để kiểm soát tối đa cấu trúc file.

Giải mã cấu trúc một Vagrant Box cho Libvirt

Thực chất, file .box là một bản nén tar.gz chứa 3 thành phần cốt lõi:

  • metadata.json: Chỉ định provider là libvirt.
  • Vagrantfile: Chứa các thiết lập mặc định của box.
  • box.img: File ổ đĩa định dạng qcow2 lấy từ máy ảo gốc.

Các bước triển khai chi tiết

1. Khởi tạo không gian làm việc:

mkdir my-custom-box && cd my-custom-box

2. Sao chép file image từ kho lưu trữ của Libvirt (mặc định tại /var/lib/libvirt/images/):

sudo cp /var/lib/libvirt/images/ubuntu22-template.qcow2 ./box.img
sudo chown $USER:$USER ./box.img

3. Tạo file metadata.json với thông số dung lượng thực tế (ví dụ 20GB):

{
  "provider": "libvirt",
  "format": "qcow2",
  "virtual_size": 20
}

4. Viết Vagrantfile nội bộ để định nghĩa driver:

Vagrant.configure("2") do |config|
  config.vm.provider :libvirt do |libvirt|
    libvirt.driver = "kvm"
    libvirt.storage_pool_name = "default"
  end
end

5. Nén toàn bộ thành phẩm:

tar cvzf my-ubuntu-k8s.box metadata.json Vagrantfile box.img

Kiểm tra thành quả: Từ 0 đến 1 trong vài giây

Sau khi có file my-ubuntu-k8s.box, bạn có thể ném nó lên server nội bộ hoặc gửi qua Slack cho team. Cách dùng cực kỳ đơn giản:

# Đưa box vào danh sách quản lý
vagrant box add --name team-alpha/ubuntu-k8s my-ubuntu-k8s.box

# Khởi chạy dự án mới
mkdir dev-env && cd dev-env
vagrant init team-alpha/ubuntu-k8s
vagrant up

Vagrant sẽ tự động import image vào pool của Libvirt và thiết lập SSH. Bạn sẽ thấy mình login thẳng vào máy ảo mà không cần nhập bất kỳ mật khẩu nào.

Kinh nghiệm xương máu để tránh “ăn hành”

Trong quá trình làm, mình rút ra 3 lưu ý quan trọng để file box chuyên nghiệp hơn:

  • Kỹ thuật Sparse files: Luôn dùng cp --sparse=always khi copy image. Nó giúp file 20GB nhưng thực tế chỉ chiếm vài GB dung lượng thực, cực kỳ tiết kiệm bộ nhớ.
  • Sử dụng Virt-sysprep: Nếu dùng Fedora hoặc CentOS, hãy chạy virt-sysprep. Công cụ này tự động xóa machine-id và SSH host keys, tránh lỗi xung đột định danh khi chạy nhiều VM cùng lúc.
  • Cài đặt Plugin: Nhắc nhở team cài vagrant-libvirt trước. Thiếu plugin này, Vagrant sẽ cố tìm VirtualBox và báo lỗi ngay lập tức.

Làm chủ cách tạo Vagrant Box không chỉ là kỹ năng kỹ thuật, mà còn là tư duy tối ưu hóa quy trình. Thay vì mất cả buổi sáng hướng dẫn nhân viên mới setup môi trường, giờ đây bạn chỉ cần gửi một đường link. Chúc bạn đóng gói thành công!

Share:
Tags: