Bun のアプリやボットをデプロイ

​

始める前に

• 手元のマシンに Bun。公式の Bun インストーラーか、npm パッケージ (npm install bun) でインストールします。
• Square Cloud のアカウント。メールアドレスまたは GitHub で登録できます。
• 有効なプラン。プランを確認し、プロジェクトに合うものを選んでください。

​

Square Cloud の設定

npm install bun

RUNTIME=nodejs
START=npx bun index.ts
MEMORY=256
VERSION=recommended
DISPLAY_NAME=My bot

RUNTIME=nodejs
START=npx bun index.ts
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My website
SUBDOMAIN=mywebsite

​

Square Cloud が実行する内容

• START は直接実行されます。設定ファイルのパラメータの詳細については、設定パラメータを参照してください。
• アプリに node_modules フォルダがない場合、Square Cloud は起動前に npm install --no-audit --no-fund を実行し、bun もインストールします。ランタイムが NODE_ENV=production を設定するため、devDependencies のパッケージはインストールされません。node_modules がすでに存在する場合、インストールの手順はスキップされます。

​

ウェブサイトと API のポートとホスト

Bun.serve({
  fetch() {
    return new Response("Hello, World!");
  },
});

​

プロジェクトの準備

​

必要なファイル

• ZIP のルートに置いた squarecloud.app。
• エントリーファイル。たとえば index.ts。
• dependencies に bun を記載した package.json。これがないアップロードは INVALID_DEPENDENCY で失敗します。

​

含めないもの

• node_modules: Square Cloud はアップロードからこのフォルダを削除し、初回起動時に package.json から依存関係をインストールします。
• ロックファイル: 依存関係は npm でインストールされるため、bun.lock は使用されません。CLI と VS Code 拡張機能も、デフォルトで package-lock.json、yarn.lock、pnpm-lock.yaml を除外します。package-lock.json の正確なバージョンが必要な場合は、squarecloud.ignore に !package-lock.json を追加して含めてください。

​

トラブルシューティング

​

デプロイ

​

ダッシュボード経由

1

アップロードページにアクセス

アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。

2

環境を設定

zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。

3

プロジェクトをデプロイ

最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。

4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。

アプリが起動しませんか？よくある原因と修正方法はトラブルシューティングガイドを参照してください。

​

CLI 経由

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

次のステップ

​

お問い合わせ