🚀 はじめに
- 始める前に、Node.js と npm がシステムにインストールされていることを確認してください。まだの場合は、Node.js 公式サイトからダウンロードできます。
- 次に、Square Cloud のアカウントを作成する必要があります。これはログインページから行えます。アカウントの作成にはメール、GitHub、またはその両方を使用できます。
- 最後に、アカウントに有効な有料プランが必要です。プランを確認し、ニーズに合わせてこちらから購入できます。
⚙️ squarecloud.app ファイルの設定
Square Cloud のウェブサイト経由でアプリケーションをアップロードする場合は、このセクションを無視してかまいません。サイトが自動的に
squarecloud.app 設定ファイルを作成します。詳しく見る: Square Cloud の設定ファイルの作成方法
squarecloud.app ファイルは、アプリケーションを設定するために使用される設定ファイルです。名前、説明、
バージョン、メインファイルなどを定義するために使われます。
📄 必要なファイル
- JavaScript
- TypeScript
- 設定ファイルに
STARTフィールドが定義されていない場合、Square Cloud はデフォルトでnodeを最適化オプションおよび特定のパラメーター付きで実行します。STARTフィールドが定義されている場合は、その値が直接実行されます。設定ファイルのパラメーターに関する詳細は、設定パラメーターをご覧ください。
node_modulesフォルダが存在しない場合、Square Cloud はnpm install --no-package-lock --no-audit --no-fundを実行して依存関係をインストールし、.npmフォルダをクリーンアップします。
🖥️ プロジェクトの準備
📁 必須の設定ファイル
Node.js プロジェクトを Square Cloud にデプロイする準備をする際は、設定ファイル（squarecloud.app/.config）とアプリケーションの必須ファイルを zip ファイル内に含めるようにしてください。
🗑️ アップロード前に除外するファイル
node_modules: このフォルダはアップロードする必要はありません。本番環境でのインストール時に再作成されるためです。package-lock.json: 本番環境はpackage.jsonに基づいて依存関係をインストールするため、このファイルは不要です。
🤔 なぜこれらのファイルを除外するのか？
プロジェクトをアップロードする前にnode_modules と package-lock.json を除外する理由はいくつかあります。
-
インストールの一貫性:
node_modulesをアップロードしないことで、依存関係が本番環境によってインストールされることが保証され、ローカルシステムの差異のない一貫したビルドが得られます。 -
最新のインストール: 本番環境は
package.jsonに列挙された依存関係の最新の互換バージョンをインストールし、アプリケーションにクリーンなスタートを提供します。 - アップロードサイズの削減: これらのフォルダを含めないことでアップロードファイルのサイズが減り、アップロードプロセスが高速化され、deploy がより効率的になります。
📄 必要なファイル
Node プロジェクトをホスティングするには 3 つのファイルが必要です。- squarecloud.app/.config
- mainFile.js/.ts（メインファイルの例）
- package.json（依存関係ファイル）
Square Cloud は
TypeScript をネイティブにサポートしており、ts-node
経由でプロジェクトを実行しますが、当社は本番プラットフォームであるため、常に
JavaScript へのコンパイルをおすすめします。💡 トラブルシューティング
メインファイルが無効または破損しています
メインファイルが無効または破損しています
このエラーは、設定ファイルでアプリケーションの「main」として定義されたファイルが
存在しない、誤って記述されている、またはパスが
間違っている場合に発生します。例えばメインファイルがフォルダ内にある場合は、
folder/file.js のように指定する必要があります。メモリ不足
メモリ不足
ボットをホスティングするために必要な RAM の最小量は 256MB で、
サイト/API の場合は 512MB です。ただし、アプリケーションのサイズや複雑さによっては、
アプリケーションがメモリ不足でクラッシュするのを避けるために、より多くの RAM を
割り当てることをおすすめする場合があります。
📤 プロジェクトのホスティング方法
Node.js プロジェクトのすべてのファイルを準備できたので、次のステップはそれらを Square Cloud にアップロードし、アプリケーションをオンラインにすることです。アップロードにはいくつかの方法がありますが、ここでは 2 つを取り上げます。Dashboard 経由と CLI 経由です。ダッシュボード経由
アップロードページにアクセス
アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
環境を設定
zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
CLI 経由
この方法を使用するには、プロジェクトのルートディレクトリにsquarecloud.app という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。
詳細はこちら: Square Cloud の設定ファイルの作成方法。
squarecloud.app ファイルはアプリケーションを構成するために使用される設定ファイルであり、環境を定義するために使用されます。
CLI をインストール
まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:すでにお持ちの場合は、更新することを推奨します。更新するには、ターミナルで次のコマンドを実行してください:
- Windows
- Linux, macOS, and WSL
認証
次に、認証して他の CLI コマンドを使用するには、こちらで「Request API Key」をクリックして認証キーを取得します。認証キーを取得したら、次のコマンドを実行してください: