はじめに
Square Cloud で を開発してホストするには、構成と前提条件の体系的な手順に従うことが不可欠です。この技術ガイドでは、初期セットアップから本番環境へのデプロイまで、プロセス全体を解説します。前提条件
- Square Cloud アカウント: 登録ページからメールアドレスを使って登録します。
- 有効な有料プラン: アプリケーションに専用リソースと最適化されたパフォーマンスを提供します。利用可能なプランを確認し、ニーズに最も適したものを選択してください。
プロジェクトの作成
認証とボットの動作には、アクティブな X (Twitter) アカウントが必要です。アカウントをお持ちでない場合は、X 公式サイトで登録してください。API にアクセスするには、X Developer アカウントも必要です。X Developer Portal からアクセスをリクエストしてください。
X 上でのボットアプリケーション
Developer Portal へのアクセス
- X Developer Portal にアクセスします。
- X (Twitter) アカウントでログインします。
- 初めての場合は、開発者アクセスのリクエスト手続きを完了してください。
プロジェクトの作成
- ダッシュボードで「Create Project」をクリックします。
- プロジェクトの名前を選びます(例: 「Square Cloud Bot」)。
- 最も適切なユースケースを選択します(例: 「Making a bot」)。
- ボットの詳細な説明を入力します。
- プロジェクトの作成を確定します。
アプリケーションのセットアップ
- 作成したプロジェクト内で「Create App」をクリックします。
- アプリケーションに一意の名前を定義します。
- アプリケーションの作成を確定します。
- 生成された App ID を今後の参照用に記録しておきます。
API キーの生成
- アプリケーションの「Keys and tokens」セクションに移動します。
- 「Consumer Keys」セクションで「Regenerate」をクリックして、以下を生成します:
- API Key (Consumer Key)
- API Secret Key (Consumer Secret)
- 重要: これらのキーは再表示できないため、すぐにコピーして保存してください。
権限の設定
- 「App permissions」セクションに移動します。
- 「Edit」をクリックして権限を変更します。
- ボットがツイートを投稿できるように「Read and write」を選択します。
- 必要に応じて、DM 機能のために「Read and write and Direct message」を選択します。
- 変更を保存します。
アクセストークンの生成
- 「Keys and tokens」セクションに戻ります。
- 「Access Token and Secret」セクションで「Generate」をクリックします。
- トークンの生成を確定します。
- 以下をコピーして保存します:
- Access Token
- Access Token Secret
- 警告: これらのトークンはページを閉じた後は再表示できません。
プロジェクトの開発
- Node.js の確認: Node.js がシステムにインストールされていることを確認してください。ない場合は、Node.js 公式サイトからダウンロードしてください。
- プロジェクトの初期化: 次のコマンドを実行して、新しい Node.js プロジェクトを作成します:
Terminal
- 依存関係のインストール: ボットに必要なライブラリをインストールします:
Terminal
- 環境変数のセットアップ: 認証情報を安全に保存するために
.envファイルを作成します:
.env
- メインファイルの作成: ボットの基本構造を含む
index.jsファイルを作成します:
index.js
デプロイ
プロジェクトファイルの準備が完了したら、それらを Square Cloud にアップロードしてプロジェクトをホスティングできます。 そのためには、すべてのプロジェクトファイルを含む ZIP ファイルを作成してください。環境変数
環境変数
セキュリティ: API 認証情報をコードに直接記述しないでください。Square Cloud では必ず環境変数を使用してください。
API_KEY: あなたの X API キーAPI_SECRET_KEY: あなたの X API シークレットキーACCESS_TOKEN: あなたのアクセストークンACCESS_TOKEN_SECRET: あなたのアクセストークンシークレット
ダッシュボード経由
アップロードページにアクセス
アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
環境を設定
zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
CLI 経由
この方法を使用するには、プロジェクトのルートディレクトリにsquarecloud.app という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。
詳細はこちら: Square Cloud の設定ファイルの作成方法。
squarecloud.app ファイルはアプリケーションを構成するために使用される設定ファイルであり、環境を定義するために使用されます。
CLI をインストール
まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:すでにお持ちの場合は、更新することを推奨します。更新するには、ターミナルで次のコマンドを実行してください:
- Windows
- Linux, macOS, and WSL
認証
次に、認証して他の CLI コマンドを使用するには、こちらで「Request API Key」をクリックして認証キーを取得します。認証キーを取得したら、次のコマンドを実行してください:


