Vagrant 手冊之 Vagrantfile - 配置版本

原文地址

配置版本是 Vagrant 1.1+（引入了大量新功能和配置選項） 可以與 Vagrant 1.0.x Vagrantfiles 保持向後兼容的機制。

如今運行 vagrant init 時，Vagrantfile 將大體採用如下格式：

Vagrant.configure("2") do |config|
  # ...
end

上面示例中第一行的「2」表明配置對象 config 的版本，該配置將用於該塊的配置（do 和 end 之間的部分）。這個對象在不一樣版本之間可能差別很大。

目前只支持兩個版本：「1」和「2」。版本 1 表明 Vagrant 1.0.x 的配置。「2」表明 1.1+ 至 2.0.x 的配置。

加載 Vagrantfile 時，Vagrant 會爲每一個版本使用正確的配置對象，並正確合併它們，就跟其餘配置同樣。

普通用戶只須要明白一點：在單個配置部分中，只能使用單個版本。不能在版本 1 配置部分中使用新的 config.vm.provider 配置。一樣，config.vm.forward_port 在第 2 版配置部分中不起做用（它已重命名）。

若是你願意，能夠在同一個 Vagrantfile 中混合和匹配多個配置版本。若是你找到一些有用的配置片斷或想要使用的內容時，很是有用。例：

Vagrant.configure("1") do |config|
  # v1 configs...
end

Vagrant.configure("2") do |config|
  # v2 configs...
end

什麼是 Vagrant::Config.run？你能夠在 Vagrantfiles 中看到這個。實際上，這就是在 Vagrant 1.0.x 如何配置的。在 Vagrant 1.1+ 中，這與 Vagrant.configure("1") 是同義的。