始める前に
- 手元のマシンに Go。まだの場合は、Go 公式サイトからダウンロードしてください。
- Square Cloud のアカウント。メールアドレスまたは GitHub で登録できます。
- 有効なプラン。プランを確認し、プロジェクトに合うものを選んでください。
Square Cloud の設定
ダッシュボードからアプリケーションをアップロードする場合、このセクションは飛ばしてかまいません。ダッシュボードが
squarecloud.app 設定ファイルを自動で作成します。設定ファイルのリファレンス
squarecloud.app ファイルは、アプリケーションの実行方法を Square Cloud に伝えます。メインファイル、メモリ、ランタイムのバージョン、名前、そして Web サイトの場合はサブドメインを指定します。- ボットまたはワーカー
- ウェブサイトまたは API
squarecloud.app
Square Cloud が実行する内容
-
設定ファイルに
STARTフィールドが定義されていない場合、Square Cloud はgo run MAINを実行し、MAINで指定された Go ファイルをコンパイルして実行します。STARTフィールドが定義されている場合は、その値が直接実行されます。設定ファイルのパラメーターに関する詳細は、設定パラメーターをご覧ください。 -
go run MAINはMAINに設定されたファイルのみをコンパイルします。mainパッケージが複数のファイルに分かれている場合は、START=go run .を設定してください。 -
Square Cloud は
go mod tidyを実行しません。go.modとgo.sumにすべての依存関係が記載されるよう、アップロード前に手元のマシンで実行してください。go runはアプリの起動時にそれらのモジュールをダウンロードします。
ウェブサイトと API のポートとホスト
Square Cloud は環境変数PORT を 80 に設定します。この値を読み込み、すべてのネットワークインターフェースを対象とする ":" + port でリッスンしてください。
main.go
プロジェクトの準備
必要なファイル
- ZIP のルートに置いた
squarecloud.app。 main.go、またはMAINに設定したファイル。go.mod、またはワークスペースの場合はgo.work。どちらもないアップロードはINVALID_DEPENDENCYで失敗します。go.sum。モジュールに依存関係がある場合は必須です。
含めないもの
- コンパイル済みのバイナリ (
.exeファイルやgo buildの出力): プログラムは Square Cloud がビルドします。 vendor/(ビルドで意図的に使っている場合を除く):go runはgo.sumに記載されたモジュールをダウンロードします。
トラブルシューティング
missing go.sum entry
missing go.sum entry
go.sum がないか、古くなっています。手元のマシンで go mod tidy を実行し、更新された go.mod と go.sum をアップロードしてください。undefined: 別のファイルの関数
undefined: 別のファイルの関数
go run MAIN は 1 つのファイルしかコンパイルしません。main パッケージ全体をコンパイルするには START=go run . を設定してください。デプロイ
ダッシュボード経由
1
アップロードページにアクセス
アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
2
環境を設定
zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
3
プロジェクトをデプロイ
最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。

4
アプリが稼働していることを確認
最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで
ウェブサイトや 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 は 自分で作成した zip をアップロードするには、
squarecloud.ignore に記載されたものを除いて現在のフォルダを zip にし、アップロードします:--file で指定します:4
アプリが稼働していることを確認
最初のデプロイは、通常 1 分もかからずに完了します。ターミナルから直接、アプリケーションのステータスとログを確認してください。ウェブサイトや API をデプロイした場合は、ブラウザで
https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
次のステップ
環境変数
シークレットや設定をコードから切り離し、実行時に読み込みます。
カスタムドメイン
Standard プラン以上で、独自ドメインからアプリを配信します。
トラブルシューティング
起動しないアプリや応答しないサイトを修正します。

