laravel - 找不到框“laravel/homestead”

Question

我已经从here手动下载了laravel/homestead框。

我成功添加了框：

vagrant box add file:///path/to/the/laravel/homestead.box --name 'laravel/homestead'

但是当我运行 vagrant up时，它会说： Box 'laravel/homestead' could not be found，即使 vagrant box list显示该框。

下载页面说运行 vagrant init laravel/homestead会生成 vagrantfile，但是 laravel/homestead存储库本身会提供 vagrantfile。

我可以使用 vagrant up生成的 vagrantfile进行 vagrant init laravel/homestead，但是它缺少 laravel/homestead存储库的 vagrantfile内部的基本配置。

这是生成的 vagrantfile

# -*- mode: ruby -*-
# vi: set ft=ruby :

# All Vagrant configuration is done below. The "2" in Vagrant.configure
# configures the configuration version (we support older styles for
# backwards compatibility). Please don't change it unless you know what
# you're doing.
Vagrant.configure(2) do |config|
  # The most common configuration options are documented and commented below.
  # For a complete reference, please see the online documentation at
  # https://docs.vagrantup.com.

  # Every Vagrant development environment requires a box. You can search for
  # boxes at https://atlas.hashicorp.com/search.
  config.vm.box = "laravel/homestead"

  # Disable automatic box update checking. If you disable this, then
  # boxes will only be checked for updates when the user runs
  # `vagrant box outdated`. This is not recommended.
  # config.vm.box_check_update = false

  # Create a forwarded port mapping which allows access to a specific port
  # within the machine from a port on the host machine. In the example below,
  # accessing "localhost:8080" will access port 80 on the guest machine.
  # config.vm.network "forwarded_port", guest: 80, host: 8080

  # Create a private network, which allows host-only access to the machine
  # using a specific IP.
  # config.vm.network "private_network", ip: "192.168.33.10"

  # Create a public network, which generally matched to bridged network.
  # Bridged networks make the machine appear as another physical device on
  # your network.
  # config.vm.network "public_network"

  # Share an additional folder to the guest VM. The first argument is
  # the path on the host to the actual folder. The second argument is
  # the path on the guest to mount the folder. And the optional third
  # argument is a set of non-required options.
  # config.vm.synced_folder "../data", "/vagrant_data"

  # Provider-specific configuration so you can fine-tune various
  # backing providers for Vagrant. These expose provider-specific options.
  # Example for VirtualBox:
  #
  # config.vm.provider "virtualbox" do |vb|
  #   # Display the VirtualBox GUI when booting the machine
  #   vb.gui = true
  #
  #   # Customize the amount of memory on the VM:
  #   vb.memory = "1024"
  # end
  #
  # View the documentation for the provider you are using for more
  # information on available options.

  # Define a Vagrant Push strategy for pushing to Atlas. Other push strategies
  # such as FTP and Heroku are also available. See the documentation at
  # https://docs.vagrantup.com/v2/push/atlas.html for more information.
  # config.push.define "atlas" do |push|
  #   push.app = "YOUR_ATLAS_USERNAME/YOUR_APPLICATION_NAME"
  # end

  # Enable provisioning with a shell script. Additional provisioners such as
  # Puppet, Chef, Ansible, Salt, and Docker are also available. Please see the
  # documentation for more information about their specific syntax and use.
  # config.vm.provision "shell", inline: <<-SHELL
  #   sudo apt-get update
  #   sudo apt-get install -y apache2
  # SHELL
end

它具有以下设置：

Vagrant.configure(2) do |config|  
    config.vm.box = "laravel/homestead"
end

我试图将其添加到默认的 laravel/homestead的 vagrantfile中，但是没有用。

require 'json'
require 'yaml'

VAGRANTFILE_API_VERSION = "2"
confDir = $confDir ||= File.expand_path("~/.homestead")

homesteadYamlPath = confDir + "/Homestead.yaml"
homesteadJsonPath = confDir + "/Homestead.json"
afterScriptPath = confDir + "/after.sh"
aliasesPath = confDir + "/aliases"

require File.expand_path(File.dirname(__FILE__) + '/scripts/homestead.rb')

Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
    if File.exists? aliasesPath then
        config.vm.provision "file", source: aliasesPath, destination: "~/.bash_aliases"
    end

    if File.exists? homesteadYamlPath then
        Homestead.configure(config, YAML::load(File.read(homesteadYamlPath)))
    elsif File.exists? homesteadJsonPath then
        Homestead.configure(config, JSON.parse(File.read(homesteadJsonPath)))
    end

    if File.exists? afterScriptPath then
        config.vm.provision "shell", path: afterScriptPath
    end

    ## HERE I added the setting ############################################
    config.vm.box = "laravel/homestead"
    ########################################################################
end

我该怎么办？

Answer 1

laravel/homstead project提供的Vagrantfile比vagrant init生成的通用Vagrantfile更高级

laravel / homstead项目提供的Vagrantfile使用一些ruby代码来帮助建立流浪者环境。从homestead ruby code可以看到，它正在检查您是否有一个版本大于或等于0.4.0的框：

config.vm.box_version = settings["version"] ||= ">= 0.4.0"

当您手动添加该框时，您将看到它在本地计算机上存在：

$ vagrant box list
laravel/homestead               (virtualbox, 0)

但是请注意，提供者旁边的数字为0。该数字是包装盒的版本。由于是手动添加框，因此框元数据不可用，默认情况下，您将获得0版本。

现在，当您执行 vagrant up时，代码将检查是否有> = 0.4.0的框，而您没有该框，这就是为什么得到 Box 'laravel/homestead' could not be found的原因。然后，它将尝试以所需的最低版本下载该框。

为了避免这种情况，您可以在与下载的盒子文件相同的目录中本地创建一个metadata.json文件。例如：

{
    "name": "laravel/homestead",
    "versions": [{
        "version": "0.4.0",
        "providers": [{
            "name": "virtualbox",
            "url": "file:///path/to/homestead.box"
        }]
    }]
}

然后运行 vagrant box add metadata.json

这将安装带有版本的包装盒，可以通过以下方式确认：

$ vagrant box list
laravel/homestead               (virtualbox, 0.4.0)

现在，您将可以使用本地框执行 vagrant up。