始める前に
- HTML と CSS ファイルを編集するテキストエディタ。たとえば Visual Studio Code。
- Square Cloud のアカウント。メールアドレスまたは GitHub で登録できます。
- 有効なプラン。プランを確認し、プロジェクトに合うものを選んでください。
静的サイトとサーバーでレンダリングするアプリ
静的サイトは、どの訪問者にも同じ内容を返すファイルの集まりです。素の HTML ページや、Vite、React、Vue、Angular、Astro、Gatsby などのフレームワークのビルド出力がこれにあたります。静的ランタイムはこれらのファイルをそのまま配信します。 サーバーでレンダリングするアプリは、Next.js、Nuxt、React Router や API などのサーバーコードで、リクエストのたびにページを生成します。常時動くプロセスが必要なため、Node.js ランタイムなどの言語ランタイム上で、MAIN ファイルまたは START コマンドを使って実行します。
フレームワークがどちらにも対応している場合は、静的ビルドのほうが軽量です。各フレームワークガイドに、対応している方法が記載されています。
Square Cloud の設定
ダッシュボードからアプリケーションをアップロードする場合、このセクションは飛ばしてかまいません。ダッシュボードが
squarecloud.app 設定ファイルを自動で作成します。設定ファイルのリファレンス
squarecloud.app ファイルは、アプリケーションの実行方法を Square Cloud に伝えます。メインファイル、メモリ、ランタイムのバージョン、名前、そして Web サイトの場合はサブドメインを指定します。MAIN を指定すると、静的ランタイムが選択されます。
squarecloud.app
静的ランタイムがファイルを配信する仕組み
- ZIP のルートがサイトのルートになります。
about.htmlは/about.htmlで、blog/index.htmlは/blog/で配信されます。 /には、vite.htmlがあればそれを、なければindex.htmlを返します。- パスに一致するファイルがない場合、
vite.htmlがあればそれを返します。これにより、フレームワークを問わず、シングルページアプリのクライアントサイドのルートを再読み込みしても動作します。ビルドのindex.htmlをvite.htmlにリネームしてください。 vite.htmlがない場合、存在しないパスには404.htmlを返し、それもなければデフォルトの 404 ページを返します。- ファイルは配信時に圧縮され、
squarecloud.appファイルが配信されることはありません。
プロジェクトの準備
ファイルはsquarecloud.app と並べて ZIP のルートに置きます。
index.html。シングルページアプリの場合はvite.html。- CSS、JavaScript、画像、フォント。フォルダ構成は自由です。
404.html(任意): 存在しないパス用のページ。
フレームワークガイド
各ガイドでは、ビルドコマンド、出力フォルダ、静的ランタイムで公開する方法を説明しています。Vite
React
Vue
Angular
Astro
Gatsby
Preact
Qwik
SolidJS
Nuxt
トラブルシューティング
Square Shield のデフォルトページが表示される
Square Shield のデフォルトページが表示される
ページに “Hi, I’m Square Shield” と表示される場合、ランタイムが ZIP のルートで
index.html も vite.html も見つけられていません。ビルドフォルダの中身ではなく、フォルダそのものを ZIP にしている可能性があります。フォルダ内のファイルを ZIP にしてください。ルートを再読み込みすると 404 になる
ルートを再読み込みすると 404 になる
シングルページアプリがブラウザ内でルートを処理しています。存在しないパスでもアプリが読み込まれるように
index.html を vite.html にリネームし、MAIN も更新してください。デプロイ
ダッシュボード経由
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 プラン以上で、独自ドメインからアプリを配信します。
トラブルシューティング
起動しないアプリや応答しないサイトを修正します。

