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

はじめに

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

前提条件

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

プロジェクトの作成

Flask アプリケーションを作成するには、手順を進める前にシステムに Python と pip がインストールされている必要があります。

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

Python と pip がインストールされていれば、Flask プロジェクトを作成できます。まず、必要な依存関係をインストールします。
Terminal
pip install flask

プロジェクトの開発

Python ファイル(例: app.py)を作成し、次のコードを追加して基本的な Flask アプリケーションを実装します。
app.py
# Import the Flask class from the flask module
from flask import Flask

# Create an instance of the Flask class
app = Flask(__name__)

# Define a route for the root URL (/) that returns 'Hello, World!'
@app.route('/')
def hello_world():
  return 'Hello, World!'

# Check if this script is being run directly (not imported as a module)
if __name__ == '__main__':
  # Run the Flask application on host 0.0.0.0 (all available network interfaces) and port 80
  app.run(host='0.0.0.0', port=80)
上記のコードでは、アクセスすると「Hello, World!」を返すシンプルなルートを実装しています。アプリケーションは、HTTP のデフォルトポートであるポート 80 で実行されるように設定されています。 次に、依存関係ファイルを作成する必要があります。Python では requirements.txt または pyproject.toml があります。

本番サーバーの選択

Flask に組み込まれている開発サーバーは本番環境での使用には適していません。代わりに、Gunicorn のような本番環境向けの WSGI サーバーの使用を推奨します。

Gunicorn

Gunicorn は UNIX 向けの Python WSGI HTTP サーバーです。プリフォーク型のワーカーモデルを採用しており、複数のワーカープロセスをフォークしてリクエストを処理します。 これにより、本番環境で Python の Web アプリケーションを実行するのに最適な選択肢となります。

デプロイ

プロジェクトファイルの準備が整ったら、それらを 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> 

追加リソース

Flask とその高度なツールに関するさらに詳細な情報については、Flask 公式ドキュメント を参照してください。 そこには、Flask の機能を最大限に活用するための踏み込んだ技術ガイド、専門的なチュートリアル、完全な API ドキュメントが用意されています。

トラブルシューティング

カスタムドメイン

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

お問い合わせ

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