Ruby: 開發平台

設定您的開發環境，讓工作流程順暢且高效

👋 歡迎來到 Stackhero 文件中心！

Stackhero 提供即時可用的 Ruby cloud 解決方案，帶來多項優勢，包括：

只需一個簡單的 git push，即可在數秒內部署您的應用程式。

可使用您自己的網域名稱，並享有自動設定HTTPS 憑證，提升安全性。

享有自動備份、一鍵更新，以及簡單、透明且可預測的計價。

憑藉專屬私有基礎架構，獲得最佳效能與強大安全性。

節省時間，簡化您的工作流程：只需5 分鐘即可體驗 Stackhero 的 Ruby cloud hosting 解決方案！

一個準備完善的開發平台能讓您的工作更快速、更愉快，也更可靠。

本指南將協助您在本地與遠端開發之間做選擇，帶您安裝 Ruby（使用 asdf），並示範如何啟動一個新的 Ruby 專案。

選擇您的開發環境：本地或遠端

您可以用兩種方式執行 Ruby 專案：在您自己的電腦上建立本地環境，或是在雲端使用像 Code-Hero 這樣的即時開發服務。每種方式都有其優勢，您可以依據自己的工作流程選擇最適合的方案。

本地開發 適合偏好離線作業的您。所有東西都在您自己的電腦上，但安裝與維護會花較多時間，特別是如果您剛開始學習程式設計或需要多種工具時。您需要自行處理更新、備份與安全性，並受限於本機硬體資源。若要從其他裝置存取您的工作，也會較為不便。

遠端開發 使用 Code-Hero 可讓您在幾秒內獲得預先配置好的環境。它內建易用的 Visual Studio Code 分支版本，並支援 Git、Docker、Ruby、Rails 等多種工具。雲端伺服器通常提供比本地電腦更高的 CPU、RAM 與儲存空間。由於一切都在瀏覽器中運作，您可以從任何裝置或作業系統進行開發。

像 Docker 與 Traefik 這類整合工具，讓您輕鬆使用 TLS 與真實網域（例如 https://your-project.you.your-company.dev）。這樣的環境與實際生產環境高度相符，因此您可以測試 webhook（來自 GitHub、Slack、Stripe 等）、處理 CORS，並在不需額外設定的情況下，對接近真實的服務進行開發。

請依據您的工作流程、技能與專案需求選擇合適的方案：

本地開發：
- ✅ 可離線作業：不需網路連線
- ❌ 資源有限：受限於您電腦的效能
- ❌ 手動安裝：需自行安裝與設定各項工具
- ❌ 持續維護：更新與備份需自行負責
遠端開發（於 Code-Hero 上）：
- ✅ 即時可用：所有工具皆已安裝與設定完成
- ✅ 高效能：採用強大且專屬的雲端伺服器
- ✅ 隨時隨地工作：可從任何裝置存取您的開發環境
- ✅ 即時整合：內建 HTTPS 網域，支援 webhook 與第三方服務
- ❌ 需網路連線：必須有網路連接

使用 Ruby 開發：遠端環境設定

遠端環境可省去繁瑣的手動設定，讓您更快完成首次 commit。Code-Hero 採用高效能伺服器，讓您專注於功能開發，而非工具配置。每個專案都能獲得全新、即時可用的工作空間，設定僅需數秒。

如果您使用 Code-Hero，可以直接跳到建立 Ruby 專案。若要進行本地開發，請繼續閱讀下方內容。

使用 Ruby 開發：本地環境設定

本地 Ruby 環境讓您擁有完全的控制權，但需要多幾個步驟。您需自行安裝 Ruby、相依套件與相關工具。

使用 asdf 安裝 Ruby

asdf 是一款彈性的多語言版本管理工具，支援 Ruby、Node.js、Python、PHP 等。它讓您能輕鬆管理不同專案所需的不同版本，避免工具間的衝突。

首先，請依照官方安裝指南安裝 asdf。

安裝完成後，您可以執行下列指令確認 asdf 是否正常運作：

asdf version

若顯示版本號，代表 asdf 已正確安裝。

安裝最新版 Ruby：

asdf plugin add ruby https://github.com/asdf-vm/asdf-ruby.git
asdf install ruby latest
asdf global ruby latest

檢查 Ruby 是否可用：

ruby --version

這表示 Ruby 已經可以開始使用。

建立 Ruby 專案

Ruby 安裝完成後：

asdf install ruby latest \
  && asdf global ruby latest

安裝 Rails：

gem install rails

建立您的應用程式（請將 my_app 替換為您的專案名稱）：

rails new my_app
cd my_app
asdf local ruby latest

啟動 Rails 伺服器：

bin/rails server

Ruby on Rails welcome screen

這些步驟將為您的專案提供乾淨的起點，而 asdf 可確保您始終使用正確的 Ruby 版本。

預設情況下，Rails 會為您的專案建立一個本地 Git 儲存庫，但尚未連接到任何遠端代管服務。

為了確保版本控管與備份的可靠性，您可以將儲存庫連接到 GitHub、GitLab 或 Bitbucket 等服務。Stackhero 提供 GitLab 雲端服務，採用專屬基礎架構，讓您在歐洲或美國享有隱私與安全保障。

Code-Hero 專屬設定

如果您在 Stackhero Code-Hero 上開發，請調整 Rails 設定以支援遠端存取。請開啟 config/environments/development.rb，在最後一個 end 之前加入下列程式碼，並將 <XXXXXX>.stackhero-network.com 替換為您的 Code-Hero 伺服器主機名稱：

config.hosts << "<XXXXXX>.stackhero-network.com"

Hosts configurations example

接著啟動伺服器，並綁定所有網路介面：

bin/rails server -b 0.0.0.0