vagrantlibvirt/vagrant-libvirt

Vagrant Libvirt Provider Docker镜像

概述和主要用途

该镜像包含vagrant-libvirt和Vagrant版本，允许通过Libvirt控制和配置机器，无需处理Vagrant上游版本与系统安装的Libvirt包之间的各种兼容性问题。这是由于vagrant-libvirt提供程序需要针对Vagrant自带的Ruby和Libvirt开发库进行编译。

vagrant-libvirt文档发布于https://vagrant-libvirt.github.io/vagrant-libvirt/

核心功能和特性

• 包含构建和安装vagrant-libvirt及其依赖所需的完整工具链
• 提供带有-slim后缀的轻量级镜像，适用于无需安装额外插件的场景
• 解决Vagrant与系统Libvirt包的兼容性问题，确保跨发行版一致运行
• 支持本地和远程Libvirt连接，通过环境变量灵活配置连接URI

要求

• https://libvirt.org - 支持1.5或更新版本
• https://docker.com

使用场景和适用范围

• 需要在多个Linux发行版上一致运行vagrant-libvirt的环境
• 希望避免系统中Vagrant与Libvirt包版本冲突的用户
• 通过Libvirt进行虚拟机管理和配置的开发、测试环境

使用方法和配置说明

获取镜像

获取最新发布版本的镜像：

bash
docker pull docker.xuanyuan.run/vagrantlibvirt/vagrant-libvirt:latest

如需获取最新代码构建的镜像，可使用edge标签：

bash
docker pull docker.xuanyuan.run/vagrantlibvirt/vagrant-libvirt:edge

运行镜像

基本运行命令：

bash
docker run -it --rm \
  -e LIBVIRT_DEFAULT_URI \  # 传递Libvirt连接URI环境变量
  -v /var/run/libvirt/:/var/run/libvirt/ \  # 挂载本地Libvirt socket（本地连接时需要）
  -v ~/.vagrant.d:/.vagrant.d \  # 挂载Vagrant配置目录
  -v $(realpath "${PWD}"):${PWD} \  # 挂载当前工作目录
  -w "${PWD}" \  # 设置工作目录
  --network host \  # 使用主机网络
  vagrantlibvirt/vagrant-libvirt:latest \
    vagrant status  # 执行Vagrant命令

注意：如果连接远程Libvirt系统，可省略-v /var/run/libvirt/:/var/run/libvirt/挂载。部分发行版会修补本地Vagrant环境，确保vagrant-libvirt使用qemu:///session，此时可能需要设置LIBVIRT_DEFAULT_URI环境变量以匹配。

在.bashrc中定义便捷函数

为方便日常使用，可在~/.bashrc中定义函数：

bash
vagrant(){
  docker run -it --rm \
    -e LIBVIRT_DEFAULT_URI \
    -v /var/run/libvirt/:/var/run/libvirt/ \
    -v ~/.vagrant.d:/.vagrant.d \
    -v $(realpath "${PWD}"):${PWD} \
    -w "${PWD}" \
    --network host \
    vagrantlibvirt/vagrant-libvirt:latest \
      vagrant $@
}

定义后可直接在终端使用vagrant命令，如同本地安装。

扩展容器镜像以安装额外Vagrant插件

默认镜像包含安装vagrant-libvirt插件及其依赖所需的完整工具链，支持安装需要原生扩展的插件。可通过以下方式构建包含额外插件的镜像：

dockerfile
FROM docker.xuanyuan.run/vagrantlibvirt/vagrant-libvirt:latest

RUN vagrant plugin install <插件名称>

注意：当前镜像已将插件与Vagrant系统插件捆绑，不再每次尝试重新安装。未来这将成为默认行为，因此安装额外插件时需确保满足其依赖要求。