閱讀本指南的最佳方式是一步一步地跟隨。所有步驟對於執行此範例應用程式都是必要的,不需要額外的程式碼或步驟。
本指南可協助您設定 開發容器(簡稱開發容器),以建立完整功能的開發環境。開發容器用於在容器中執行您的 Rails 應用程式,而無需直接在您的機器上安裝 Ruby 或 Rails 或其相依性。這是讓您的 Rails 應用程式快速啟動並執行的最快方式。
這是直接在您的機器上安裝 Ruby 和 Rails 的替代方案,此方法在入門指南中說明。完成本指南後,您可以繼續按照入門指南建立您的應用程式。
1 設定與安裝
要進行設定,您需要安裝相關工具:Docker、VS Code 和 rails-new
。我們將在下面詳細介紹每個工具。
1.1 安裝 Docker
開發容器使用 Docker 執行,Docker 是一個用於開發、發布和執行應用程式的開放平台。您可以按照Docker 文件中適用於您作業系統的安裝指示來安裝 Docker。
安裝 Docker 後,啟動 Docker 應用程式以開始在您的機器上執行 Docker 引擎。
1.2 安裝 VS Code
Visual Studio Code (VS Code) 是由 Microsoft 開發的開放原始碼程式碼編輯器。VS Code 的開發容器擴充功能可讓您在容器內部(或掛載到容器中)開啟任何資料夾,並充分利用 Visual Studio Code 的完整功能集。專案中的 devcontainer.json 檔案會告訴 VS Code 如何存取(或建立)具有明確工具和執行階段堆疊的開發容器。它允許您快速啟動容器、存取終端機命令、除錯程式碼以及使用擴充功能。
您可以從網站下載 VS Code 來安裝。
您可以從市集下載開發容器擴充功能來安裝。
1.3 安裝 rails-new
rails-new
會為您產生新的 Rails 應用程式,而無需在您的機器上安裝 Ruby。它使用 Docker 來產生 Rails 應用程式,因此允許 Docker 為您處理安裝正確的 Ruby 和 Rails 版本。
若要安裝 rails-new
,請依照 README 中的安裝指示進行。
2 建立 Blog 應用程式
Rails 隨附許多稱為產生器的腳本,旨在透過建立開始處理特定任務所需的一切,讓您的開發生活更輕鬆。其中之一是新的應用程式產生器,它將為您提供新的 Rails 應用程式的基礎,因此您不必自己編寫它。rails-new
工具使用此產生器為您建立新的 Rails 應用程式。
以下範例使用 $
來表示類 UNIX 作業系統中的終端機提示字元,儘管它可能已被自訂為以不同的方式顯示。
若要使用 rails-new
產生您的應用程式,請開啟終端機,導覽至您有權建立檔案的目錄,然後執行
$ rails-new blog --devcontainer
這將在 blog
目錄中建立一個名為 Blog 的 Rails 應用程式。
您可以透過執行 rails-new --help
來查看 Rails 應用程式產生器接受的所有命令列選項。
建立 blog 應用程式後,切換到其資料夾
$ cd blog
blog
目錄將包含許多已產生的檔案和資料夾,這些檔案和資料夾構成 Rails 應用程式的結構。本教學課程中的大部分工作將在 app
資料夾中進行。如需應用程式中所有內容的完整概述,請參閱完整的入門指南。
3 在開發容器中開啟 Blog 應用程式
我們新的 Rails 應用程式已預先設定並可供使用開發容器。我們將使用 VS Code 來啟動並使用我們的開發容器。首先啟動 VS Code 並開啟您的應用程式。
應用程式開啟後,VS Code 應提示您它已找到開發容器設定檔,您可以重新在開發容器中開啟資料夾。按一下綠色的「在容器中重新開啟」按鈕來建立開發容器。
開發容器設定完成後,您的開發環境即可使用,其中已安裝 Ruby、Rails 和所有相依性。
您可以開啟 VS Code 內的終端機來驗證是否已安裝 Rails
$ rails --version
Rails 8.0.0
現在您可以繼續使用入門指南並開始建立您的 Blog 應用程式。您將在 VS Code 中工作,VS Code 會作為您應用程式開發容器的入口點,您可以在其中執行程式碼、執行測試以及執行您的應用程式。