在 Windows 上安裝 Vagrant 軟體

在 Windows 上，如果想使用 Vagrant 的話，需依序安裝以下軟體：

  1. VirtualBox 及 VirtualBox Extension Pack
  2. Vagrant
  3. 純命令列的 ssh 程式

以下分別介紹各軟體的安裝方法，以及可能的問題排除方法。

【補充】Vagrant 1.8 新增一個功能：如果你沒有安裝過 VirtualBox（或其他可與 Vagrant 搭配的虛擬機軟體），那麼，在第一次執行 vagrant up 時，Vagrant 會設法自動幫你下載、安裝某個版本的 VirtualBox。這功能看似方便，但經我初步實測，很容易有莫名其妙的問題。所以，我仍然建議你親自安裝 VirtualBox，不要仰賴這項功能。


1. 安裝 VirtualBox 及配套軟體

去 VirtualBox 官網的下載頁，下載兩個安裝檔，ㄅ依序安裝之：

  • VirtualBox platform packages ☛ 請選擇 Windows 版
  • VirtualBox Extension Pack

注意！這兩個安裝檔的「版本編號」必須一模一樣。

以下圖為例，我們選的是 5.0.10 版：



2. 安裝 Vagrant 軟體

去 Vagrant 官網的下載頁，下載 Windows 版的安裝檔，執行之。


3. 純命令列的 ssh 程式

為了 Vagrant 運作順暢，你還需要一個「純命令列的 ssh 程式」（像 PuTTY、PieTTY 或可攜版之類的 GUI 程式，可能會在某些進階步驟踩到地雷；非 power user 請勿嘗試）。

我建議您安裝以下這個「純命令列的 ssh 程式」：

過程中，大部分都可以直接套用預設值，只有以下這地方建議修改：

安裝後，記得要試一試 ssh.exe 是否已在 PATH 裡；若否，請去【控制台】把 ssh.exe 所在路徑加到 PATH 環境變數。


問題排除

安裝或執行 VirtualBox 之前，請先關閉其他可能相衝的虛擬機軟體（VMware、Hyper-V 等）。虛擬機也會消耗比較多的主機資源，所以，請關閉其他不相干的軟體，並盡量挪出 2 GB 以上的可用記憶體。


在 Windows 上，下載 VirtualBox 兩個安裝檔時，最好先置於「完全由英文字或阿拉伯數字所組成的路徑」上，再執行安裝程序，比較不會出現奇奇怪怪的亂碼問題。


安裝 VirtualBox 時，如果遇到以下錯誤：

請先切換到放置下載檔案的目錄，找出剛剛下載回來的安裝檔名（以 5.0.10 版為例，檔名為 VirtualBox-5.0.10-104061-Win.exe），再依序執行以下命令： 

VirtualBox-5.0.10-104061-Win  -extract
cd VirtualBox
dir

你應該會看到一個 msi 類型的安裝檔，請執行它。


安裝 VirtualBox Extension Pack 時，如果遇到 “The installer failed with exit code: 1” 錯誤，請先切換到放置下載檔案的目錄，找出剛剛下載回來的安裝檔名（以 5.0.10 版為例，檔名為 Oracle_VM_VirtualBox_Extension_Pack-5.0.10-104061.vbox-extpack ），再依序執行以下命令： 

VBoxManage extpack uninstall "Oracle VM VirtualBox Extension Pack"
VBoxManage extpack cleanup
VBoxManage extpack install --replace  Oracle_VM_VirtualBox_Extension_Pack-5.0.10-104061.vbox-extpack


在執行 vagrant up 命令時，如果常會出現 "default: Error: Connection timeout. Retrying..." 錯誤訊息，請參考以下這則文章的解法： http://stackoverflow.com/a/22575302


進階：更好的命令列

在 Windows 下，通常我們還會再搭配好用的命令列環境（像 ssh、git、命令提示字元／終端機等小工具）。對此感興趣的人，請參考黃保翕 (Will 保哥) 推薦的 Cmder 軟體：


怎麼知道我已經安裝完畢了？

會在接下來的單元介紹。

Complete and Continue  
Discussion

0 comments