設定ファイルとは?
設定ファイルは、メインファイル、メモリ、バージョンなどのアプリケーションのパラメータを含むファイルです。このファイルは、Square Cloud プラットフォーム上でアプリケーションを設定してデプロイするために使用されます。squarecloud.app
設定ファイルの作成
設定ファイルの作成はとても簡単です。squarecloud.app または squarecloud.config という名前のファイルを作成し、その中に設定パラメータを追加するだけです。
拡張子を選ぶ
設定ファイルには 2 つの拡張子を使用できます。.app または .config です。
squarecloud.app または squarecloud.config のどちらでもお好みのものを使用できます。ヒント: Square Cloud を広めるために .app を使いましょう。🥰😂
macOS では、.config 拡張子の使用をおすすめします。
設定パラメータ
以下に、設定ファイルで利用可能なすべての設定パラメータを示します。| パラメータ | 型 | 編集可否 | 制限 | 用途 |
|---|---|---|---|---|
MAIN* | String | ❌ | 32 文字 | アプリケーションのメインファイルを定義します。例: index.js、main.py など。 |
VERSION* | String | ❌ | - | 言語のバージョン(例: recommended)。 |
MEMORY* | Integer | ✅ | - | メモリ量(メガバイト単位)。 |
DISPLAY_NAME* | String | ✅ | 32 文字 | アプリケーションの表示名。 |
RUNTIME | String | ❌ | - | ランタイム環境。例: typescript、nodejs、go。 |
DESCRIPTION | String | ✅ | 280 文字 | アプリケーションの説明/メタデータ。 |
AUTORESTART | Boolean | ✅ | - | 自動再起動(true または false)。 |
START | String | ✅ | 256 文字 | カスタム起動コマンド。 |
SUBDOMAIN | String | ✅ | 63 文字 | ウェブサイトのサブドメイン(該当する場合)。 |
編集可能なパラメータ(✅)は、デプロイ後にダッシュボードで変更できます。編集不可(❌)のパラメータを変更するには、アプリケーションの完全な再アップロードが必要です。
設定パラメータの詳細
以下に、設定ファイルで使用できる設定パラメータを示します。MAIN [*]
型: String | 編集可否: ❌ | 制限: 32 文字アプリケーションのメインファイルを定義します。
このパラメータが設定されている場合、ランタイム環境はメインファイルの拡張子に基づいて推論されます
MEMORY [*]
型: Integer | 編集可否: ✅ | 制限: 最小 256MB(ボット)、512MB(サイト)アプリケーションが使用するメモリ量を定義します。
値はメガバイト(MB)で指定する必要があります。
VERSION [*]
型: String | 編集可否: ❌ | 値:
recommended、latest または特定のバージョン
アプリケーションの言語バージョンを定義します。| 言語 | recommended | latest |
|---|---|---|
| Node.js [JS & TS] | 24.15.0 | 26.1.0 |
| Python | 3.13.13 | 3.14.5 |
| Java | JDK 25 | JDK 25 |
| Elixir | 1.19.5 | 1.19.5 |
| Rust | 1.95.0 | 1.95.0 |
| Ruby | 4.0.4 | 4.0.4 |
| PHP | 8.5.6 | 8.5.6 |
| Go | 1.26.3 | 1.26.3 |
| .NET/C# | 10.0.8 | 10.0.8 |
SUBDOMAIN
型: String | 編集可否: ✅ | 制限: 63 文字 | デフォルト:
undefinedサイトのサブドメインを定義します(ウェブアプリケーションのみ)。最終的な URL は次のようになります:
mysite.squareweb.appRUNTIME
型: String | 編集可否: ❌ランタイム環境を手動で定義します。以下で受け入れられる値と環境を確認してください。
| 環境 | RUNTIME |
|---|---|
| Nodejs | nodejs, javascript |
| TypeScript | typescript |
| Python | python |
| C#/Dotnet | c#, dotnet, csharp |
| Elixir | elixir |
| Java | java |
| Rust | rust |
| Ruby | ruby, rb |
| PHP | php |
| Golang | go, golang |
| HTML/CSS | static, html |
ボット向けの設定例
ボット向けの設定例をいくつか紹介します。サイト向けの設定例
ウェブサイト向けの設定例をいくつか紹介します。サイトの URL は次のようになります:
mysite.squareweb.appnext.config.js を MAIN として指定するのは、プロジェクトを JavaScript または TypeScript のプロジェクト(別の .ts/.tsx ファイル)としてシステムに認識させるためだけです
