Skip to main content
Java ランタイムは、ボット、ワーカー、API、ウェブサイトなどの実行可能な JAR ファイルを JDK 25 上で実行します。JAR は手元のマシンでビルドし、Square Cloud が java -jar で起動します。

​
始める前に

  • 手元のマシンに Java Development Kit (JDK)。まだの場合は、Adoptium から Eclipse Temurin をダウンロードできます。
  • Square Cloud のアカウント。メールアドレスまたは GitHub で登録できます。
  • 有効なプラン。プランを確認し、プロジェクトに合うものを選んでください。

​
Square Cloud の設定

ダッシュボードからアプリケーションをアップロードする場合、このセクションは飛ばしてかまいません。ダッシュボードが squarecloud.app 設定ファイルを自動で作成します。

設定ファイルのリファレンス

squarecloud.app ファイルは、アプリケーションの実行方法を Square Cloud に伝えます。メインファイル、メモリ、ランタイムのバージョン、名前、そして Web サイトの場合はサブドメインを指定します。
MAIN には JAR を指定します。アプリの種類ごとの完全な設定ファイルです。
squarecloud.app
MAIN は 32 文字までです。それより長いパスの場合は、代わりに RUNTIME=java と START=java -jar <path-to-your.jar> を使用してください。

​
Square Cloud が実行する内容

  • 設定ファイルに START フィールドが定義されていない場合、Square Cloud は java -jar MAIN を実行します。ここで MAIN に指定されたファイルが JAR ファイルです。START フィールドが定義されている場合は、その値が直接実行されます。設定ファイルのパラメーターに関する詳細は、設定パラメーターをご覧ください。

​
ウェブサイトと API のポートとホスト

Square Cloud は環境変数 PORT を 80 に設定します。サーバーはこのポートで、すべてのネットワークインターフェース (0.0.0.0) をリッスンする必要があります。Spring Boot の場合は、Spring Boot ガイドのとおり、application.properties に server.port=${PORT:80} を設定します。

​
プロジェクトの準備

Square Cloud は Java プロジェクトをコンパイルしません。手元のマシンで実行可能な JAR をビルドし、それをアップロードしてください。
  • Maven: mvn package を実行すると、JAR が target/ に出力されます。依存関係を 1 つの実行可能な JAR にまとめるには、Maven Shade プラグインまたは Assembly プラグインを使い、Main-Class を設定するように構成します。
  • Gradle: ./gradlew build（または gradle build）を実行すると、JAR が build/libs/ に出力されます。依存関係をまとめるには、Shadow プラグイン（./gradlew shadowJar）を使うか、jar タスクのマニフェストに Main-Class を設定します。
アップロードする前に、java -jar your-app.jar で JAR が起動することを確認してください。Java 25 以前を対象にコンパイルしてください。ランタイムは、より新しい Java 向けにビルドされたクラスを実行できません。

​
必要なファイル

  • ZIP のルートに置いた squarecloud.app。
  • MAIN に設定した実行可能な JAR。META-INF/MANIFEST.MF は別ファイルではなく JAR の中に置き、アプリケーションの Main-Class を宣言する必要があります。
設定ファイル（squarecloud.app）は zip ファイルのルートに配置する必要があります。そうでない場合、Square Cloud はデプロイ中にそれを見つけることができません。

​
含めないもの

  • ソースコードとビルドフォルダは任意です。JAR にはコンパイル済みのアプリケーションがすでに含まれています。

​
フレームワークガイド

Spring Boot

​
トラブルシューティング

JAR のマニフェストに Main-Class がないため、java -jar で起動できません。プロジェクトの準備の説明に従って、実行可能な JAR をビルドしてください。
JAR が JDK 25 より新しい Java 向けにコンパイルされています。Java 25 以前を対象にビルドしてください。
その他の問題については、トラブルシューティングを参照してください。

​
デプロイ

​
ダッシュボード経由

1

アップロードページにアクセス

アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
2

環境を設定

zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
3

プロジェクトをデプロイ

最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。
Square Cloud へのアプリケーションのアップロード
4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
アプリが起動しませんか？よくある原因と修正方法はトラブルシューティングガイドを参照してください。

​
CLI 経由

この方法を使用するには、プロジェクトのルートに squarecloud.app という名前の設定ファイルが必要です。このファイルは、アプリケーションの実行方法を Square Cloud に伝えます。

設定ファイルガイド

アプリケーションの環境を定義する squarecloud.app 設定ファイルの作成方法を学びます。
1

CLI をインストール

Square Cloud CLI をインストールします。すでにお持ちの場合は、同じコマンドを実行すると更新されます:
2

ログイン

次のコマンドを実行します。ブラウザが開くので、そこでログインを承認すれば CLI の準備は完了です。API キーをコピーする必要はありません。スクリプトや CI については、CLI の認証を参照してください。
3

プロジェクトをアップロード

プロジェクトのフォルダで次のコマンドを実行します。CLI は squarecloud.ignore に記載されたものを除いて現在のフォルダを zip にし、アップロードします:
自分で作成した zip をアップロードするには、--file で指定します:
4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ターミナルから直接、アプリケーションのステータスとログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
アプリが起動しませんか？よくある原因と修正方法はトラブルシューティングガイドを参照してください。

​
次のステップ

環境変数

シークレットや設定をコードから切り離し、実行時に読み込みます。

カスタムドメイン

Standard プラン以上で、独自ドメインからアプリを配信します。

トラブルシューティング

起動しないアプリや応答しないサイトを修正します。

​
お問い合わせ

技術的な問題が解決しない場合は、専門のサポートチームがお手伝いします。お問い合わせいただければ、どのような問題でも喜んで解決をサポートいたします。サポートの質の高さも、開発者が Google と Trustpilot で Square Cloud に402 件のレビューで 4.9/5という評価をつけている理由の 1 つです。