すべてのプロダクト
Search
ドキュメントセンター

:サンドボックスとエッジファンクションの使用

最終更新日:Jun 30, 2026

RDS Supabase のサンドボックスは、e2b SDK を介して安全で分離されたコード実行を提供します。 エッジファンクションは、Supabase インスタンス内の Deno ランタイムでサーバーサイド TypeScript を実行します。

前提条件

  • RDS Supabase インスタンスが実行中 状態であること。

  • インスタンスが、中国 (北京) 、中国 (上海) 、中国 (杭州) 、中国 (深圳) 、または中国 (成都) リージョンにあること。

  • AliyunServiceRoleForRDSAISupabase サービスリンクロールが承認されます。

課金

サンドボックスとエッジファンクションは、パブリックプレビュー 期間中、無料で利用できます。

サンドボックスとエッジファンクションの有効化

  1. RDS コンソールにログインします。左側のナビゲーションペインで、[AI アプリケーション開発 Supabase] をクリックします。

  2. 上部メニューで、リージョンを選択します。 対象のインスタンス ID をクリックします。

  3. 左側のナビゲーションペインで、[サンドボックスとエッジ関数]をクリックします。

  4. [サンドボックスとエッジファンクションを有効にする] スイッチをオンにします。

    利用可能なサンドボックスのテンプレートが表示されます。

サンドボックスの使用

サンドボックスは e2b SDK を介して安全で分離されたコード実行を提供し、ファイル操作、コマンド実行、コード実行をサポートします。 サンドボックスを使用する前に、ドメイン名をバインドし、SDK 環境を設定する必要があります。

ステップ 1:ドメイン名のバインド

ドメイン名を Supabase インスタンスの IP アドレスに紐付けます。開発およびテスト用には、これをローカルの /etc/hosts ファイルに追加します。

  1. インスタンス詳細ページで、パブリックエンドポイントの IP アドレスを確認します。

  2. ローカルの /etc/hosts ファイルにマッピングを追加します。 ドメイン名として <instance-id>.sb.rds.com を使用する例:

    <instance-ip-address> <instance-id>.sb.rds.com

ステップ 2:e2b SDK パッチコードのダウンロード

GitHub からe2b SDK パッチコードをダウンロードします。 このパッチは、SDK を RDS Supabase のルーティングに適応させます。

ステップ 3: (オプション) HTTPS アクセスのための SSL 設定

HTTPS 経由でサンドボックスにアクセスするには、Supabase インスタンスに SSL 証明書を設定してください。 RDS Supabase の HTTPS アクセスのための SSL 設定をご参照ください。

SSL を設定した後、次の環境変数を設定してください:

# rootCA.pem は、Supabase インスタンス用に生成された SSL 証明書の CA 証明書です。
export SSL_CERT_FILE="/xxx/rootCA.pem"
export REQUESTS_CA_BUNDLE="/xxx/rootCA.pem"

ステップ 4:e2b SDK 環境変数の設定

e2b SDK が Supabase インスタンスに接続するために、次の環境変数を設定してください。

# E2B_DOMAIN:ステップ 1 でバインドしたドメイン名。
export E2B_DOMAIN=<instance-id>.sb.rds.com

# E2B_API_KEY:Supabase インスタンスのサービスキー。
export E2B_API_KEY=<your_service_key>
説明

サービスキーを取得するには、インスタンス詳細ページの右上隅にある[API キーの取得]をクリックし、表示されたダイアログボックスで[サービスキー]の値をコピーします。

ステップ 5:テンプレート ID の取得とサンドボックスの作成

  1. インスタンスの [サンドボックスとエッジファンクション] ページで、[サンドボックステンプレート] テーブルを見つけ、対象テンプレートの [テンプレート ID] をコピーします。

  2. プロジェクトコードで、ステップ 2 のパッチファイルをインポートし、テンプレート ID を使用してサンドボックスを作成します。

Python と TypeScript の例:

Python

Python 用の e2b SDK を使用して、サンドボックスを作成し、操作を実行します。

import time
from e2b_code_interpreter import Sandbox
from patch_e2b import patch_e2b

# HTTPS を有効にします。 SSL 証明書が設定されていない場合は False に設定します。
patch_e2b(True)

# コンソールから取得したテンプレート ID を使用してサンドボックスを作成します。
sbx: Sandbox = Sandbox.create(
    template="<template-id>",
    timeout=600,
    request_timeout=300
)
print("sandbox_id: " + sbx.sandbox_id)

