Platform For AI:Instant Service インスタンスの管理

コンソールからの作成

PAI-Instant Service には、インスタンスを作成するための 3 つのコンソールエントリーポイントが用意されています。

1. エントリーポイント 1：Instant Service のワークベンチで、 インスタンスの作成 ボタンをクリックします。

2. エントリーポイント 2： [Private Templates/Public Templates] リストで、対象のテンプレートの インスタンスの作成 アクションを選択します。

3. エントリーポイント 3：テンプレートの詳細ページで、 [instance list] の インスタンスの作成 をクリックします。

インスタンスの作成 ダイアログボックスで、以下のパラメーターを設定します。

インスタンスの作成 をクリックしてインスタンスを作成します。

SDK を使用した作成

PAI-Instant Service は E2B SDK とネイティブに互換性があります。使用方法は E2B と同じです。

import os
from e2b import Sandbox

# 認証情報を設定
os.environ["E2B_API_KEY"] = "<YOUR-TOKEN>"
os.environ["E2B_DOMAIN"] = "sandbox01.cn-shanghai.pai-eas.aliyuncs.com"

# インスタンスを作成
sandbox = Sandbox.create(
    template="<YOUR-TEMPLATE-ID>",
    timeout=300000,
)

print(f"Sandbox ID: {sandbox.sandbox_id}")          

[Template Details] ページで、右上の [SDK Access] をクリックすると、SDK 接続設定と Python のサンプルコードが表示されます。API の詳細については、「E2B SDKとの統合」をご参照ください。

インスタンス詳細の表示

Instant Service のワークベンチに移動し、 [instance list] で対象のインスタンスを見つけ、[Actions] 列の [Details] をクリックしてインスタンスの詳細ページを開きます。

インスタンスの詳細ページには、以下の情報が表示されます。

• リソース仕様：CPU、メモリ、ディスク。

• ステータス情報：ステータス (実行中/一時停止中) と稼働時間。

• 基本情報：インスタンス ID、テンプレート、作成時刻、有効期限、RAM ユーザー ID、Alibaba Cloud アカウント ID、アクセストークン。

• メタデータ： sandbox.alicloud.com/service-name や userId などのキーと値のペア。

ターミナルの起動

[Open Terminal] をクリックして Web ターミナルウィンドウを開きます。ターミナルには、インスタンス ID、テンプレート ID、セッションタイムアウト (デフォルトでは、アイドルタイムアウト 10 分、最大 30 分) が表示されます。

ターミナルで直接任意のシェルコマンドを実行できます。これは、SDK を介して sandbox.commands.run() を呼び出すことと同等で、環境のデバッグや検証に役立ちます。

VNC の起動

Desktop タイプのテンプレートの場合、 [Open VNC] をクリックしてリモートデスクトップセッションを開始します。

VNC は、以下のような場合に役立ちます。

• グラフィカルインターフェースを必要とするアプリケーションのデバッグ。

• ブラウザーオートメーション (Playwright、Selenium など) の視覚的な検証。

• GUI テストとスクリーンショットのキャプチャ。

ファイル管理

インスタンスの詳細ページには、ディレクトリツリービューを備えた [File Management] パネルがあります。

• インスタンス内の bin 、 boot 、 code 、 dev 、 etc 、 home などのディレクトリ構造をブラウズできます。

• フォルダーの作成、ファイルのアップロード、ビューの更新、1 つ上の階層への移動、ルートディレクトリへの復帰が可能です。

• ファイルサイズと変更時刻を表示できます。

ファイル管理は、SDK を介して sandbox.files.read() / sandbox.files.write() を呼び出すことと同等で、コンソールを離れることなくランタイムの結果に素早くアクセスできます。

サービス呼び出し

[Service Invocation] パネルは、インスタンス内で実行されているサービスを呼び出すための対話型の HTTP インターフェースを提供します。

設定オプション：

• リクエストメソッド：GET、POST、PUT、DELETE など。

• ポート：インスタンス内のサービスがリッスンしているポート。

• パス：リクエストの URL パス (例： /health) 。

• リクエストヘッダー：カスタム HTTP ヘッダー (例： Content-Type: application/json) 。

• プレビュー URL：システムによって組み立てられた完全なリクエスト URL。コピーして直接使用できます。

[Send Request] をクリックします。右側の [HTTP Interaction History] パネルにリクエストとレスポンスの内容が表示され、リアルタイムでデバッグできます。

リクエストログの表示

[Request Logs] タブに切り替えると、データプレーンを介してインスタンスに転送されたすべての HTTP リクエストを表示できます。これらのログは、監査やトラブルシューティングに使用します。

一時停止と再開

インスタンスを一時停止および再開して、後で復元するために状態を保持したり、テンプレートとして保存したりすることができます。

• 一時停止：インスタンスリストで [Pause] をクリックするか、 sandbox.pause() を呼び出します。インスタンスの状態はインスタンスストレージに永続化されます。

• 再開：インスタンスリストで [Resume] をクリックするか、 Sandbox.connect("<sandbox-id>") を呼び出します。インスタンスは迅速に実行中の状態に復元されます。

テンプレートとして保存

インスタンスの現在の状態 (ファイル、インストール済みの依存関係、実行中のプロセスを含む) を新しいテンプレートとして保存し、環境を再利用できます。

典型的なシナリオ：

• 開発中にコードの変更や環境設定が完了した後、インスタンスをテンプレートとして保存することで、変更のたびにイメージを再ビルドする手間を省けます。

• 完全に設定されたエージェントのランタイム環境を、チームで再利用するための標準テンプレートとしてキャプチャします。

前提条件：Instant Service には、設定済みの [エンタープライズ版イメージのインスタンス] (Standard または Enterprise Edition) が必要です。

手順：

1. テンプレートとして保存したいインスタンスを一時停止します。

2. [Save as Template] をクリックします。

3. 新しいテンプレートの名前と説明を入力します。

4. [OK] をクリックします。システムは現在のインスタンスの状態に基づいて新しいテンプレートを作成します。

インスタンスタイムアウトの延長

タイムアウトは 2 つの方法で延長できます。