Ruby: 开发平台

配置您的开发环境，实现高效流畅的工作流程

👋 欢迎查阅 Stackhero 文档！

Stackhero 提供即开即用的 Ruby cloud 解决方案，带来诸多优势，包括：

只需一次简单的 git push，即可在几秒钟内部署您的应用。

支持自定义域名，并自动配置 HTTPS 证书，提升安全性。

享受自动备份、一键更新，以及简单、透明、可预测的定价。

依托专属私有基础设施，实现卓越的性能与强大的安全性。

节省时间，简化流程：仅需5分钟即可体验 Stackhero 的 Ruby cloud hosting 解决方案！

一个准备充分的开发平台能够让您的工作更高效、更愉快、更可靠。

本指南将帮助您在本地和远程开发之间做出选择，指导您使用 asdf 安装 Ruby，并演示如何启动一个新的 Ruby 项目。

选择您的开发环境：本地还是远程

您可以通过两种方式运行 Ruby 项目：在本地计算机上搭建环境，或在云端使用像 Code-Hero 这样的即用型开发服务。每种方式各有优势，您可以根据自己的工作流程选择最合适的方案。

本地开发 适合喜欢离线工作的用户。所有内容都在您自己的电脑上，但环境搭建和维护需要更多时间，尤其是对于编程新手或需要多种工具的场景。您需要自行管理更新、备份和安全性，并且受限于本机的硬件资源。从其他设备访问您的工作内容也会有一定难度。

远程开发 通过 Code-Hero 提供预配置环境，几秒钟即可就绪。它内置易用的 Visual Studio Code 分支版本，并原生支持 Git、Docker、Ruby、Rails 等多种工具。云服务器通常比本地机器拥有更强的 CPU、内存和存储资源。由于一切都在浏览器中运行，您可以在任何设备或操作系统上访问和开发。

集成的 Docker 和 Traefik 等工具让您轻松使用 TLS 和真实域名（如 https://your-project.you.your-company.dev）。这高度还原了真实生产环境，便于测试 Webhook（来自 GitHub、Slack、Stripe 等）、处理 CORS，并在无需额外配置的情况下对接真实服务进行开发。

请根据您的工作流程、技能和项目需求选择合适的方案：

本地开发：
- ✅ 支持离线：无需网络即可工作
- ❌ 资源有限：受限于本机性能
- ❌ 手动配置：需要自行安装和配置工具
- ❌ 持续维护：更新和备份需自行负责
远程开发（基于 Code-Hero）：
- ✅ 即刻可用：所有工具已安装并配置好
- ✅ 高性能：使用强大的专用云服务器
- ✅ 随时随地：可从任意设备访问开发环境
- ✅ 实时集成：内置 HTTPS 域名，支持 Webhook 和第三方服务
- ❌ 需要网络：必须保持网络连接

Ruby 开发：远程环境配置

远程开发环境无需手动配置，大大加快您的首次提交速度。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