メインコンテンツへスキップ

設定ファイルとは?

設定ファイルは、メインファイル、メモリ、バージョンなどのアプリケーションのパラメータを含むファイルです。このファイルは、Square Cloud プラットフォーム上でアプリケーションを設定してデプロイするために使用されます。
squarecloud.app
MAIN=main_file.js
DISPLAY_NAME=I am the configuration file
MEMORY=512
VERSION=recommended

設定ファイルの作成

設定ファイルの作成はとても簡単です。squarecloud.app または squarecloud.config という名前のファイルを作成し、その中に設定パラメータを追加するだけです。
1

拡張子を選ぶ

設定ファイルには 2 つの拡張子を使用できます。.app または .config です。squarecloud.app または squarecloud.config のどちらでもお好みのものを使用できます。ヒント: Square Cloud を広めるために .app を使いましょう。🥰😂
macOS では、.config 拡張子の使用をおすすめします。
注意: .app または .configファイルの拡張子を指すものであり、ファイル名ではありません。
2

ファイルを作成する

選択した拡張子でファイルを作成し、その中に設定パラメータを追加します。

設定パラメータ

以下に、設定ファイルで利用可能なすべての設定パラメータを示します。
パラメータ編集可否制限用途
MAIN*String32 文字アプリケーションのメインファイルを定義します。例: index.jsmain.py など。
VERSION*String-言語のバージョン(例: recommended)。
MEMORY*Integer-メモリ量(メガバイト単位)。
DISPLAY_NAME*String32 文字アプリケーションの表示名。
RUNTIMEString-ランタイム環境。例: typescriptnodejsgo
DESCRIPTIONString280 文字アプリケーションの説明/メタデータ。
AUTORESTARTBoolean-自動再起動(true または false)。
STARTString256 文字カスタム起動コマンド。
SUBDOMAINString63 文字ウェブサイトのサブドメイン(該当する場合)。
編集可能なパラメータ(✅)は、デプロイ後にダッシュボードで変更できます。編集不可(❌)のパラメータを変更するには、アプリケーションの完全な再アップロードが必要です。

設定パラメータの詳細

以下に、設定ファイルで使用できる設定パラメータを示します。

MAIN [*]

: String | 編集可否: ❌ | 制限: 32 文字アプリケーションのメインファイルを定義します。
MAIN=index.js
MAIN=src/loaders/index.js
このパラメータが設定されている場合、ランタイム環境はメインファイルの拡張子に基づいて推論されます
この設定は、START パラメータを使用している場合は無視されます

MEMORY [*]

: Integer | 編集可否: ✅ | 制限: 最小 256MB(ボット)、512MB(サイト)アプリケーションが使用するメモリ量を定義します。
MEMORY=256
値はメガバイト(MB)で指定する必要があります。

VERSION [*]

: String | 編集可否: ❌ | : recommendedlatest または特定のバージョン
最適な安定性のために recommended の使用をおすすめします。
アプリケーションの言語バージョンを定義します。
VERSION=recommended
言語recommendedlatest
Node.js [JS & TS]24.15.026.1.0
Python3.13.133.14.5
JavaJDK 25JDK 25
Elixir1.19.51.19.5
Rust1.95.01.95.0
Ruby4.0.44.0.4
PHP8.5.68.5.6
Go1.26.31.26.3
.NET/C#10.0.810.0.8

DISPLAY_NAME [*]

: String | 編集可否: ✅ | 制限: 32 文字アプリケーションの表示名を定義します。
DISPLAY_NAME=Admin BOT

DESCRIPTION

: String | 編集可否: ✅ | 制限: 280 文字アプリケーションの説明を定義します。
DESCRIPTION=This bot is designed to help you with your daily tasks.

AUTORESTART

: Boolean | 編集可否: ✅ | : truefalse | デフォルト: falseアプリケーションが失敗時に自動的に再起動すべきかどうかを定義します。
AUTORESTART=true

SUBDOMAIN

: String | 編集可否: ✅ | 制限: 63 文字 | デフォルト: undefinedサイトのサブドメインを定義します(ウェブアプリケーションのみ)。
SUBDOMAIN=mysite
最終的な URL は次のようになります: mysite.squareweb.app

RUNTIME

: String | 編集可否: ❌ランタイム環境を手動で定義します。
RUNTIME=nodejs
以下で受け入れられる値と環境を確認してください。
環境RUNTIME
Nodejsnodejs, javascript
TypeScripttypescript
Pythonpython
C#/Dotnetc#, dotnet, csharp
Elixirelixir
Javajava
Rustrust
Rubyruby, rb
PHPphp
Golanggo, golang
HTML/CSSstatic, html
このパラメータを設定する場合、MAIN を設定する必要はありません。代わりに、カスタム START コマンドを設定してください。

START

: String | 編集可否: ✅ | 制限: 256 文字 | デフォルト: undefinedカスタム起動コマンドを定義します。
START=npm run start
このパラメータはデフォルトの MAIN の動作を上書きします。

ボット向けの設定例

ボット向けの設定例をいくつか紹介します。
# Required parameters.
MAIN=index.js
MEMORY=512
VERSION=recommended
DISPLAY_NAME=Robin bot
# Example with all parameters.
MAIN=index.js
MEMORY=512
VERSION=recommended
DISPLAY_NAME=Robin bot
DESCRIPTION=This bot was created to help with your daily tasks.
START=npm run start
AUTORESTART=true

サイト向けの設定例

ウェブサイト向けの設定例をいくつか紹介します。
サイトの URL は次のようになります: mysite.squareweb.app
# Example with all parameters.
MAIN=index.js
MEMORY=1024
VERSION=recommended
DISPLAY_NAME=My site
DESCRIPTION=My site is really cool!
SUBDOMAIN=mysite
START=npm run build && npm run start
AUTORESTART=true
next.config.js を MAIN として指定するのは、プロジェクトを JavaScript または TypeScript のプロジェクト(別の .ts/.tsx ファイル)としてシステムに認識させるためだけです
# Example for a Next.js site.
MAIN=next.config.js
MEMORY=2048
VERSION=recommended
DISPLAY_NAME=Next.js site
DESCRIPTION=This site was built with Next.js.
SUBDOMAIN=nextjs
START=npm run build && npm run start
AUTORESTART=true