Vagrant虚拟机如何实现自动化部署

Vagrant 自动化部署实战指南

一 核心思路与流程

• 安装基础工具：在宿主机安装 Vagrant 与虚拟化提供程序（如 VirtualBox），这是一切自动化的起点。Vagrant 负责编排虚拟机生命周期，VirtualBox 提供虚拟化能力。
• 定义环境：用 Vagrantfile 声明操作系统镜像（box）、网络、共享目录、硬件资源与“Provision 自动化步骤”。
• 一键启动：执行 vagrant up，Vagrant 会自动下载镜像、创建并启动虚拟机，随后按 Provision 配置安装与部署软件。
• 验证与复用：用 vagrant ssh 登录验证；环境稳定后可打包为 box，在团队内快速复用与分发。
• 常用命令：vagrant reload（重启并应用变更）、vagrant halt（关机）、vagrant destroy（销毁）。

二 最小化 Vagrantfile 示例

# -*- mode: ruby -*-
# vi: set ft=ruby :

Vagrant.configure("2") do |config|
  config.vm.define "app01" do |node|
    node.vm.box      = "ubuntu/focal64"
    node.vm.hostname = "app01"
    node.vm.network "private_network", ip: "192.168.56.10"

    # 可选：共享目录（当前目录 -> /vagrant）
    node.vm.synced_folder ".", "/vagrant", type: "nfs"

    # 可选：端口转发（宿主机 8080 -> 虚拟机 80）
    node.vm.network "forwarded_port", guest: 80, host: 8080

    node.vm.provider "virtualbox" do |vb|
      vb.memory = 2048
      vb.cpus   = 2
      vb.name   = "app01"
    end

    # 核心：Provision 自动化（Shell 脚本）
    node.vm.provision "shell", path: "bootstrap.sh"
  end
end

• 在同目录准备 bootstrap.sh（示例）：

#!/usr/bin/env bash
set -eux
apt-get update
apt-get install -y nginx
systemctl enable --now nginx
echo "Hello, Vagrant Provision!" > /var/www/html/index.html

• 常用操作：
  • 首次创建并部署：vagrant up（会自动执行 bootstrap.sh）
  • 仅重建并重新执行 Provision：vagrant up --provision
  • 重启：vagrant reload
  • 登录：vagrant ssh
  • 销毁：vagrant destroy

三 常用自动化方案对比与选型

• 示例（Ansible 本地执行器）：

config.vm.provision "ansible" do |ansible|
  ansible.playbook = "playbook.yml"
  ansible.inventory_path = "inventory"
end

• 示例（Docker Compose 插件）：

# 安装插件：vagrant plugin install vagrant-docker-compose
config.vm.provision :docker_compose, yml: "docker-compose.yml", rebuild: true, run: "always"

• 以上三种方式可与 Shell 混合使用，按复杂度与团队成熟度选择或演进。

四 多机集群与网络规划

• 在同一 Vagrantfile 中定义多台机器，分别配置 private_network IP 与 hostname，便于服务互联与测试。
• 示例（三节点）：

Vagrant.configure("2") do |config|
  %w[master01 worker01 worker02].each_with_index do |name, i|
    config.vm.define name do |node|
      node.vm.box      = "centos/7"
      node.vm.hostname = name
      node.vm.network "private_network", ip: "192.168.56.#{101 + i}"

      node.vm.provider "virtualbox" do |vb|
        vb.memory = 2048
        vb.cpus   = 2
        vb.name   = name
      end

      # 每台机器各自执行自己的 bootstrap
      node.vm.provision "shell", path: "bootstrap-#{name}.sh"
    end
  end
end

• 提示：修改网络或硬件后，使用 vagrant reload 使配置生效。

五 实践建议与常见问题

• 目录与路径：Vagrantfile 所在目录建议使用全英文路径，避免插件或脚本执行异常。
• 镜像与 Box：优先使用官方 box 仓库；稳定后可 打包为自定义 box 共享，保证环境一致性。
• 网络选择：同网段 private_network 适合多机互联；需要对外暴露服务时使用 forwarded_port。
• 可重复构建：将变更尽量写入 Vagrantfile/Playbook/脚本，通过 –provision 实现可重复、可回滚的部署。
• 资源控制：在 provider 中设置 memory/cpus，必要时限制 CPU 执行占比（如 VirtualBox 的 –cpuexecutioncap）。
• 常见问题速查：
  • 端口冲突：更换 host 端口或关闭占用进程。
  • 共享目录性能：Linux 宿主机优先使用 NFS 类型。
  • 插件安装失败：确认网络与 RubyGems 源可用，必要时使用国内镜像。