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

はじめに

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

前提条件

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

プロジェクトの作成

Discord ボットを作成するには、プラットフォーム上でボットを作成・管理するためのアカウントを持っていることが不可欠です。まだお持ちでない場合は、Discord 公式サイト にアクセスしてアカウントを作成してください。

Discord でのボットアプリケーション

アプリケーションの作成

Developer Portal にアクセスし、「New Application」をクリックします。ボットの名前を決めて「Create」をクリックし、アプリケーションを作成します。
Developer Portal で Discord アプリケーションを作成する

認証トークンの生成

アプリケーションを作成した後、「Bot」タブに移動し、「Reset Token」をクリックして認証トークンを生成します。生成されたトークンをコピーし、後でコード実装で使用するために保管してください。
Discord ボットの認証トークンを生成する

特権インテントの有効化

トークンを設定したら、必要なインテントを有効化します。「Bot」タブに留まり、下にスクロールして「Privileged Gateway Intents」を見つけます。画像のようにインテントを有効化してください。
Discord の特権ゲートウェイインテントを有効化する
重要なセキュリティ: ボットのトークンは絶対に秘密にしてください。このトークンはボットの完全な制御権を与えるものであり、機密情報として扱う必要があります。

プロジェクトの開発

ボットのトークンが手に入ったので、コーディングを始められます。お好みの言語を使って行うことができます。
Node.js 環境のセットアップ
  1. システムに Node.js がインストールされていることを確認してください。まだの場合は、Node.js 公式サイト からダウンロードしてください。
  2. 新しい Node.js プロジェクトを初期化します。
Terminal
npm init -y
  1. Discord.js ライブラリをインストールします。
Terminal
npm install discord.js
  1. JavaScript ファイル (例: index.js) を作成し、基本的な Discord ボットを作成するために次のコードを追加します。
index.js
const { Client, GatewayIntentBits } = require("discord.js");

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});

client.on("ready", () => {
  console.log(`${client.user.tag}!`);
});

client.on("messageCreate", (message) => {
  if (message.content === "!hello") {
    message.reply("Hello!");
  }
});

client.login("your token here");

デプロイ

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

ボットのテスト

すべての手順を正しく実行できたら、次のステップはボットをテスト用に招待することです。そのためには、次の手順に従ってください。
  1. Developer Portal にアクセスします。
  2. ボットを選択します。
  3. 「OAuth2」タブに移動します。
  4. 「OAuth2 URL Generator」に進みます。
  5. 「bot」オプションにチェックを入れます。
  6. この招待を使ってボットが招待されたときに持つ権限を選択します。
  7. 権限の下に、ボットの招待リンクが生成されます。次のようになります。
https://discord.com/oauth2/authorize?client_id=00000000000000&permissions=8&scope=bot
URL 内の client_id は、実際のボットの ID に置き換える必要があることを忘れないでください。permissions の値も、ボットに持たせたい権限に基づいて調整が必要な場合があります。 では、すべてが機能しているかテストするために、サーバー上で次のコマンドを実行してください: !hello
デプロイ後に Discord ボットをテストする

追加リソース

discord.py と discord.js でのボット作成に関する詳細については、discord.py 公式ドキュメントdiscord.js 公式ガイド をご覧ください。そこには、これらのライブラリを最大限に活用するための詳細なガイド、チュートリアル、API ドキュメントが用意されています。

お問い合わせ

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