Skip to main content
静的ランタイムは、HTML、CSS、JavaScript、画像などのファイルを、Square Cloud が管理するウェブサーバーで ZIP からそのまま配信します。常時動かしておく独自のプロセスがないため、ウェブサイトを公開する最も軽い方法です。

始める前に

  • 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 サイトの場合はサブドメインを指定します。
HTML ファイルを指す MAIN を指定すると、静的ランタイムが選択されます。
squarecloud.app
ウェブサイトの最小メモリは 512 MB で、静的ファイルには十分な量です。

静的ランタイムがファイルを配信する仕組み

  • 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 ファイルが配信されることはありません。
ZIP 内のファイルはすべて公開されます。ソースコード、.env ファイル、その他訪問者にダウンロードされたくないものはアップロードしないでください。

プロジェクトの準備

ファイルは squarecloud.app と並べて ZIP のルートに置きます。
  • index.html。シングルページアプリの場合は vite.html。
  • CSS、JavaScript、画像、フォント。フォルダ構成は自由です。
  • 404.html (任意): 存在しないパス用のページ。
フレームワークのビルドの場合は、ビルド出力フォルダそのものではなく、その中身を ZIP にします。

フレームワークガイド

各ガイドでは、ビルドコマンド、出力フォルダ、静的ランタイムで公開する方法を説明しています。

Vite

React

Vue

Angular

Astro

Gatsby

Preact

Qwik

SolidJS

Nuxt

トラブルシューティング

ページに “Hi, I’m Square Shield” と表示される場合、ランタイムが ZIP のルートで index.html も vite.html も見つけられていません。ビルドフォルダの中身ではなく、フォルダそのものを ZIP にしている可能性があります。フォルダ内のファイルを ZIP にしてください。
シングルページアプリがブラウザ内でルートを処理しています。存在しないパスでもアプリが読み込まれるように index.html を vite.html にリネームし、MAIN も更新してください。
その他の問題については、トラブルシューティングを参照してください。

デプロイ

ダッシュボード経由

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 つです。