Vagrant 手冊之 Vagrantfile - 機器設置 config.vm

原文地址

配置的命名空間：config.vm

config.vm 中的設置修改 Vagrant 管理的機器的配置。

1. 可用的設置項

config.vm.boot_timeout

Vagrant 等待機器啓動並可用的時間，單位是秒。默認是 300 秒。

config.vm.box

這配置了該機器將用哪一個 box 啓動。這裏的值應該是已安裝 box 的名稱或 HashiCorp 的 Vagrant Cloud 中 box 的簡寫名稱。

此選項須要 Vagrant 1.5 及以上版本。能夠從 Vagrant 安裝程序頁面下載最新版本的 Vagrant。

config.vm.box_check_update

若是設爲 true，Vagrant 會在每次執行 vagrant up 時檢查每一個 box 的更新狀況。若是發現更新，Vagrant 會告訴用戶。這個選項默認設爲 true。有支持更新的 box 時才能檢查更新（HashiCorp 的 Vagrant Cloud 或其餘版本控制下的 box）。

config.vm.box_download_checksum

由 config.vm.box_url 指定的 box 的校驗和。若是未指定，則不會執行校驗和比較。若是指定，Vagrant 會將下載 box 的校驗和與這個值進行比較，若是它們不匹配的話報錯。只有當 Vagrant 必須下載該 box 時，纔會檢查校驗和。

若是指定了這個選項，則還必須指定 config.vm.box_download_checksum_type。

config.vm.box_download_checksum_type

由 config.vm.box_download_checksum 指定的校驗和類型。目前支持的類型有「md5」、「sha1」及「sha256」。

config.vm.box_download_client_cert

若是須要，下載 box 時使用的客戶端證書的路徑。默認狀況下，下載 box 時不使用客戶端證書。

config.vm.box_download_ca_cert

直接下載 box 時使用 CA 證書包的路徑。默認狀況下，Vagrant 將使用 Mozilla CA 證書包。

config.vm.box_download_ca_path

包含 CA 證書的目錄的路徑，用於直接下載 box。默認狀況下，Vagrant 將使用 Mozilla CA 證書包。

config.vm.box_download_insecure

若是爲 true，將不會驗證來自服務器的 SSL 證書。默認狀況下，若是 URL 是 HTTPS URL，則 SSL 證書將被驗證。

config.vm.box_download_location_trusted

If true, then all HTTP redirects will be treated as trusted. That means credentials used for initial URL will be used for all subsequent redirects. By default, redirect locations are untrusted so credentials (if specified) used only for initial HTTP request.
若是爲 true，那麼全部 HTTP 重定向將被視爲可信。這意味着用於初始 URL 的憑證將用於全部後續重定向。默認狀況下，重定向位置不受信任，所以憑據（若是指定）僅用於初始 HTTP 請求。

config.vm.box_url

能夠找到配置過的 box 的 URL。若是 config.vm.box 是 HashiCorp 的 Vagrant Cloud 中的 box 的縮寫，則不須要指定該值。不然，它應該指向能夠找到 box 的適當位置。

這也能夠是多個 URL 組成的數組。將按順序嘗試網址。注意，任何客戶端證書、不安全的下載設置等都將應用於此列表中的全部 URL。

經過使用 file://scheme，URL 也能夠是本地文件。例如：「file:///tmp/test.box」。

config.vm.box_version

要使用的 box 的版本。默認爲「>=0」（最新的可用版本）。能夠包含任意約束列表，用逗號分隔，例如 :>=1.0,<1.5。當給出約束時，Vagrant 將使用知足這些約束條件的最新可用 box。

config.vm.communicator

用於鏈接到 guest box 的通訊器類型。默認狀況下是「ssh」，但對於 Windows 虛擬機應更改成「winrm」。

config.vm.graceful_halt_timeout

調用 vagrant halt 時 Vagrant 等待機器正常中止的時間。默認爲 60 秒。

config.vm.guest

將在本機中運行的客戶操做系統。默認爲 linux，Vagrant 會自動檢測正確的發行版。Vagrant 須要知道這些信息才能執行某些客戶操做系統特定的事情，例如掛載目錄和配置網絡。

config.vm.hostname

機器應具備的主機名。默認爲 nil。若是爲 nil，Vagrant 將無論理主機名。若是設置爲字符串，主機名將在引導時設置。

config.vm.network

在機器上配置網絡。參考 這裏。

config.vm.post_up_message

執行 vagrant up 以後顯示給用戶的消息，能夠用於指示如何訪問開發環境的各個組件等。

config.vm.provider

配置 provider 特定的配置，該配置用於修改特定於某個 provider 的設置。若是您正在配置的 provider 不存在或未在運行 Vagrant 的系統上設置，則 Vagrant 將忽略此配置塊。這容許共享一個適用於多個 provider 的 Vagrantfile，即便沒有安裝全部的 provider（至少要安裝 Vagrantfile 要求的一個 provider）。

config.vm.provision

在機器上配置 provisioner，以便在建立機器時自動安裝和配置軟件。請參閱預配置頁面以獲取有關此設置如何工做的更多信息。

config.vm.synced_folder

在機器上配置已同步的目錄，以便主機上的目錄能夠與客戶機同步。

config.vm.usable_port_range

Vagrant 可使用的用來處理端口衝突的一系列端口。默認爲 2200..2250。