インスタントサービスは、PAI-Instant Service における課金および権限の単位です。テンプレートは、インスタンスのランタイム環境を定義します。このトピックでは、インスタントサービス (ワークベンチへのアクセスを含む) の作成と管理方法、およびテンプレート (イメージから、インスタンスから、またはパブリックテンプレートから) の作成と管理方法について説明します。
概要
PAI-Instant Service は、インスタントサービス → テンプレート → インスタンスという 3 層のリソース構造を使用します。このトピックでは、最初の 2 つの層の管理について説明します。全体的なワークフローは次のとおりです。
-
管理者がインスタントサービスを作成:インスタントサービスを作成し、ネットワーク出口モード、リソースタイプ、および (オプションで) イメージリポジトリを選択します。
-
管理者または開発者がテンプレートを作成:インスタントサービス内で、イメージから、インスタンスから、またはパブリックテンプレートからランタイム環境を定義します。
-
エンドユーザーがインスタンスを使用:テンプレートからインスタンスを起動します。詳細については、「インスタントサービスインスタンスの管理」をご参照ください。
3 層リソースモデルの全体像については、「インスタントサービスの概要 — リソース階層」をご参照ください。
インスタントサービスの作成
-
PAI コンソールにログインします。
-
左側のナビゲーションペインで、[Elastic Algorithm Service (EAS)] を選択して、サービスリストページに移動します。
-
上部にある 即時サービス タブに切り替えます。
-
インスタントサービスの作成 をクリックして作成ページに移動します。
-
次のパラメーターを設定します。
パラメーター
説明
[名前]
必須。小文字、数字、アンダースコア (_) を使用できます。小文字で始まる必要があります。最大 36 文字です。
[リソースタイプ]
必須。EAS リソースグループ でインスタントサービスのリソースグループ ID を選択します。
[エンタープライズ版イメージのインスタンス]
オプション。カスタムイメージからテンプレートを作成する場合にのみ必須です。
-
アカウント内の Standard または Premium の ACR Enterprise Edition インスタンスを選択します。テンプレートはこのリポジトリからイメージをプルします。まだ ACR リポジトリを作成していない場合は、ページ上のリンクをクリックして ACR コンソールに移動し、作成します。
-
パブリックテンプレートのみを使用する場合は、このフィールドを空白のままにします。
[カスタム認証]
オプション。有効にすると、サービス API 認証用のカスタムトークンを設定できます。無効にすると、システムは自動的にデフォルトのトークンを生成します。
[送信接続方式]
必須。デフォルトは 共有パブリックネットワーク です。
-
[専用 VPC]:[サービスが VPC に接続され、設定した NAT Gateway を経由してインターネットにアクセスします。イントラネットリソースへのアクセス、カスタムセキュリティグループ、およびネットワークポリシーの使用に適しています。]
-
[隔離モード]:[インスタントサービスは外部ネットワークにアクセスできず、機密データの処理、コンプライアンス隔離など、外部ネットワークを必要としないタスクに適しています。]
-
[共有パブリックネットワーク]:[インスタントサービスは、プラットフォームのパブリックゲートウェイ経由でインターネットにアクセスするため、VPC を設定することなく迅速にステージング環境を構築できます。このパターンでは、帯域幅が複数ユーザーによって共有されるため、SLA と帯域幅の安定性は保証されません。データ転送コストは課金されません。]
-
-
確認 をクリックして作成を完了します。
インスタントサービスワークベンチへのアクセス
作成が完了すると、即時サービス タブのリストで既存のインスタントサービスを表示できます。
呼び出し 列で、即時サービスワークベンチ アイコンをクリックします。即時サービスワークベンチへ移動 ダイアログボックスが表示され、2 種類のアクセスリンクが提供されます。
|
リンクタイプ |
目的 |
権限スコープ |
|
[リンクの管理] |
インスタントサービス、テンプレート、インスタンスの完全な管理用 |
テンプレートとインスタンスの作成、表示、削除 |
|
[読み取り専用リンク] |
インスタントサービス、テンプレート、インスタンスの設定および監視情報の表示用 |
表示のみ — 作成と削除は利用できません |
リンクの管理 と 読み取り専用リンク は、どちらもパブリックネットワーク経由でアクセスできます。リンクの有効期間は 12 時間です。有効期限が切れたら、新しいリンクを生成してください。これらのリンクは安全に保管し、権限のないユーザーと共有しないでください。
リンクの管理 または 読み取り専用リンク の URL をコピーしてブラウザーで開き、インスタントサービスワークベンチにアクセスします。
ワークベンチのアクション
インスタントサービスワークベンチでは、主に 4 つのアクションを実行できます。
-
テンプレートの作成:現在のインスタントサービスに新しいテンプレートを作成します。
-
インスタンスの作成:既存のテンプレートからインスタンスを起動します。
-
モニタリング画面を開く:Grafana ダッシュボードに移動して、サービスレベルでインスタントサービスのメトリクスを表示します。
-
共有:ワークベンチのアクセスリンクを生成してコピーし、チームメンバーと共有します。
ワークベンチの情報
インスタントサービスワークベンチには、次の詳細情報が表示されます。
-
インスタントサービス情報:テンプレート数、総インスタンス数、実行中のインスタンス数。
-
ネットワーク設定:VPC ID、vSwitch ID、セキュリティグループ ID。
-
アカウント情報:RAM ユーザー ID と Alibaba Cloud アカウント ID。
-
イメージ情報:イメージリポジトリのアドレス。
インスタントサービスワークベンチでは、次のビューも提供されます。
-
プライベートテンプレート:現在のインスタントサービスでユーザーが作成したすべてのテンプレート。
-
パブリックテンプレート:プラットフォームが提供するパブリックテンプレート。詳細については、「パブリックテンプレートの使用」をご参照ください。
-
インスタンスリスト:現在のインスタントサービスで実行中または一時停止中のすべてのインスタンス。
テンプレートの作成
テンプレートは、イメージ、起動コマンド、リソース仕様など、インスタンスのランタイム環境を定義します。1 つのインスタントサービスには、異なるランタイム環境用に複数のテンプレートを含めることができます。
テンプレートを作成するには、インスタントサービスの作成時に [エンタープライズ版イメージのインスタンス] (Standard または Premium edition) を設定する必要があります。
手順
-
インスタントサービスワークベンチの右上隅にある [Create template] をクリックします。
-
右側からスライドして表示される [Create new template] パネルで、次のパラメーターを設定します。
パラメーター
必須
説明
テンプレート名
はい
システムがデフォルト名を生成します。カスタマイズ可能です。
テンプレートの説明
いいえ
テンプレートの目的の説明。最大 100 バイトです。
カスタムトークン
いいえ
空白のままにすると、システムはインスタンス認証用のトークンを自動的に生成します。
作成方法
はい
[From image]、[From instance]、[From public template] をサポートしています。詳細については、後述の「3つの作成方法」をご参照ください。
-
[Create template] をクリックします。テンプレートは 「ビルド中」 の状態になります。ビルドが完了すると、ステータスが「準備完了」に変わります。
3つの作成方法
イメージから
コンテナイメージからテンプレートを作成します。標準化されたランタイムイメージがある場合にこの方法を使用します。以下を設定します。
-
イメージアドレス:必須。ACR リポジトリの完全なイメージアドレスを入力します。
-
起動コマンド:インスタンスの起動時に実行されるエントリーコマンド。
-
Readiness コマンド:インスタンスの起動後に実行されるヘルスチェックコマンド。
例:サービスがポート 8000 で実行されている場合、テンプレートを作成する前にサービスが完全に準備できていることを確認します。Readiness コマンドを
curl -f http://localhost:8000に設定して、HTTP ステータスコードを検証します。 -
リソース設定:CPU コア、メモリ (MiB)、ディスク (GiB)、タイムアウト (秒)。デフォルト:2 コア / 2,000 MiB / 30 GiB / 3,600 秒。
-
環境変数:インスタンス内部から見えるキーと値のペア。
インスタンスから
書き込まれたファイル、インストールされた依存関係、実行中のプロセスなど、インスタンスの完全な状態を新しいテンプレートとして保存します。[Instance ID] を入力します。詳細については、「インスタンスの管理 — テンプレートとして保存」をご参照ください。
パブリックテンプレートから
パブリックテンプレートをエンタープライズ ACR インスタンスに保存して、イメージのプルパフォーマンスと信頼性を向上させます。保存したい [public template] を選択します。
テンプレート詳細の表示
ワークベンチの [Private templates] または [Public templates] タブで、テンプレート ID をクリックして詳細ページを開きます。
アクション
-
SDK接続情報の表示:[SDK Access] をクリックして、E2B SDK 経由で呼び出すための接続設定と Python コードサンプルを表示します。ワンクリックで設定をコピーできます。
-
モニタリング画面を開く:テンプレートレベルで Grafana ダッシュボードに移動します。
-
共有:このテンプレートのアクセスリンクを生成してコピーします。
-
インスタンスの作成:このテンプレートから新しいインスタンスを起動します。
テンプレートの詳細
テンプレートの詳細ページには、以下が含まれます。
-
基本情報:テンプレート ID、ENVD バージョン、API トークン、作成時刻、最終更新時刻、RAM ユーザー ID、Alibaba Cloud アカウント ID。
-
リソース仕様:CPU、メモリ、ディスク。
-
環境変数:キーと値のペアのリスト。
-
リポジトリアドレス:このテンプレートに関連付けられている ACR イメージリポジトリ。
-
ビルド情報:ビルドタイプ (例:イメージから)、ソースイメージ、起動コマンド、Readiness コマンド。
-
インスタンスリスト:このテンプレートから作成されたすべてのインスタンス。
次のステップ
-
テンプレートからインスタンスを起動して使用する:「インスタントサービスインスタンスの管理」
-
SDK 経由でインスタンスを作成および呼び出す:「E2B SDKとの連携」
-
シナリオに合わせてパブリックテンプレートを選択する:「パブリックテンプレートの使用」