🚀 简介
- 开始之前,请确保你的系统已安装 Ruby。如果尚未安装,可以从 Ruby 官方网站下载,或使用 rbenv 或 rvm 等版本管理器。
- 接下来,你需要在 Square Cloud 上创建一个账户,可以通过登录页面完成。你可以使用邮箱、GitHub 或两者结合来创建账户。
- 最后,你的账户需要拥有一个有效的付费套餐。你可以在这里查看我们的套餐并根据需求购买。
⚙️ squarecloud.app 文件配置
如果你通过 Square Cloud 网站上传应用,可以忽略本节内容。网站会自动为你创建
squarecloud.app 配置文件。了解更多:如何为 Square Cloud 创建配置文件。
squarecloud.app 文件是一个配置文件,用于配置你的应用;它用来定义名称、描述、
版本、主文件等内容。
📄 必需文件
- main.rb(主文件示例,即你的 Ruby 入口点)。
- Gemfile(依赖文件,如果使用 Bundler)。
- Gemfile.lock(由 Bundler 生成;建议包含以实现可复现的构建)。
- squarecloud.app(包含 Square Cloud 配置的文件)。
▶️ 如何启动你的应用
- 如果配置文件中未定义
START字段,Square Cloud 将执行ruby MAIN,其中MAIN指定的文件即为 Ruby 文件(例如main.rb)。如果定义了START字段,则会直接执行其中的值。在使用 Bundler 的应用中,通常将START定义为bundle exec ruby main.rb或其他合适的启动命令。有关配置文件参数的更多信息,请访问配置参数。
对于使用 Bundler 的 Ruby 应用,正确配置环境变量以优化在 Square Cloud 上的依赖安装过程非常重要。Square Cloud 使用环境变量来运行 bundler 安装。要在生产环境中排除不必要的 gem 分组,请配置变量
BUNDLE_WITHOUT=development:test。这也有助于移除 Bundler 2.x 的弃用警告(deprecations)。🖥️ 准备项目
在将项目托管到 Square Cloud 之前,请检查项目文件是否已正确配置以便托管。📤 如何托管你的项目
现在你已经为 Ruby 项目准备好了所有文件,下一步就是将它们上传到 Square Cloud 并让你的应用上线。上传方式有多种,但我们将介绍两种:通过 Dashboard 或通过 CLI。通过控制面板
访问上传页面
访问上传页面并上传你的项目 zip 文件。
通过 CLI
要使用此方法,你需要在项目根目录中创建一个名为squarecloud.app 的配置文件。该文件将包含项目所需的配置。
了解更多:如何为 Square Cloud 创建配置文件。
squarecloud.app 文件是一个配置文件,用于配置你的应用;它将用于定义你的环境。
安装 CLI
首先,你的环境中需要已安装 CLI。如果尚未安装,请在终端中运行以下命令:如果你已经安装,我们建议对其进行更新。为此,请在终端中运行以下命令:
- Windows
- Linux、macOS 和 WSL
进行身份验证
现在,要进行身份验证并使用其他 CLI 命令,你可以在此处点击 “Request API Key” 找到你的授权密钥。获取授权密钥后,运行以下命令:


