更多内容请访问 rubyonrails.org:

Dev Containers 入门

阅读完本指南后,您将了解

  • 如何使用 rails-new 工具创建新的 Rails 应用程序。
  • 如何在开发容器中开始使用您的应用程序。

阅读本指南的最佳方式是按步骤进行。所有步骤对于运行此示例应用程序都是必不可少的,不需要额外的代码或步骤。

本指南帮助您使用 开发容器(简称 dev 容器) 设置功能齐全的开发环境。Dev 容器用于在容器中运行您的 Rails 应用程序,而无需直接在您的机器上安装 Ruby 或 Rails 或其依赖项。这是让 Rails 应用程序快速运行的最便捷方法。

这是直接在您的机器上安装 Ruby 和 Rails 的替代方法,在 入门指南 中有介绍。完成本指南后,您可以继续按照入门指南构建您的应用程序。

1 设置和安装

要进行设置,您需要安装相关工具;Docker、VS Code 和 rails-new。我们将详细介绍以下内容。

1.1 安装 Docker

Dev 容器使用 Docker 运行,Docker 是一个用于开发、发布和运行应用程序的开放平台。您可以按照 Docker 文档 中针对您操作系统的安装说明安装 Docker。

安装 Docker 后,启动 Docker 应用程序以在您的机器上开始运行 Docker 引擎。

1.2 安装 VS Code

Visual Studio Code (VS Code) 是一款由 Microsoft 开发的开源代码编辑器。VS Code 的 Dev Containers 扩展允许您在容器内部(或安装到容器中)打开任何文件夹,并利用 Visual Studio Code 的全部功能集。您的项目中的 devcontainer.json 文件告诉 VS Code 如何访问(或创建)具有明确定义的工具和运行时堆栈的开发容器。它允许您快速启动容器,访问终端命令,调试代码并使用扩展。

您可以从 网站 下载 VS Code 进行安装。

您可以从 市场 下载 Dev Containers 扩展进行安装。

1.3 安装 rails-new

rails-new 为您生成一个新的 Rails 应用程序,而无需在您的机器上安装 Ruby。它使用 Docker 生成 Rails 应用程序,从而允许 Docker 为您安装正确的 Ruby 和 Rails 版本。

要安装 rails-new,请按照 README 中的安装说明 进行操作。

2 创建博客应用程序

Rails 附带了许多称为生成器的脚本,旨在通过创建开始特定任务所需的一切来使您的开发生活更轻松。其中一个是新的应用程序生成器,它将为您提供一个全新的 Rails 应用程序的基础,这样您就不必自己编写。rails-new 工具使用此生成器为您创建一个新的 Rails 应用程序。

以下示例使用 $ 代表 UNIX 类操作系统中的终端提示符,尽管它可能已被自定义为显示不同的外观。

要使用 rails-new 生成您的应用程序,请打开一个终端,导航到您有权创建文件的目录,然后运行

$ rails-new blog --devcontainer

这将在 blog 目录中创建一个名为 Blog 的 Rails 应用程序。

您可以通过运行 rails-new --help 查看 Rails 应用程序生成器接受的所有命令行选项。

创建博客应用程序后,切换到其文件夹

$ cd blog

blog 目录将包含许多生成的文件和文件夹,这些文件和文件夹构成了 Rails 应用程序的结构。本教程中的大部分工作将在 app 文件夹中进行。有关应用程序中所有内容的完整说明,请参阅完整的 入门指南

3 在 Dev Container 中打开博客应用程序

我们的新 Rails 应用程序附带了一个已经配置好并可以使用的 dev 容器。我们将使用 VS Code 启动并使用我们的 dev 容器。首先启动 VS Code 并打开您的应用程序。

应用程序打开后,VS Code 应该提示您它已找到 dev 容器配置文件,您可以重新在 dev 容器中打开文件夹。单击绿色“在容器中重新打开”按钮以创建 dev 容器。

Dev 容器设置完成后,您的开发环境就可以使用了,其中包括已安装的 Ruby、Rails 和所有依赖项。

您可以在 VS Code 中打开终端以验证 Rails 是否已安装

$ rails --version
Rails 8.0.0

现在您可以继续使用 入门指南 并开始构建您的 Blog 应用程序。您将在 VS Code 中工作,VS Code 作为您应用程序的 dev 容器的入口点,您可以在其中运行代码、运行测试以及运行应用程序。



返回顶部