🚀 はじめに
- 始める前に、システムに 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 の非推奨警告の削除にも役立ちます。🖥️ プロジェクトの準備
Square Cloud でプロジェクトをホストする前に、プロジェクトファイルがホスティング用に適切に設定されているか確認してください。📤 プロジェクトのホスト方法
これで Ruby プロジェクトのすべてのファイルを準備できたので、次のステップはそれらを Square Cloud にアップロードしてアプリケーションをオンラインにすることです。アップロードには複数の方法がありますが、ここでは Dashboard 経由と CLI 経由の 2 つを取り上げます。ダッシュボード経由
アップロードページにアクセス
アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
環境を設定
zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
CLI 経由
この方法を使用するには、プロジェクトのルートディレクトリにsquarecloud.app という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。
詳細はこちら: Square Cloud の設定ファイルの作成方法。
squarecloud.app ファイルはアプリケーションを構成するために使用される設定ファイルであり、環境を定義するために使用されます。
CLI をインストール
まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:すでにお持ちの場合は、更新することを推奨します。更新するには、ターミナルで次のコマンドを実行してください:
- Windows
- Linux, macOS, and WSL
認証
次に、認証して他の CLI コマンドを使用するには、こちらで「Request API Key」をクリックして認証キーを取得します。認証キーを取得したら、次のコマンドを実行してください:


