Container Compute Service:マルチテナンシー管理

概要

ack-sandbox-manager は、API キーとチームを管理するための E2B 互換の HTTP インターフェースセットを提供します。クラスター管理者とテナントは、これらのインターフェースを使用して、プログラムで API キーを作成し、チームをクエリし、未使用のキーを失効させることができます。

これらのインターフェースには、対応する E2B SDK や Kubernetes カスタムリソース定義 (CRD) はありません。HTTP 経由で直接呼び出す必要があります。

前提条件

• 対象のクラスターの アドオン管理 に移動し、ack-sandbox-manager がインストールされ、v0.6.0 以降にアップグレードされていることを確認します。その後、アドオンの 設定 ページで次の設定を構成します:

  • [E2B_API_KEY 認証を有効にするかどうか] を選択して、API キー認証を有効化します。

  • [adminApiKey] (管理者 API キー) を設定します。

エンドツーエンドの例

1. kubectl を使用して ACK クラスターに接続します。

2. JSON プロセッサー jq をインストールします。

3. 次のスクリプトは、管理者がリソース環境とテナント認証情報を初期化してから、テナントがチームキーのライフサイクル全体を独立して管理するまでの、完全なエンドツーエンドのプロセスを示しています：

   #!/usr/bin/env bash
   set -euo pipefail
   
   ADMIN_KEY="${ADMIN_KEY:?required}"
   # 2 つのプロトコルがサポートされています。この例では、ネイティブ E2B プロトコルエンドポイントを使用します： https://api.your.domain.com
   # Agent Sandbox プライベートプロトコルを使用するには、BASE_URL を https://your.domain.com/kruise/api に置き換えます。
   BASE_URL="${BASE_URL:-https://api.your.domain.com}"
   TEAM_NAMESPACE="team-a"
   
   # 1. クラスター内で、管理者がチームの Namespace を作成します
   kubectl create ns "${TEAM_NAMESPACE}"
   
   # 2. 管理者が team-a のテナントキーを作成し、返されたプレーンテキストキーを記録します
   TENANT_KEY=$(curl -fsS -X POST \
     -H "X-API-KEY: ${ADMIN_KEY}" \
     -H "Content-Type: application/json" \
     -d "{\"name\":\"ci-runner\",\"teamName\":\"${TEAM_NAMESPACE}\"}" \
     "${BASE_URL}/api-keys" | jq -r '.key')
   
   # 3. テナントが自身のチームと既存のキーをリスト表示します
   curl -fsS -H "X-API-KEY: ${TENANT_KEY}" "${BASE_URL}/teams"
   curl -fsS -H "X-API-KEY: ${TENANT_KEY}" "${BASE_URL}/api-keys"
   
   # 4. テナントが teamName フィールドなしで、自身のチームのサブキーを作成します
   SUB_KEY_ID=$(curl -fsS -X POST \
     -H "X-API-KEY: ${TENANT_KEY}" \
     -H "Content-Type: application/json" \
     -d '{"name":"my-sub-key"}' \
     "${BASE_URL}/api-keys" | jq -r '.id')
   
   # 5. テナントが自身のチームのサブキーを削除します
   curl -fsS -X DELETE \
     -H "X-API-KEY: ${TENANT_KEY}" \
     "${BASE_URL}/api-keys/${SUB_KEY_ID}"

API リファレンス

curl -fsS \
  -H "X-API-KEY: ${E2B_API_KEY}" \
  "https://api.your.domain.com/teams"

import os
import requests

resp = requests.get(
    "https://api.your.domain.com/teams",
    headers={"X-API-KEY": os.environ["E2B_API_KEY"]},
    timeout=10,
)
try:
    resp.raise_for_status()
except requests.HTTPError:
    print(resp.text)
    raise
print(resp.json())

[
  {
    "teamID": "550e8400-e29b-41d4-a716-446655449999",
    "name": "admin",
    "apiKey": "",
    "isDefault": true
  }
]

curl -fsS \
  -H "X-API-KEY: ${E2B_API_KEY}" \
  "https://api.your.domain.com/api-keys"

import os
import requests

resp = requests.get(
    "https://api.your.domain.com/api-keys",
    headers={"X-API-KEY": os.environ["E2B_API_KEY"]},
    timeout=10,
)
try:
    resp.raise_for_status()
except requests.HTTPError:
    print(resp.text)
    raise
for key in resp.json():
    print(key["id"], key["name"], key["mask"])

curl -fsS -X POST \
  -H "X-API-KEY: ${E2B_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"name": "ci-runner", "teamName": "team-a"}' \
  "https://api.your.domain.com/api-keys"

import os
import requests

resp = requests.post(
    "https://api.your.domain.com/api-keys",
    headers={
        "X-API-KEY": os.environ["E2B_API_KEY"],
        "Content-Type": "application/json",
    },
    json={"name": "ci-runner", "teamName": "team-a"},
    timeout=10,
)
try:
    resp.raise_for_status()
except requests.HTTPError:
    print(resp.text)
    raise
created = resp.json()
# created["key"] を直ちに永続化してください。再度取得することはできません。
print(created["id"], created["key"])

API_KEY_ID="<uuid-from-list-api-keys>"
curl -fsS -X DELETE \
  -H "X-API-KEY: ${E2B_API_KEY}" \
  "https://api.your.domain.com/api-keys/${API_KEY_ID}"

import os
import requests

api_key_id = "<uuid-from-list-api-keys>"
resp = requests.delete(
    f"https://api.your.domain.com/api-keys/{api_key_id}",
    headers={"X-API-KEY": os.environ["E2B_API_KEY"]},
    timeout=10,
)
# 成功したリクエストは 204 No Content を返します。
try:
    resp.raise_for_status()
except requests.HTTPError:
    print(resp.text)
    raise

エラーコード

エラーレスポンスボディは JSON であり、問題の特定に役立つ code、message、request_id フィールドが含まれています：

{
  "code": 403,
  "message": "You are not allowed to create an API key for another team",
  "request_id": "c42c84d8-8420-4194-b48d-5bc5c8fe4ed6"
}