vagrant日常操作

Vagrant简介

Vagrant 是一个用来构建和管理虚拟机环境的工具，实现配置运维自动化，支持virtualbox，vmware等常见hypervisor。

写这篇文章的目的主要是vagrant功能有很多，但我的日常工作基本只用到下面的部分，记录一下，供参考。

下面几个概念简单介绍一下方便理解：

• box：相当于一个虚拟机镜像，可以通过本地文件，远程连接添加
• vm：相当于虚拟机实例，如virtualbox虚拟机，vm都是基于某个box创建
• Vagrantfile：一组(支持几个vm构成集群)vm的描述，包括其基于的box，网络模式，存储，共享目录，provider(hypervisor)，配置（Shell，Puppet，Ansible，Chef，Salt等）等。

详细介绍见参考资料。

日常工作流

操作介绍

添加box

$ cd /drives/d/work/vagrant/boxes

### 通过本地box文件添加
$ vagrant box add centos8_pg12 centos8_pg12.box
==> box: Box file was not detected as metadata. Adding it directly...
==> box: Adding box 'centos8_pg12' (v0) for provider:
    box: Unpacking necessary files from: file://D:/work/vagrant/boxes/centos8_pg12.box
    box:
==> box: Successfully added box 'centos8_pg12' (v0) for 'virtualbox'!

$ vagrant.exe box list
centos8_pg12         (virtualbox, 0)      


### 通过远程连接添加
$ vagrant box add centos8_2011  https://mirrors.ustc.edu.cn/centos-cloud/centos/8/vagrant/x86_64/images/CentOS-8-Vagrant-8.3.2011-20201204.2.x86_64.vagrant-virtualbox.box

                                                                                 

初始化Vagrantfile

## 为vm创建一个新的目录
$ mkdir /path/of/your/vm
$ cd /path/of/your/vm

## init后分别为新vm的name，使用的box name
$vagrant init hgcndn-centos8 centos8_pg12
A `Vagrantfile` has been placed in this directory. You are now
ready to `vagrant up` your first virtual environment! Please read
the comments in the Vagrantfile as well as documentation on
`vagrantup.com` for more information on using Vagrant.

$ 

修改Vagrantfile

以下PRIVATE start/end之间的为推荐手动添加的选项。

> vi Vagrantfile
## 自定义的部分<PRIVATE start> <PRIVATE end>

Vagrant.configure("2") do |config|
  config.vm.box = "centos8_pg12"

  # <PRIVATE start>
  # set the hostname in vm
  # vm中对应的hostname
  config.vm.hostname = "hgcndn-centos8"

  # the vm name used by vagrant
  # 一个vagrantfile中定义多个vm的话，通过指定名字可以单独控制
  # 比如指定某一vm进行up操作
  config.vm.define "hgcndn-centos8"

  # 指定磁盘大小(virtualbox中为动态扩展，这是上限值)
  # 需要安装插件，方法见插件安装部分
  config.disksize.size = '200GB'

  # this mapping to host-only
  config.vm.network "private_network", type: "dhcp"
  config.vm.synced_folder "D:/work/vagrant/data", "/vagrant_data"

  config.vm.provider "virtualbox" do |vb|
     vb.memory = "1024"
     
     # the vm name in virtualbox
     # 不指定的话会随机生成，在virtualbox中看起来不直观
     vb.name = "hgcndn-centos8"
  end
  # <PRIVATE end>
end

启动，配置vm

vagrant.exe up

ssh登录

$ cd /path/of/vm/dir/
## 默认用户名vagrant密码vagrant
$ vagrant ssh

插件安装

有的feature如指定disksize需要安装插件，默认会使用官方插件源，国内基本连不上，需要指定使用国内源

## vagrant-disksize为插件名称
$ vagrant plugin install  --plugin-source https://gems.ruby-china.com/ vagrant-disksize

常用插件

# 支持指定disksize
. vagrant-disksize

# 支持共享目录
. vagrant-vbguest
. micromachine

虚拟机package为box

打包为box后，可用于作为模板创建新的vm，或者copy到别的vagrant环境下来创建vm，实现vm迁移(换电脑时vm搬家就用上了)。

$cd /drives/d/work/vagrant/vms/centos8_pg12
$vagrant.exe halt

$vagrant package --output ../../boxes/centos8_pg12.box
==> centos8-pg12: Clearing any previously set forwarded ports...
==> centos8-pg12: Exporting VM...
==> centos8-pg12: Compressing package to: D:/work/vagrant/boxes/centos8_pg12.box

Trouble-shooting

up后ssh登录失败

现象

vagrant up
.....
 SSH auth method: password
Warning: Authentication failure. Retrying…

  原因

Vagrantfile中指定了password，但是box中ssh设置不允许密码登陆

或者box中ssh允许密码登陆，但是Vagrantfile中没有指定password

  config.ssh.username = "vagrant"
  config.ssh.password = "vagrant"

# "/etc/ssh/sshd_config"
PasswordAuthentication no

# service sshd restart

解决方案

 针对以上情形，分别修改

 . Vagrantfile中不要指定ssh的username，password

 . Vagrantfile中指定ssh的username，password

MobaXterm中vagrant ssh失败

现象

vagrant.exe ssh
==> pg12: The machine you're attempting to SSH into is configured to use
==> pg12: password-based authentication. Vagrant can't script entering the
==> pg12: password for you. If you're prompted for a password, please enter
==> pg12: the same password you have configured in the Vagrantfile.
C:/HashiCorp/Vagrant/embedded/gems/2.2.14/gems/vagrant-2.2.14/lib/vagrant/util/subprocess.rb:160:in `rescue in execute':  (216) (Vagrant::Util::Subprocess::LaunchError)
        from C:/HashiCorp/Vagrant/embedded/gems/2.2.14/gems/vagrant-2.2.14/lib/vagrant/util/subprocess.rb:153:in `execute'
        from C:/HashiCorp/Vagrant/embedded/gems/2.2.14/gems/vagrant-2.2.14/lib/vagrant/util/subprocess.rb:22:in `execute'
...

原因

  未知

解决方案

 通过下面方法ssh

# pg12对应vm的name
vagrant ssh-config  > ssh-config  && ssh -F ssh-config pg12

共享目录设置失败

现象

$vagrant up
...
unknown filesystem type 'vboxsf' after vagrant up

原因

  缺少插件

解决方案

## vagrant-disksize为插件名称
$ vagrant plugin install --plugin-source https://gems.ruby-china.com/ vagrant-vbguest
$ vagrant plugin install --plugin-source https://gems.ruby-china.com/ micromachine

vm无法通过用户名密码登录

原因是vm中的sshd配置为不允许密码登录

解决方案

$ su
> vi /etc/ssh/sshd_config
PasswordAuthentication yes

$ service sshd restart

vm，box占用C盘空间太多

详见我另一篇文章 修改vagrant，virtualbox数据目录

推荐box源

https://mirrors.ustc.edu.cn/centos-cloud/centos/8/vagrant/x86_64/images/

参考资料

Vagrant 入门指南_qhh0205的博客-CSDN博客_vagrant

CSDN