阅读本指南的最佳方式是按步骤操作。所有步骤对于运行此示例应用程序都至关重要,无需额外的代码或步骤。
本指南帮助您为开发容器(简称 dev container)设置一个功能完善的开发环境。Dev container 用于在容器中运行您的 Rails 应用程序,而无需直接在您的机器上安装 Ruby、Rails 或其依赖项。这是最快启动和运行 Rails 应用程序的方式。
这是直接在您的机器上安装 Ruby 和 Rails 的替代方法,后者在入门指南中介绍。完成本指南后,您可以按照入门指南继续构建您的应用程序。
1. 设置和安装
为了进行设置,您需要安装相关工具:Docker、VS Code 和 rails-new。我们将在下面详细介绍每个工具。
1.1. 安装 Docker
Dev container 使用 Docker 运行,Docker 是一个用于开发、发布和运行应用程序的开放平台。您可以按照 Docker 文档中适用于您操作系统的安装说明安装 Docker。
安装 Docker 后,启动 Docker 应用程序以在您的机器上运行 Docker 引擎。
1.2. 安装 VS Code
Visual Studio Code (VS Code) 是微软开发的一款开源代码编辑器。VS Code 的 Dev Containers 扩展允许您在容器内部(或挂载到容器中)打开任何文件夹,并充分利用 Visual Studio Code 的全部功能。devcontainer.json 文件在您的项目中告诉 VS Code 如何访问(或创建)一个具有良好定义的工具和运行时堆栈的开发容器。它允许您快速启动容器、访问终端命令、调试代码和使用扩展。
您可以从网站下载并安装 VS Code。
您可以从 marketplace 下载并安装 Dev Containers 扩展。
1.3. 安装 rails-new
rails-new 为您生成一个新的 Rails 应用程序,而无需在您的机器上安装 Ruby。它使用 Docker 来生成 Rails 应用程序,从而让 Docker 为您处理安装正确的 Ruby 和 Rails 版本。
要安装 rails-new,请遵循 README 中的安装说明。
2. 创建 Store 应用程序
Rails 附带了许多名为生成器的脚本,这些脚本旨在通过创建开始处理特定任务所需的一切来简化您的开发工作。其中之一是新应用程序生成器,它将为您提供全新 Rails 应用程序的基础,这样您就不必自己编写。rails-new 工具使用此生成器为您创建一个新的 Rails 应用程序。
下面的示例使用 $ 表示 UNIX 类操作系统中的终端提示,尽管它可能已自定义为以不同的方式显示。
要使用 rails-new 生成您的应用程序,请打开终端,导航到您有权创建文件的目录,然后运行
$ rails-new store --devcontainer
这将在 store 目录中创建一个名为 Store 的 Rails 应用程序。
您可以通过运行 rails-new --help 查看 Rails 应用程序生成器接受的所有命令行选项。
创建 store 应用程序后,切换到其文件夹
$ cd store
store 目录将包含许多生成的构成 Rails 应用程序结构的文件和文件夹。本教程中的大部分工作都将在 app 文件夹中进行。有关应用程序中所有内容的完整说明,请参阅完整的入门指南。
3. 在 Dev Container 中打开 Store 应用程序
我们的新 Rails 应用程序附带了已配置并可供使用的 dev container。我们将使用 VS Code 启动并使用我们的 dev container。首先启动 VS Code 并打开您的应用程序。
应用程序打开后,VS Code 应该会提示您它找到了 dev container 配置文件,并且您可以重新在 dev container 中打开文件夹。单击绿色的“在容器中重新打开”按钮以创建 dev container。
一旦 dev container 设置完成,您的开发环境就可以使用了,其中安装了 Ruby、Rails 和您的所有依赖项。
您可以在 VS Code 中打开终端以验证 Rails 是否已安装
$ rails --version
Rails 8.1.0
您现在可以继续入门指南并开始构建您的 Store 应用程序。您将在 VS Code 中工作,它作为您应用程序 dev container 的入口点,您可以在其中运行代码、运行测试和运行您的应用程序。