メインコンテンツへスキップ

はじめに

Square Cloud で を開発してホストするには、構成と前提条件の体系的な手順に従うことが不可欠です。この技術ガイドでは、初期セットアップから本番環境へのデプロイまで、プロセス全体を解説します。

前提条件

  • Square Cloud アカウント: 登録ページからメールアドレスを使って登録します。
  • 有効な有料プラン: アプリケーションに専用リソースと最適化されたパフォーマンスを提供します。利用可能なプランを確認し、ニーズに最も適したものを選択してください。

プロジェクトの作成

はじめる前に、システムに Node.js と npm がインストールされていることを確認してください。まだお持ちでない場合は、公式の Node.js サイトからダウンロードできます。

CLI のインストール

Angular プロジェクトを作成するには、Angular CLI をインストールする必要があります。次のコマンドを実行してください。
npm install -g @angular/cli

プロジェクトの開発

新しい Angular プロジェクトを作成します。
ng new my-angular-app
次に、プロジェクトの依存関係をインストールします。
cd my-angular-app
npm install
ローカルの開発サーバーを起動するには、次を実行します。
ng serve --port 80
Angular が開発サーバーを起動します。通常は http://localhost:80 で利用できます。 シンプルなコンポーネントを生成するには、次を使用します。
ng generate component hello
生成されたテンプレートは次の場所で編集できます。
src/app/hello/hello.component.html

プロジェクトのビルド

プロジェクトを Square Cloud にアップロードする前に、本番用バンドルをビルドします。
ng build --configuration production
Angular は最適化された静的ファイルを dist/{PROJECT_NAME} フォルダー内に生成します。

本番サーバーの選択

Angular アプリケーションを本番環境で配信するには、サーバーを使用する必要があります。自分で作成することも、既存のものを使用することもできます。

Express ライブラリ

静的プロジェクトを Square Cloud で配信するには、サーバーが静的ファイルを正しく配信できるようにしてください。Node.js と Express を使用する一般的な構成は次のとおりです。
server.js
import express from 'express';
import path from 'path';

const app = express();
const distPath = path.join(import.meta.dirname, 'dist');

app.use(express.static(distPath));

// SPA fallback: serve index.html for any route not matched above
app.use((req, res) => {
  res.sendFile(path.join(distPath, 'index.html'));
});

app.listen(80, () => console.log('Server running on port 80'));
dist のパスパラメータをプロジェクトのビルドフォルダに合わせて調整してください。builddist 内のフォルダにある場合は、そのパスを使用してください。

Serve ライブラリ

Serve ライブラリのインストール

serve ライブラリをインストールするには、ターミナルでプロジェクトのディレクトリに移動し、次のコマンドを実行します。
npm install serve@14.2.3
このコマンドは serve ライブラリのバージョン 14.2.3 をインストールします。最新バージョンをインストールしたい場合は、@14.2.3 を省略できます。

起動スクリプトの設定

serve ライブラリをインストールしたら、serve を使用するようにプロジェクトの起動スクリプトを設定する必要があります。これを行うには、プロジェクトの package.json ファイルを開き、start:prod という新しいスクリプトを追加します。
"scripts": {
  "start:prod": "serve -s dist -l 80",
  ...
}
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 パラメータはプロジェクトのビルドフォルダに合わせて調整してください。builddist 内のフォルダにある場合は、そのパスを使用してください。

デプロイ

プロジェクトファイルの準備ができたら、Square Cloud にアップロードしてプロジェクトをホストできます。 そのためには、すべてのプロジェクトファイルを含む ZIP ファイルを作成します。

ダッシュボード経由

1

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

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

環境を設定

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

プロジェクトをデプロイ

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

CLI 経由

この方法を使用するには、プロジェクトのルートディレクトリに squarecloud.app という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。

詳細はこちら: Square Cloud の設定ファイルの作成方法。

squarecloud.app ファイルはアプリケーションを構成するために使用される設定ファイルであり、環境を定義するために使用されます。
1

CLI をインストール

まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:
npm install -g @squarecloud/cli
すでにお持ちの場合は、更新することを推奨します。更新するには、ターミナルで次のコマンドを実行してください:
squarecloud update
2

認証

次に、認証して他の CLI コマンドを使用するには、こちらで「Request API Key」をクリックして認証キーを取得します。認証キーを取得したら、次のコマンドを実行してください:
squarecloud auth login
3

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

最後に、CLI を使用してアプリケーションを Square Cloud にデプロイするには、次のコマンドを実行する必要があります:
squarecloud upload 
または、zip を手動で作成した場合は、次を使用できます:
squarecloud upload --file <path/to/zip> 

追加リソース

Angular の詳細については、こちら の公式ドキュメントをご覧ください。

トラブルシューティング

カスタムドメイン

デフォルトの 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 ファイルの PORTHOST を使用することを推奨します。

お問い合わせ

技術的な問題が解決しない場合は、専門のサポートチームがお手伝いします。お問い合わせいただければ、どのような問題でも喜んで解決をサポートいたします。