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

はじめに

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

前提条件

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

プロジェクトの作成

Slack ボットを作成するには、Slack でアプリを作成するためのアカウントと権限が必要です。次の手順に従う前に、https://slack.com/ でアカウントを作成またはアクセスしてください。

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

  1. Slack API - Your Apps にアクセスし、「Create New App」をクリックします。
  2. 「From scratch」を選択し、アプリに名前を付け、インストールする workspace を選択します。
  3. (「Basic Information」にある) Signing Secret をメモし、「OAuth & Permissions」セクションで Bot Token を作成して、ボットに適切なスコープ (例: chat:writechannels:readcommandsapp_mentions:read) を追加します。
セキュリティ: Signing Secret や Bot Token を公開しないでください。これらは機密性の高い認証情報として扱ってください。

プロジェクトの開発

選択する言語に応じて、以下のセクションを使用してください。どちらの例も、メンションや簡単なコマンドに応答するボットを示しています。
Node.js 環境のセットアップ
  1. Node.js がインストールされていることを確認してください。
  2. プロジェクトを初期化し、依存関係をインストールします。
Terminal
npm init -y
npm install @slack/bolt
  1. 次の内容の index.js ファイルを作成します。
index.js
const { App } = require('@slack/bolt');

const app = new App({
  signingSecret: process.env.SLACK_SIGNING_SECRET,
  token: process.env.SLACK_BOT_TOKEN,
});

// Responds when mentioned
app.event('app_mention', async ({ event, say }) => {
  await say(`<@${event.user}> Thanks for mentioning me!`);
});

// Example slash command
app.command('/hello', async ({ ack, respond }) => {
  await ack();
  await respond('Hello from Square Cloud!');
});

(async () => {
  await app.start(process.env.PORT || 3000);
  console.log('⚡️ Slack Bolt app is running!');
})();
注意: Square Cloud では、アプリケーションパネルで環境変数 SLACK_SIGNING_SECRETSLACK_BOT_TOKEN を設定してください。

デプロイ

プロジェクトファイルの準備ができたら、それらを 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. Slack App パネルの「OAuth & Permissions」で、アプリを workspace にインストールします。
  2. ボットが (イベントやコマンド用の) エンドポイントを公開している場合は、「Event Subscriptions」と「Slash Commands」の Request URL を、アプリケーションの公開 URL を指すように設定します (Square Cloud はデプロイ後にドメインを提供します)。
  3. チャンネルでのメンションや /hello コマンドをテストして、応答を検証します。
インストールリンクの例 (client_id を置き換えてください):
https://slack.com/oauth/v2/authorize?client_id=000000000000.000000000000&scope=commands,chat:write,app_mentions:read

追加リソース

さらに詳しく知りたい場合は、Slack 公式ドキュメントをご確認ください。

お問い合わせ

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