RubyMine 2025.2 Help

Vagrant

Vagrant 是一个用于构建和管理由 Vagrantfile 配置文件定义的虚拟机环境的工具。 RubyMine 提供了与 Vagrant 的集成,允许您在项目中执行所有必要的操作——从初始化 Vagrant 环境到执行 Vagrant 命令。 此外,RubyMine 允许您将正在运行的虚拟机用作远程解释器。 这意味着您可以直接从 IDE 中在隔离环境中运行、调试和测试您的应用程序。

在本主题中,我们将介绍 RubyMine 中可用的主要 Vagrant 功能:配置 Vagrant、添加和删除盒子、运行 Vagrant 命令。 我们还将展示如何通过配置远程解释器,在虚拟机中运行 示例 Rails 应用程序

先决条件

要开始使用 Vagrant,请执行以下操作。

Vagrant init

要为打开的项目初始化 Vagrant 环境,请按照以下步骤操作。

  1. 转到 工具 | Vagrant | 在项目根目录初始化

  2. 在弹出的对话框中,指定盒子名称和 URL,例如:

    • Box 名称ubuntu/bionic64

    • Box URL https://app.vagrantup.com/ubuntu/boxes/bionic64

    如果您已经有多个 Vagrant 盒子,请在弹出的 选择 Vagrant Box 弹窗中选择所需的一个。

  3. 等待 RubyMine 下载指定的盒子并初始化 Vagrantfile

  4. 以以下方式更改 Vagrantfile

    Vagrant.configure("2") do |config| config.vm.box = "ubuntu/bionic64" config.vm.synced_folder ".", "/home/vagrant/sample_rails_app" config.vm.network "forwarded_port", guest: 3000, host: 3000 end

    此配置中指定了以下设置:

    • box :指定用于运行虚拟机的盒子。

    • synced_folder :配置一个 虚拟机文件夹 ,以共享您的本地项目目录。

    • network :指定用于将虚拟机连接到网络的选项。 在此,我们已配置虚拟机上的 端口 ,通过主机上的端口共享。

Vagrant up

初始化 Vagrant 环境 后,您可以基于 Vagrantfile 设置创建并运行虚拟机。

  1. 转到 工具 | Vagrant | 启动

  2. (可选)选择项目的 Vagrantfile

  3. 如果在您的 Vagrantfile 中定义了 多个机器 ,请选择所需的机器。

    选择虚拟机配置
  4. 等待 RubyMine 创建并运行该机器。

    运行工具窗口:vagrant up

    现在,您可以使用 SSH 连接到此机器,以安装其他库、运行应用程序等。 此外,您可以将此机器配置为 远程解释器 ,以便直接从 IDE 中在隔离环境中运行、调试和测试您的应用程序。

SSH 进入正在运行的机器

要连接到 正在运行的虚拟机 ,请按照以下步骤操作。

  1. 转到 工具 | 启动 SSH 会话

  2. 在弹出的弹窗中,选择所需的 Vagrant 主机。

    选择要连接的主机
  3. (可选)如果 多台机器 正在运行,请选择所需的一台。

    选择 Vagrant 机器
  4. 在打开的 127.0.0.1 标签页的 终端 窗口中,您可以执行 shell 命令,例如安装其他库、运行应用程序等。

    SSH 终端会话

将 Vagrant 添加为远程解释器

RubyMine 允许您将安装了 Ruby 的 正在运行的虚拟机 用作远程解释器。 这意味着您可以直接从 IDE 中 运行调试测试您的应用程序。 请按照以下步骤操作。

  1. 打开 设置 对话框 Ctrl+Alt+S ,转到 语言与框架 | Ruby 解释器 页面。

  2. 单击 添加图标 并在下拉菜单中选择 远程解释器或版本管理器

    rm_add_remote_ruby_interpreter.png
  3. 在弹出的对话框中,选择 Vagrant

    rm_remote_sdk_vagrant.png

    如果项目根文件夹包含一个指向正在运行的虚拟机的 Vagrantfile ,RubyMine 会自动检测到 Vagrant 实例文件夹 并显示用于访问虚拟机的 Vagrant 主机 URL。 如有必要,您可以 更改Vagrant 实例文件夹 以使用其他虚拟机。

    Ruby 或版本管理器路径 中,指定 Ruby 解释器或 版本管理器 可执行文件的路径。 点击 确定

  4. (可选) 如果您在上一步中指定了版本管理器可执行文件的路径,RubyMine 会建议选择用于运行远程应用程序的 Ruby 解释器。

    rm_remote_attach_select_distribution.png
  5. Ruby 解释器 页面中选择添加的解释器并单击 确定

    Ruby 解释器页面:Vagrant

    等待 RubyMine 从远程机器下载 gems 到本地缓存。 这是为了 索引 所必需的。

  6. (可选) 如果您希望使用添加的解释器调试 远程进程 ,请指定本地和远程项目文件之间的映射。 为此,请单击 编辑路径映射 按钮。 在 编辑项目路径映射 对话框中,指定本地和远程项目根路径。

    编辑项目路径映射

    RubyMine 会检测到 Vagrant 的 同步文件夹 并自动添加相应的映射。

在您将 Vagrant 配置为远程解释器后,您可以:

Vagrant 设置

您可以在 工具 | Vagrant 页面上的 设置 对话框 Ctrl+Alt+S 中配置以下 Vagrant 设置:

Vagrant 可执行文件

如果 RubyMine 未自动检测到 Vagrant 可执行文件,或者您希望使用其他文件,请指定该文件。

示例vagrant

实例文件夹

指定 Vagrantfile 所在目录的完整路径,并已 初始化 和存储。 默认情况下,RubyMine 使用当前项目的根目录来执行 Vagrant 命令。 此目录用于执行 Vagrant 命令,例如 vagrant up 、vagrant reload、vagrant halt 等。

示例 /Users/jetbrains/RubymineProjects/sample_rails_app

提供程序

选择用于作为后端运行虚拟机的 提供程序。 您可以在 插件选项卡 中将所需的提供程序安装为 Vagrant 插件。

示例awslibvirt

环境变量

环境变量使您能够传递配置 提供程序 所需的值。 要指定环境变量,请单击 浏览 按钮(Shift+Enter)。 例如, vagrant-aws 提供程序允许您使用 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY 环境变量传递您的 AWS 凭据。 在实例化 AWS 实例时,您可以在 Vagrantfile 中读取变量值。

config.vm.provider 'aws' do |aws| aws.access_key_id = ENV['AWS_ACCESS_KEY_ID'] aws.secret_access_key = ENV['AWS_SECRET_ACCESS_KEY'] # ... end
盒子

此列表显示了可用的 Vagrant 盒子。 要添加新盒子,请单击 Add 按钮 Alt+Insert 并指定盒子名称和 URL。 例如:

  • Box 名称ubuntu/bionic64

  • Box URLhttps://app.vagrantup.com/ubuntu/boxes/bionic64

要移除选定的盒子,请单击 "移除"按钮 按钮 Alt+Delete

Plugins

使用此表格添加、移除和更新 Vagrant 插件。 例如,要安装 vagrant-aws 插件,请单击 Add 按钮 Alt+Insert ,在弹出的对话框中输入 vagrant-aws 并单击 确定

最后修改日期: 2025年 9月 26日