RDS Supabase のサンドボックスは、e2b SDK を介して安全で分離されたコード実行を提供します。 エッジファンクションは、Supabase インスタンス内の Deno ランタイムでサーバーサイド TypeScript を実行します。
前提条件
-
RDS Supabase インスタンスが実行中 状態であること。
-
インスタンスが、中国 (北京) 、中国 (上海) 、中国 (杭州) 、中国 (深圳) 、または中国 (成都) リージョンにあること。
-
AliyunServiceRoleForRDSAISupabaseサービスリンクロールが承認されます。
課金
サンドボックスとエッジファンクションは、パブリックプレビュー 期間中、無料で利用できます。
サンドボックスとエッジファンクションの有効化
-
RDS コンソールにログインします。左側のナビゲーションペインで、[AI アプリケーション開発 Supabase] をクリックします。
-
上部メニューで、リージョンを選択します。 対象のインスタンス ID をクリックします。
-
左側のナビゲーションペインで、[サンドボックスとエッジ関数]をクリックします。
-
[サンドボックスとエッジファンクションを有効にする] スイッチをオンにします。
利用可能なサンドボックスのテンプレートが表示されます。
サンドボックスの使用
サンドボックスは e2b SDK を介して安全で分離されたコード実行を提供し、ファイル操作、コマンド実行、コード実行をサポートします。 サンドボックスを使用する前に、ドメイン名をバインドし、SDK 環境を設定する必要があります。
ステップ 1:ドメイン名のバインド
ドメイン名を Supabase インスタンスの IP アドレスに紐付けます。開発およびテスト用には、これをローカルの /etc/hosts ファイルに追加します。
-
インスタンス詳細ページで、パブリックエンドポイントの IP アドレスを確認します。
-
ローカルの
/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 の取得とサンドボックスの作成
-
インスタンスの [サンドボックスとエッジファンクション] ページで、[サンドボックステンプレート] テーブルを見つけ、対象テンプレートの [テンプレート ID] をコピーします。
-
プロジェクトコードで、ステップ 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 つのエッジファンクションを作成できます。
-
Agent Runtime コンソールの左側メニューで、[ファンクション] をクリックします。
-
右上隅にある [新しいファンクションのデプロイ] をクリックします。
-
[新しいエッジファンクションの作成] ページで、ファンクションコードを記述します。
以下に、エッジファンクションの簡単な例を示します:
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' } } ); }); -
ページの下部で、[ファンクション名] フィールドに名前を入力し、[ファンクションのデプロイ] をクリックします。
エッジファンクションの管理
ファンクション名をクリックして、その詳細ページを開きます。 利用可能な操作は次のとおりです:
-
コードの表示と編集: [コード] タブでコードを編集し、[更新のデプロイ] をクリックします。
-
ファンクション設定の構成: [設定] タブで、ファンクション名を変更するか、VERIFY JWT を切り替えます。
-
ファンクションの削除: [設定] タブで Danger Zone に移動し、[ファンクションの削除] をクリックします。
警告この操作は元に戻せません。 慎重に実行してください。
シークレットの管理
シークレットは、API キーやデータベース接続文字列などの機密データを保存し、エッジファンクションで使用します。
-
Agent Runtime コンソールの左側メニューで、[シークレット] をクリックします。
-
右上隅にある [新しいシークレットの追加] をクリックします。
-
シークレットの名前と値を入力します。
システムによって、SUPABASE_URL、SUPABASE_ANON_KEY、SUPABASE_SERVICE_ROLE_KEY、SUPABASE_DB_URL、および SUPABASE_PUBLIC_URL というデフォルトのシークレットが作成されます。これらは、コード内で Deno.env.get('SECRET_NAME') を使用して取得できます。