使用 Vagrant 打造跨平臺開發環境

Vagrant 是一款用來構建虛擬開發環境的工具，很是適合 php/python/ruby/java 這類語言開發 web 應用，「代碼在我機子上運行沒有問題」這種說辭將成爲歷史。

咱們能夠經過 Vagrant 封裝一個 Linux 的開發環境，分發給團隊成員。成員能夠在本身喜歡的桌面系統（Mac/Windows/Linux）上開發程序，代碼卻能統一在封裝好的環境裏運行，很是霸氣。

安裝步驟

1. 安裝 VirtualBox

虛擬機仍是得依靠 VirtualBox 來搭建，免費小巧。
下載地址：https://www.virtualbox.org/wi...

提示：雖然 Vagrant 也支持 VMware，不過 VMware 是收費的，對應的 Vagrant 版本也是收費的

2. 安裝 Vagrant 並添加鏡像

下載地址：https://www.vagrantup.com/dow... 根據提示一步步安裝。

裝好之後運行 vagrant box add hashicorp/precise64 添加 Vagrant 官方的 box 鏡像。這時將從官網下載名爲 hashicorp/precise64 的 box，可能須要等待一段時間。

若是你要其餘系統的鏡像，能夠來這裏查詢下載：https://atlas.hashicorp.com/b...

提示：若是你由於網絡緣由添加不了上面的鏡像，能夠用工具將這些 box 下載下來（下載地址），參照後文的「打包分發」部分進行添加。

3. 初始化開發環境

建立一個開發目錄（好比：~/dev），你也可使用已有的目錄，切換到開發目錄裏，用 hashicorp/precise64 鏡像初始化當前目錄的環境：

$ cd ~/dev  # 切換目錄
$ vagrant init hashicorp/precise64  # 用 hashicorp/precise64 進行 box 初始化
$ vagrant up  # 啓動環境

你會看到終端顯示了啓動過程，啓動完成後，咱們就能夠用 SSH 登陸虛擬機了，剩下的步驟就是在虛擬機裏配置你要運行的各類環境和參數了。

$ vagrant ssh  # SSH 登陸
$ cd /vagrant  # 切換到開發目錄，也就是宿主機上的 `~/dev`

~/dev 目錄對應虛擬機中的目錄是 /vagrant

Windows 用戶注意：Windows 終端並不支持 ssh，因此須要安裝第三方 SSH 客戶端，好比：Putty、Cygwin 等。

其餘設置

Vagrant 初始化成功後，會在初始化的目錄裏生成一個 Vagrantfile 的配置文件，能夠修改配置文件進行個性化的定製。

Vagrant 默認是使用端口映射方式將虛擬機的端口映射本地從而實現相似 http://localhost:80 這種訪問方式，這種方式比較麻煩，新開和修改端口的時候都得編輯。相比較而言，host-only 模式顯得方便多了。打開 Vagrantfile，將下面這行的註釋去掉（移除 #）並保存：

config.vm.network :private_network, ip: "192.168.33.10"

重啓虛擬機，這樣咱們就能用 192.168.33.10 訪問這臺機器了，你能夠把 IP 改爲其餘地址，只要不產生衝突就行。

打包分發

當你配置好開發環境後，退出並關閉虛擬機。在終端裏對開發環境進行打包：

$ vagrant package

打包完成後會在當前目錄生成一個 package.box 的文件，將這個文件傳給其餘用戶，其餘用戶只要添加這個 box 並用其初始化本身的開發目錄就能獲得一個如出一轍的開發環境了。

添加方法：

假設咱們拿到的 box 存放路徑是 ~/box/package.box，在終端裏輸入：

$ vagrant box add hahaha ~/box/package.box  # 添加 package.box 鏡像並命名爲 hahaha
$ cd ~/dev  # 切換到項目目錄
$ vagrant init hahaha  # 用 hahaha 鏡像初始化。

集成預安裝

從上面這條看下來，你會發現每次都修改了一點點內容，再打包分發給其餘用戶其實很麻煩。爲此 Vagrant 還提供了更爲便捷的預安裝定製。打開 Vagrantfile 文件末尾處有下面被註釋的代碼：

config.vm.provision "shell", inline: <<-SHELL
   apt-get update
   apt-get install -y apache2
SHELL

沒錯，這段代碼就是讓你在初次運行 vagrant up 後，虛擬機建立過程衆自動運行的初始化命令。 取消註釋，把要預先安裝的 php/mysql/redis 和配置之類的統統都寫進去。初始化時這些程序都會根據你寫好的方法安裝並配置。

若是你不是初次運行，同時又修改了這裏的命令，想讓系統再次運行這裏面的命令，你可使用 vagrant reload --provision 進行重載。因此在這種狀況下，你只要將 Vagrantfile 共享給團隊的其餘成員就能夠了，其餘成員運行相同的命令便可，是否是比打包分發要方便許多。

你還能夠把要運行的命令單獨寫在一個文件裏存放在相同的目錄下，好比 bootstrap.sh：

#!/usr/bin/env bash

apt-get update
apt-get install -y apache2
if ! [ -L /var/www ]; then
  rm -rf /var/www
  ln -fs /vagrant /var/www
fi

而後在 Vagrantfile 裏這樣添加：

Vagrant.configure("2") do |config|
  config.vm.box = "hashicorp/precise64"
  ...

  config.vm.provision "shell", path: "bootstrap.sh"  # 添加這行
end

效果和直接寫在 Vagrantfile 是同樣的。

經常使用命令

$ vagrant init  # 初始化
$ vagrant up  # 啓動虛擬機
$ vagrant halt  # 關閉虛擬機
$ vagrant reload  # 重啓虛擬機
$ vagrant ssh  # SSH 至虛擬機
$ vagrant status  # 查看虛擬機運行狀態
$ vagrant destroy  # 銷燬當前虛擬機

更多內容請查閱官方文檔 https://www.vagrantup.com/doc...

注意事項

使用 Apache/Nginx 時會出現諸如圖片修改後但頁面刷新仍然是舊文件的狀況，是因爲 VirtualBox 的一個 BUG 形成的。須要對虛擬機裏的 Apache/Nginx 配置文件進行修改：

# Apache 配置（httpd.conf 或者 apache.conf）修改：
EnableSendfile off

# Nginx 配置（nginx.conf）修改：
sendfile off;

---

SegmentFault 團隊早期就是用這種方式統一開發環境的。
本篇文章所用程序版本 VirtualBox 5.0.*，Vagrant 1.8.*

這有一份個人配置示例，供參考 https://github.com/fenbox/Vag...
若是你有任何疑問，能夠在 vagrant 標籤下提問：https://segmentfault.com/t/va...

延伸閱讀：

• 《Go 語言開發環境配置》 by @Asta謝
• Vagrant 啓動失敗，停留在 Waiting for VM to boot 的解決方法
• 開啓 NFS 文件系統提高 Vagrant 共享目錄的性能
• 給 Vagrant 換用 VMware 或 Parallels 虛擬機