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

​
🚀 はじめに

  • 始める前に、プロジェクトで Deno ランタイムを使用することを選択できます。まだローカルに Deno をインストールしていない場合、主に 2 つの選択肢があります。
  • npm 経由でインストール（deploy 時の npx との互換性のため推奨）: 
npm install deno
  • または、公式インストーラー経由で Deno をインストールする（ネイティブインストールの手順については Deno のドキュメントを確認してください）。
  • deno を依存関係として追加することで、squarecloud.app の START フィールドで npx deno を使用して Deno でアプリケーションを起動できます。START の例については、下の「アプリケーションの起動」セクションを参照してください。
  • 次に、Square Cloud のアカウントを作成する必要があります。これはログインページから行えます。アカウントの作成には、メール、GitHub、またはその両方を使用できます。
  • 最後に、アカウントで有効な有料プランを利用している必要があります。プランを確認し、ニーズに合わせて購入するにはこちらをご覧ください。

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

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

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

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

​
▶️ アプリケーションの起動方法

  • Square Cloud の Node.js 環境で Deno ランタイムを使用するには、まずプロジェクトに deno パッケージを追加し（例: npm install deno）、ランタイム環境で npx deno コマンドが利用できるようにします。
  • 次に、squarecloud.app の START フィールドに、Deno を使用してアプリケーションを起動するコマンドを設定します。例:
OR .config
START=npx deno run --allow-net --allow-env main.ts
deno.json で定義されたタスクを使用する場合は、次のように起動できます。 
START=npx deno task start
  • アプリケーションのニーズに応じて権限（--allow-net、--allow-env、--allow-read など）を調整してください。
  • 注意: START フィールドが定義されている場合、その値が直接実行されます。設定ファイルのパラメータの詳細については、設定パラメータを参照してください。
  • Deno で npm モジュールを使用しており、node_modules フォルダが存在しない場合、Square Cloud は npm install --no-package-lock --no-audit --no-fund を実行して依存関係をインストールし、.npm フォルダをクリーンアップします。
Deno をランタイムとして使用する予定がある場合は、deploy 時にランタイム環境で npx deno が利用できるようにするため、deno を依存関係として追加すること（npm install deno）を推奨します。ネイティブの Deno インストーラーの使用を好むプロジェクトでは、このアプローチを選択する前に互換性とビルド要件を確認してください。

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

​
📁 必須の設定ファイル

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

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

  • node_modules: npm モジュールを使用する場合にのみ必要です。それ以外の場合は、アップロードサイズを削減するためにアップロードしないでください。
  • package-lock.json: npm の使用が検出された場合、本番環境は package.json に基づいて依存関係をインストールします。
  • deno_dir または .cache/deno: Deno のキャッシュディレクトリで、deploy には不要です。

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

プロジェクトをアップロードする前に node_modules、package-lock.json、および Deno キャッシュを除外する理由はいくつかあります。
  1. インストールの一貫性: node_modules をアップロードしないことで、依存関係が本番環境によってインストールされ、ローカルシステムの差異のない一貫したビルドが得られます。
  2. 最新のインストール: 本番環境は package.json に記載された依存関係の最新の互換バージョンをインストールするか（該当する場合）、deno.json で定義されたリモートインポートを使用します。
  3. アップロードサイズの削減: これらのディレクトリを含めないことでアップロードするファイルサイズが小さくなり、アップロードプロセスが高速化され、deploy がより効率的になります。
これを行うことで、Deno アプリケーションが Square Cloud でのホスティングに最適な形で準備されます。

​
📄 必須ファイル

Deno プロジェクトをホストするには 3 つのファイルが必要です。
  • squarecloud.app/.config
  • mainFile.ts/.js（メインファイルの例）
  • deno.json または deno.jsonc（権限とタスクの定義）。npm モジュールを使用する場合は、package.json も含めてください。

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

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

​
📤 プロジェクトのホスティング方法

Deno プロジェクトのすべてのファイルを準備できたので、次のステップはそれらを 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>

​
お問い合わせ

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