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

​
🚀 はじめに

  • 始める前に、システムに Python がインストールされていることを確認してください。まだお持ちでない場合は、Python 公式サイトからダウンロードできます。
  • 次に、Square Cloud のアカウントを作成する必要があります。これはログインページから行えます。アカウントの作成にはメール、GitHub、またはその両方を使用できます。
  • 最後に、アカウントで有効な有料プランが必要です。プランの確認とニーズに応じた購入はこちらから行えます。

​
⚙️ squarecloud.app ファイルの設定

Square Cloud のウェブサイト経由でアプリケーションをアップロードする場合は、このセクションを無視してかまいません。サイトが自動的に squarecloud.app 設定ファイルを作成します。

詳しく見る: Square Cloud の設定ファイルの作成方法

squarecloud.app ファイルは、アプリケーションを設定するために使用される設定ファイルです。名前、説明、 バージョン、メインファイルなどを定義するために使われます。

​
📄 必要なファイル

  • 設定ファイルに START フィールドが定義されていない場合、Square Cloud は python MAIN を実行して MAIN で指定された Python ファイルを起動します。設定ファイルに START フィールドが定義されている場合は、その値が直接実行されます。設定ファイルのパラメータについての詳細は、設定パラメータをご覧ください。
  • Square Cloud は pip install を使用して、requirements.txt に記載されているすべての依存関係をインストールします。

​
🖥️ プロジェクトの準備

​
📁 必須の設定ファイル

Python プロジェクトを Square Cloud にデプロイする準備をする際は、設定ファイル（squarecloud.app/.config）とアプリケーションの必須ファイルを zip ファイルに含めるようにしてください。
設定ファイル（squarecloud.app/.config）は zip ファイルのルートに配置する必要があります。そうでない場合、Square Cloud はデプロイ時にそれを見つけることができません。

​
🗑️ アップロード前に除外するファイル

  • ffmpeg: このソフトウェアは Square Cloud 環境にプリインストールされているため、プロジェクトに含める必要はありません。
  • .venv: このフォルダにはプロジェクトの仮想環境が含まれています。Square Cloud は独立した環境を提供するため、このフォルダをアップロードする必要はありません。
  • poetry.lock: Square Cloud は現在 Poetry をサポートしていないため、デプロイ時の互換性の問題を避けるためにこのファイルは除外してください。

​
🤔 なぜこれらのファイルを除外するのか？

ffmpeg、.venv、poetry.lock を除外することは、いくつかの理由で重要です:
  1. クリーンな環境: Square Cloud はプロジェクト用に新しい環境を作成します。これらのファイルを含めることは不要であり、クラウド環境の設定と競合する可能性があります。
  2. 効率性: これらのファイルを削除するとアップロードサイズが小さくなり、プロセスがより速く軽量になります。
  3. 互換性: Square Cloud は依存関係のインストールに requirements.txt を使用するため、poetry.lock を除外することで互換性の問題を回避できます。
アップロードする前に、上記の不要なファイルを除外して、プロジェクトファイルを .zip 形式に圧縮してください。これにより、Python アプリケーションが Square Cloud で正常にデプロイできる状態になります。

​
📄 必要なファイル

  • main.py（メインファイルの例）。
  • requirements.txt（依存関係ファイル）。
  • または [pyproject.toml]（依存関係ファイル）。
  • squarecloud.app（Square Cloud の設定を含むファイル）。

​
💡 トラブルシューティング

このエラーは、設定ファイルでアプリケーションの「main」として定義されたファイルが 存在しない、記述が誤っている、またはパスが正しくない場合に発生します。 メインファイルがフォルダ内にある場合は、例えば folder/file.py のように指定してください。
ボットをホストするために必要な RAM の最小量は 256MB、 サイト/API の場合は 512MB です。ただし、アプリケーションのサイズや複雑さに応じて、 アプリケーションがメモリ不足でクラッシュするのを避けるために、 より多くの RAM を割り当てることをお勧めする場合があります。

​
📤 プロジェクトのホスト方法

これで Python プロジェクトのすべてのファイルを準備できたので、次のステップはそれらを Square Cloud にアップロードしてアプリケーションをオンラインにすることです。アップロードには複数の方法がありますが、ここでは Dashboard 経由と CLI 経由の 2 つを取り上げます。

​
ダッシュボード経由

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>

​
お問い合わせ

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