Vagrant 基本設定

如何管理 Vagrant boxes？

如果在網路上找到了一個適合的 box (e.g. bento/debian-8.6) 想要下載並新增到本機，可以使用 vagrant box add <box_name> <box_url> 並選擇自己需要的版本，舉例來說：

  1. $ vagrant box add bento/debian-8.6 https://atlas.hashicorp.com/bento/boxes/debian-8.6
  3. ==> box: Loading metadata for box 'https://atlas.hashicorp.com/bento/boxes/debian-8.6'
  4. This box can work with multiple providers! The providers that it
  5. can work with are listed below. Please review the list and choose
  6. the provider you will be working with.
  8. 1) parallels
  9. 2) virtualbox
  10. 3) vmware_desktop
  12. Enter your choice: 2
  13. ==> box: Adding box 'bento/debian-8.6' (v2.3.0) for provider: virtualbox
  14.     box: Downloading: https://atlas.hashicorp.com/bento/boxes/debian-8.6/versions/2.3.0/providers/virtualbox.box
  15. ==> box: Successfully added box 'bento/debian-8.6' (v2.3.0) for 'virtualbox'!

下載完成後，檢查一下目前所有安裝在本機的 Vagrant boxes：

  1. $ vagrant box list
  3. bento/debian-8.6                  (virtualbox, 2.3.0)
  4. bento/ubuntu-14.04                (virtualbox, 201708.22.0)

同理，如果要移除不再需要的 box，可以使用 vagrant box remove <box_name>：

  1. $ vagrant box remove bento/debian-8.6

透過 vagrant box list 確定一下 box 已經被成功移除：

  1. $ vagrant box list
  3. bento/ubuntu-14.04 (virtualbox, 201708.22.0)

透過 Vagrantfile 配置測試環境

還記得在上一個章節內我們在初始化 Vagrant 時系統自動產生的 Vagrantfile 嗎？現在把這個檔案打開，你應該會看到以下結果：

  1. # -*- mode: ruby -*-
  2. # vi: set ft=ruby :
  4. # All Vagrant configuration is done below. The "2" in Vagrant.configure
  5. # configures the configuration version (we support older styles for
  6. # backwards compatibility). Please don't change it unless you know what
  7. # you're doing.
  8. Vagrant.configure("2") do |config|
  9.   # The most common configuration options are documented and commented below.
  10.   # For a complete reference, please see the online documentation at
  11.   # https://docs.vagrantup.com.
  13.   # Every Vagrant development environment requires a box. You can search for
  14.   # boxes at https://vagrantcloud.com/search.
  15.   config.vm.box = "bento/ubuntu-14.04"
  17.   # Disable automatic box update checking. If you disable this, then
  18.   # boxes will only be checked for updates when the user runs
  19.   # `vagrant box outdated`. This is not recommended.
  20.   # config.vm.box_check_update = false
  22.   # Create a forwarded port mapping which allows access to a specific port
  23.   # within the machine from a port on the host machine. In the example below,
  24.   # accessing "localhost:8080" will access port 80 on the guest machine.
  25.   # NOTE: This will enable public access to the opened port
  26.   # config.vm.network "forwarded_port", guest: 80, host: 8080
  28.   # Create a forwarded port mapping which allows access to a specific port
  29.   # within the machine from a port on the host machine and only allow access
  30.   # via 127.0.0.1 to disable public access
  31.   # config.vm.network "forwarded_port", guest: 80, host: 8080, host_ip: "127.0.0.1"
  33.   # Create a private network, which allows host-only access to the machine
  34.   # using a specific IP.
  35.   # config.vm.network "private_network", ip: "192.168.33.10"
  37.   # Create a public network, which generally matched to bridged network.
  38.   # Bridged networks make the machine appear as another physical device on
  39.   # your network.
  40.   # config.vm.network "public_network"
  42.   # Share an additional folder to the guest VM. The first argument is
  43.   # the path on the host to the actual folder. The second argument is
  44.   # the path on the guest to mount the folder. And the optional third
  45.   # argument is a set of non-required options.
  46.   # config.vm.synced_folder "../data", "/vagrant_data"
  48.   # Provider-specific configuration so you can fine-tune various
  49.   # backing providers for Vagrant. These expose provider-specific options.
  50.   # Example for VirtualBox:
  51.   #
  52.   # config.vm.provider "virtualbox" do |vb|
  53.   #   # Display the VirtualBox GUI when booting the machine
  54.   #   vb.gui = true
  55.   #
  56.   #   # Customize the amount of memory on the VM:
  57.   #   vb.memory = "1024"
  58.   # end
  59.   #
  60.   # View the documentation for the provider you are using for more
  61.   # information on available options.
  63.   # Enable provisioning with a shell script. Additional provisioners such as
  64.   # Puppet, Chef, Ansible, Salt, and Docker are also available. Please see the
  65.   # documentation for more information about their specific syntax and use.
  66.   # config.vm.provision "shell", inline: <<-SHELL
  67.   #   apt-get update
  68.   #   apt-get install -y apache2
  69.   # SHELL
  70. end

簡單來說，Vagrantfile 就是每一台的虛擬機的規格表。雖然乍看之下這個檔案長得有些驚悚，但仔細研究後會發現目前真正有用到的配置其實只有以下短短幾行而已：

  1. Vagrant.configure("2") do |config|
  2.   config.vm.box = "bento/ubuntu-14.04"
  3. end

而這段程式碼就是告訴 Vagrant 我們想要用 bento/ubuntu-14.04 當作我們這台虛擬機的 box。每次我們啟動或部署 Vagrant 虛擬機時就是依據這一份設置文件來進行配置。其他在註解內的文字是一般我們在開發時常常用到的配置選項，隨著開發需要的不同，我們可以在這個配置文件中客製化我們的開發環境，並分享給團隊其他成員。

如何管理 Vagrant 虛擬機？

首先，我們可以使用 vagrant status 來確認當前 Vagrant 主機的運作狀況：

  1. $ vagrant status
  3. Current machine states:
  5. default                   running (virtualbox)
  7. The VM is running. To stop this VM, you can run `vagrant halt` to
  8. shut it down forcefully, or you can run `vagrant suspend` to simply
  9. suspend the virtual machine. In either case, to restart it again,
  10. simply run `vagrant up`.

我們可以清楚發現雖然虛擬機已經成功運行，但主機名稱顯示為 default。這種模糊的名稱在管理主機數量多起來後常常會造成開發者的困擾。為了避免混淆，我們可以先用 vagrant halt 將目前的虛擬機暫停或是使用 vagrant destroy 直接摧毀。接下來，在 Vagrantfile 中加入下列設置來替我們的虛擬機命名：

  1. config.vm.define "server"

接著在重新啟動一個新的主機後檢查其狀況：

  1. $ vagrant up
  2. $ vagrant status
  4. Current machine states:
  6. server                    running (virtualbox)
  8. The VM is running. To stop this VM, you can run `vagrant halt` to
  9. shut it down forcefully, or you can run `vagrant suspend` to simply
  10. suspend the virtual machine. In either case, to restart it again,
  11. simply run `vagrant up`.

將虛擬器命名除了方便我們在開發時清楚了解每個虛擬主機的功用，在未來我們也可以直接透過每個主機的別名進行操作。