Ruby: 開發平台

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

👋 歡迎瀏覽 Stackhero 文件！

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

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

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

享受自動備份、一鍵更新，以及簡單、透明且可預測的收費。

憑藉專屬私有基礎設施，獲得最佳效能及強大安全性。

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

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

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

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

您可以用兩種方式執行 Ruby 專案：在您自己的電腦上建立本地環境，或在 cloud 上使用像 Code-Hero 這類 ready-to-code 服務。每種方式各有優勢，您可以根據自己的工作流程選擇最合適的方案。

本地開發 適合喜歡離線作業的您。所有東西都在您自己的電腦上，但安裝和維護會花較多時間，尤其是對初學者或需要多種工具的情況。您需要自行處理更新、備份和安全性，並受限於電腦的資源。若要從其他裝置存取您的工作，也會較為困難。

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

像 Docker 和 Traefik 這類整合工具，讓您輕鬆使用 TLS 和真實網域（例如 https://your-project.you.your-company.dev）。這種方式與實際生產環境非常接近，方便您測試 webhook（來自 GitHub、Slack、Stripe 等）、處理 CORS，並在無需額外設定下，對接近真實的服務進行開發。

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

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

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

遠端環境可省去手動安裝流程，讓您更快完成首次 commit。Code-Hero 運行於高效能 server，讓您專注於開發功能，而非設定工具。每個專案都會有一個全新、ready-to-code 的 workspace，設定只需數秒。

如果您使用 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 server：

bin/rails server

Ruby on Rails welcome screen

這些步驟會為您的專案建立一個乾淨的起點，而 asdf 可確保您始終使用正確的 Ruby 版本。

預設情況下，Rails 會為您的專案建立一個本地 Git repository，但不會連接到任何遠端 hosting 服務。

為了確保版本控管與備份的可靠性，您可以將 repository 連接到 GitHub、GitLab 或 Bitbucket 等服務。Stackhero 提供 GitLab cloud 服務，於專用基礎設施上運行，讓您在歐洲或美國享有私隱及安全保障。

Code-Hero 專屬設定

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

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

Hosts configurations example

然後啟動 server，綁定所有網絡介面：

bin/rails server -b 0.0.0.0