はじめに
Square Cloud で を開発してホストするには、構成と前提条件の体系的な手順に従うことが不可欠です。この技術ガイドでは、初期セットアップから本番環境へのデプロイまで、プロセス全体を解説します。前提条件
- Square Cloud アカウント: 登録ページからメールアドレスを使って登録します。
- 有効な有料プラン: アプリケーションに専用リソースと最適化されたパフォーマンスを提供します。利用可能なプランを確認し、ニーズに最も適したものを選択してください。
Evolution API を使う理由
Evolution API は、n8n、chatwoot、その他のツールを統合し、多くのツールを 1 か所で簡単に利用できるようにします。 このプロジェクトを使うと、Evolution API 自体または その API を通じてインスタンスを素早く作成して接続でき、複数のボットインスタンスを 1 か所で管理できます。プロジェクトのセットアップ
まず、何らかのソースからプロジェクトを入手する必要があります。公式リポジトリから入手するか、リリースに Square Cloud へのデプロイに必要なファイルがすでに含まれている当社のリポジトリから入手できます。データベースの設定
セットアップを始めるには、データベースが必要です。Standard プラン以上をお持ちの場合は、Square Cloud でホスティングできます。 作成後、.env に URL を DATABASE_CONNECTION_URI として設定し、PostgreSQL 接続用のクライアント証明書を作成する必要があります。必要な設定の例を以下に示します:
.env
runWithProvider.js ファイルを配置し、次のコマンドを実行してください:
- Windows
- Linux
サーバーの設定
リポジトリの.env.example ファイルに示されているとおり、いくつかの環境変数、server_type、server_port、server_url、そして言語を設定する必要があります。
.env
.env
デプロイ
Square Cloud でデプロイするには、起動コマンドを設定して web で公開するだけです。インストールとビルドには、3096MB の RAM を使用することをお勧めします。startup command
ダッシュボード経由
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 という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。
設定ファイルガイド
アプリケーションの環境を定義する
squarecloud.app 設定ファイルの作成方法を学びます。1
CLI をインストール
まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:すでにお持ちの場合は、更新することを推奨します。更新するには、ターミナルで次のコマンドを実行してください:
- Windows
- Linux, macOS, and WSL
2
認証
次に、認証して他の CLI コマンドを使用するには、こちらで「Request API Key」をクリックして認証キーを取得します。認証キーを取得したら、次のコマンドを実行してください:
3
プロジェクトをアップロード
最後に、CLI を使用してアプリケーションを Square Cloud にデプロイするには、次のコマンドを実行する必要があります:または、zip を手動で作成した場合は、次を使用できます:
4
アプリが稼働していることを確認
最初のデプロイは、通常 1 分もかからずに完了します。ターミナルから直接、アプリケーションのステータスとログを確認してください。ウェブサイトや API をデプロイした場合は、ブラウザで
https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
追加情報
初回実行後は、RAM を 1536MB または 2048MB に減らし、起動コマンドを次のみに設定できます:キャッシュシステム
Evolution API でキャッシュシステムを設定できます。そのためには、Square Cloud でもホスティングできる Redis データベースが必要です。設定するには、証明書をダウンロードして接続用の URL を設定する必要もあります。
.env
トラブルシューティング
カスタムドメイン
デフォルトの 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 を使用することを推奨します。