try:
    # ファイルへの書き込み。
    sbx.files.write("/home/user/test.txt", "Hello from sandbox!")

    # ファイルからの読み取り。
    content = sbx.files.read("/home/user/test.txt")
    print(f"File content: {content}")

    # シェルコマンドの実行。
    result = sbx.commands.run("ls -la /home/user")
    print(f"Exit code: {result.exit_code}")
    print(f"Stdout: {result.stdout}")

    # Python コードの実行。
    time.sleep(1)
    execution = sbx.run_code("print('hello world')")
    print(f"Results: {execution.results}")
    print(f"Logs: {execution.logs}")
finally:
    sbx.kill()
    print("Sandbox closed.")

TypeScript

TypeScript 用の e2b SDK を使用して、サンドボックスを作成し、操作を実行します。

import { patchE2b } from './patchE2b'
import { Sandbox } from '@e2b/code-interpreter'

// HTTPS を有効にします。 SSL 証明書が設定されていない場合は false に設定します。
await patchE2b(true)

// コンソールから取得したテンプレート ID を使用してサンドボックスを作成します。
const sandbox = await Sandbox.create('<template-id>', {
  timeoutMs: 600_000,
  requestTimeoutMs: 300_000,
})
console.log(`sandbox_id: ${sandbox.sandboxId}`)

try {
  // ファイルへの書き込み。
  await sandbox.files.write('/home/user/test.txt', 'Hello from sandbox!')

  // ファイルからの読み取り。
  const content = await sandbox.files.read('/home/user/test.txt')
  console.log(`File content: ${content}`)

  // シェルコマンドの実行。
  const result = await sandbox.commands.run('ls -la /home/user')
  console.log(`Exit code: ${result.exitCode}`)
  console.log(`Stdout: ${result.stdout}`)

  // Python コードの実行。
  await new Promise(r => setTimeout(r, 1000))
  const execution = await sandbox.runCode("print('hello world')")
  console.log(`Results: ${JSON.stringify(execution.results)}`)
  console.log(`Logs: ${JSON.stringify(execution.logs)}`)
} finally {
  await sandbox.kill()
  console.log('Sandbox closed.')
}

エッジファンクションの使用

エッジファンクションは、Deno ランタイムでサーバーサイド TypeScript を実行します。 Agent Runtime コンソールを使用して、エッジファンクションの作成、デプロイ、管理、およびシークレットを設定します。

Agent Runtime コンソールへのアクセス

次の URL で Agent Runtime コンソールを開きます:

http://<supabase-instance-public-endpoint>/agent-runtime
説明

パブリックエンドポイントは、インスタンス詳細ページの [ネットワーク情報] セクションにあります。

エッジファンクションのデプロイ

説明

各 Supabase インスタンスに対して最大 5 つのエッジファンクションを作成できます。

  1. Agent Runtime コンソールの左側メニューで、[ファンクション] をクリックします。

  2. 右上隅にある [新しいファンクションのデプロイ] をクリックします。

  3. [新しいエッジファンクションの作成] ページで、ファンクションコードを記述します。

    以下に、エッジファンクションの簡単な例を示します:

    import "jsr:@supabase/functions-js/edge-runtime.d.ts";
    
    interface reqPayload {
      name: string;
    }
    
    Deno.serve(async (req: Request) => {
      const { name }: reqPayload = await req.json();
      const data = {
        message: `Hello ${name}!`,
      };
      return new Response(
        JSON.stringify(data),
        { headers: { 'Content-Type': 'application/json' } }
      );
    });
  4. ページの下部で、[ファンクション名] フィールドに名前を入力し、[ファンクションのデプロイ] をクリックします。

エッジファンクションの管理

ファンクション名をクリックして、その詳細ページを開きます。 利用可能な操作は次のとおりです:

  • コードの表示と編集: [コード] タブでコードを編集し、[更新のデプロイ] をクリックします。

  • ファンクション設定の構成: [設定] タブで、ファンクション名を変更するか、VERIFY JWT を切り替えます。

  • ファンクションの削除: [設定] タブで Danger Zone に移動し、[ファンクションの削除] をクリックします。

    警告

    この操作は元に戻せません。 慎重に実行してください。

シークレットの管理

シークレットは、API キーやデータベース接続文字列などの機密データを保存し、エッジファンクションで使用します。

  1. Agent Runtime コンソールの左側メニューで、[シークレット] をクリックします。

  2. 右上隅にある [新しいシークレットの追加] をクリックします。

  3. シークレットの名前と値を入力します。

説明

システムによって、SUPABASE_URL、SUPABASE_ANON_KEY、SUPABASE_SERVICE_ROLE_KEY、SUPABASE_DB_URL、および SUPABASE_PUBLIC_URL というデフォルトのシークレットが作成されます。これらは、コード内で Deno.env.get('SECRET_NAME') を使用して取得できます。