はじめに
Square Cloud で を開発してホストするには、構成と前提条件の体系的な手順に従うことが不可欠です。この技術ガイドでは、初期セットアップから本番環境へのデプロイまで、プロセス全体を解説します。前提条件
- Square Cloud アカウント: 登録ページからメールアドレスを使って登録します。
- 有効な有料プラン: アプリケーションに専用リソースと最適化されたパフォーマンスを提供します。利用可能なプランを確認し、ニーズに最も適したものを選択してください。
プロジェクトの作成
始める前に、システムに Node.js と npm がインストールされていることを確認してください。 まだお持ちでない場合は、公式の Node.js ウェブサイトからダウンロードしてください。CLI のインストール
新しい Preact プロジェクトを作成するには、Preact CLI を使用します。グローバルにインストールします。プロジェクトの開発
新しい Preact プロジェクトを作成します。http://localhost:8080(または利用可能な別のポート)で起動します。
シンプルなコンポーネントを編集するには、次を変更します。
app.js
プロジェクトのビルド
アップロードする前に、本番用ビルドを生成します。build/ ディレクトリ内に出力します。
本番サーバーの選択
Preact を本番環境で配信するにはサーバーが必要です。独自のサーバーを作成するか、既存のものを使用できます。Express ライブラリ
静的プロジェクトを Square Cloud で配信するには、サーバーが静的ファイルを正しく配信できるようにしてください。Node.js と Express を使用する一般的な構成は次のとおりです。server.js
dist のパスパラメータをプロジェクトのビルドフォルダに合わせて調整してください。build や dist 内のフォルダにある場合は、そのパスを使用してください。Serve ライブラリ
Serve ライブラリのインストール
serve ライブラリをインストールするには、ターミナルでプロジェクトのディレクトリに移動し、次のコマンドを実行します。
serve ライブラリのバージョン 14.2.3 をインストールします。最新バージョンをインストールしたい場合は、@14.2.3 を省略できます。
起動スクリプトの設定
serve ライブラリをインストールしたら、serve を使用するようにプロジェクトの起動スクリプトを設定する必要があります。これを行うには、プロジェクトの package.json ファイルを開き、start:prod という新しいスクリプトを追加します。
start:prod スクリプト内の serve -s build -l 80 は次の処理を行います。
serve:serveサーバーを起動するコマンドです。-s dist:-sオプションはdistディレクトリをシングルページアプリケーションモードで配信します。これにより、見つからないすべてのリクエストがindex.htmlにリダイレクトされます。distディレクトリは通常、npm run buildを実行すると作成されます。-l 80:-lオプションに続けて80を指定すると、serveはポート 80 でリッスンします。ポート 80 は HTTP トラフィックのデフォルトポートです。
dist パラメータはプロジェクトのビルドフォルダに合わせて調整してください。build や dist 内のフォルダにある場合は、そのパスを使用してください。デプロイ
プロジェクトファイルの準備ができたら、それらを Square Cloud にアップロードしてプロジェクトをホストできます。 そのためには、すべてのプロジェクトファイルを含む ZIP ファイルを作成してください。ダッシュボード経由
アップロードページにアクセス
アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
環境を設定
zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
CLI 経由
この方法を使用するには、プロジェクトのルートディレクトリにsquarecloud.app という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。
詳細はこちら: Square Cloud の設定ファイルの作成方法。
squarecloud.app ファイルはアプリケーションを構成するために使用される設定ファイルであり、環境を定義するために使用されます。
CLI をインストール
まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:すでにお持ちの場合は、更新することを推奨します。更新するには、ターミナルで次のコマンドを実行してください:
- Windows
- Linux, macOS, and WSL
認証
次に、認証して他の CLI コマンドを使用するには、こちらで「Request API Key」をクリックして認証キーを取得します。認証キーを取得したら、次のコマンドを実行してください:
その他のリソース
Preact の詳細については、公式ドキュメントこちらをご覧ください。トラブルシューティング
カスタムドメイン
デフォルトの URL
mysite.squareweb.app の代わりにカスタムドメイン(例: mysite.com)を使用するには、Standard プラン以上が必要です。サブドメインは設定ファイルの SUBDOMAIN フィールドで定義します。最小 RAM 要件
シンプルなウェブサイト/API の場合は最小 512MB RAMです。フレームワーク(Next.JS、React、Vue、Angular など)を使用するサイトでは、常に最低 1GB RAMを推奨します。より大規模なアプリケーションでは、メモリ不足でアプリケーションがクラッシュするのを防ぐため、より多くの RAM を割り当ててください。
このサイトが見つかりませんでした。
サブドメイン/ドメインが SUBDOMAIN フィールドまたはカスタムドメイン設定で構成されている内容と一致しているか確認してください。サイトをアップロードしたばかりの場合は、Square が初回アクセスを有効化するまで最大 60 秒お待ちください。
サイトの応答に時間がかかりすぎました…
アプリケーションでポート 80 とホスト 0.0.0.0 を正しく設定しているか確認してください。Square の強制環境変数である
.env ファイルの PORT と HOST を使用することを推奨します。

