cloud-setup

クラウド環境のセットアップ

Elastic Cloud の認証と設定を行います。その他すべての cloud/* スキルは、このセットアップに依存します。

ワークフロー

Setup Progress:
- [ ] Step 1: Verify API key
- [ ] Step 2: Set defaults
- [ ] Step 3: Validate connection

ステップ 1：API キーを確認する

EC_API_KEY がすでに設定されているか確認します。

echo "${EC_API_KEY:?Not set}"

設定されていない場合は、設定するようユーザーに案内します。API キーをチャットに貼り付けるようユーザーに求めてはいけません。シークレットを会話履歴に残してはいけません。

ユーザーが Elastic Cloud アカウントをまだ持っていないと伝えた場合は、Elastic Cloud の無料トライアルの開始を提案します。このトライアルでは、クレジットカード不要で Elastic Cloud Serverless を 14 日間、すべての機能を利用できます。ユーザーが登録してログインしたら、以下の API キー生成に進みます。

次の手順を案内します。

1. Elastic Cloud API キーでキーを生成します。Cloud API キーの作成と管理ができるのは、組織のオーナーのみです。
2. このキーを作成する際は、サーバーレスプロジェクトの作成と管理ができるよう、Project Admin以上（Org Owner）の権限を付与します。
3. プロジェクトのルートに .env ファイルを作成します（推奨 — サンドボックス化されたエージェントのシェルでも動作します）。

EC_API_KEY=your-api-key

すべての cloud/* スクリプトは、作業ディレクトリから .env を自動で読み込むため、手動で読み込む必要はありません。

代わりに、ターミナルで直接エクスポートすることもできます。

export EC_API_KEY="your-api-key"

ターミナルでエクスポートした値は、別のシェルセッションで実行されているサンドボックス化されたエージェントから見えない場合があります。エージェントを使用する場合は、.env ファイルを推奨します。

開発環境ではシークレットをローカルファイルに保存しても問題ありませんが、本番環境や共有環境では、シークレットの分散を避けるため、集中管理型のシークレットマネージャー（HashiCorp Vault、AWS Secrets Manager、1Password CLI など）を使用するようユーザーに伝えます。

ステップ 2：デフォルトを設定する

ベース URL とデフォルトのリージョンをエクスポートします。

export EC_BASE_URL="https://api.elastic-cloud.com"
export EC_REGION="gcp-us-central1"

別のリージョンを希望するかユーザーに尋ねます。利用可能なリージョンを一覧表示するには、次を実行します。

curl -s -H "Authorization: ApiKey ${EC_API_KEY}" \
  "${EC_BASE_URL}/api/v1/serverless/regions" | python3 -m json.tool

ステップ 3：接続を検証する

リージョンのエンドポイントを呼び出して、API キーが機能することを確認します。

curl -sf -H "Authorization: ApiKey ${EC_API_KEY}" \
  "${EC_BASE_URL}/api/v1/serverless/regions" > /dev/null && echo "Authenticated." || echo "Authentication failed."

検証に失敗した場合は、次の点を確認します。

• API キーが有効で、期限切れではないこと
• api.elastic-cloud.com へのネットワーク接続

例

初回セットアップ

User: set up my cloud environment
Agent: Check if EC_API_KEY is set in your terminal. If not, generate a key at
       https://cloud.elastic.co/account/keys and run:
       export EC_API_KEY="your-key"
       Then confirm and I'll validate the connection.

カスタムリージョンでのセットアップ

User: set up cloud with eu region
Agent: [runs setup, sets EC_REGION to user's preferred EU region]

ガイドライン

• チャットで API キー、パスワード、その他の認証情報を受け取ったり、復唱したり、ログに記録したりしてはいけません。ターミナルまたはファイルを直接使用して、シークレットを管理するようユーザーに案内します。
• キーの設定後は、必ず接続を検証します。
• デフォルトのリージョンは gcp-us-central1 です。ユーザーから別のリージョンを希望された場合にのみ変更します。
• このスキルは前提条件です。EC_API_KEY が設定されていない場合、その他のクラウドスキルはこのページを参照してください。

環境変数

変数	必須	説明
EC_API_KEY	はい	Elastic Cloud API キー
EC_BASE_URL	いいえ	Cloud API のベース URL（デフォルト：https://api.elastic-cloud.com）
EC_REGION	いいえ	デフォルトのリージョン（デフォルト：gcp-us-central1）

トラブルシューティング

問題	解決方法
401 Unauthorized	API キーが無効か期限切れです — 新しいキーを生成します
connection refused	api.elastic-cloud.com へのネットワークアクセスを確認します