サンドボックスのネットワーキング

生成AIプロジェクトのサンドボックスのアウトバウンド・ネットワーク・アクセスを構成します。

プロジェクトのサンドボックスを有効にするときに、ネットワーク構成を選択します。そのプロジェクトのすべてのサンドボックスは、同じアウトバウンド・ネットワーク構成を使用します。ネットワーク・モードおよびウォーム・プール・タイプは、独立した選択です。

管理されたネットワーク

管理対象ネットワークでは、サービスはアウトバウンド・ネットワーク・パスを管理します。プロジェクトのネットワークポリシーを使用して、すべてのアウトバウンドアクセスを許可したり、アウトバウンドアクセスを拒否したり、選択したドメインを許可したりします。

CLIクイック・スタートでは、ALLOW_ALLを使用します。ワークロードに必要なポリシーを明示的に選択します。ドメインを制限する場合は、依存関係をダウンロードしたり、外部サービスを呼び出すために必要な宛先を含めます。

カスタムネットワーキング

カスタム・ネットワーキングでは、アウトバウンド・トラフィックは指定したプライベート・サブネットを使用します。準備:

  • プロジェクトと同じリージョン内のプライベート・サブネット。
  • 宛先に到達するために必要なルート、DNS、セキュリティ・リストおよびゲートウェイまたはプライベート接続。
  • オプションで、サブネットと同じVCN内の最大5つの一意のネットワーク・セキュリティ・グループ。
  • サブネットおよび選択したNSGを使用する呼出し側の権限。
Allow group <group-name> to use subnets in compartment <network-compartment-name>
Allow group <group-name> to use network-security-groups in compartment <network-compartment-name>

NSGを使用する場合のみ、NSGポリシーを適用します。これらのポリシーを、ネットワーク・リソースを含むコンパートメントにスコープ指定します。

コンソールで、「ネットワーキング・モード」で「カスタム」を選択します。「サブネットOCID」を入力します。NSGを追加するには、「ネットワーク・セキュリティ・グループ・タグの追加」を選択し、そのOCIDを入力します。Sandbox Configurationを参照してください。

APIまたはCLIの場合は、このsandboxConfig構造を使用します。sandbox-config.jsonとして保存し、プレースホルダを置き換えます。

{
  "isEnabled": true,
  "sandboxOutboundNetworkingConfig": {
    "networkMode": "CUSTOM",
    "subnetId": "SUBNET_OCID",
    "nsgIds": ["NSG_OCID"]
  }
}

NSGをアタッチしない場合は、nsgIdsを省略します。管理対象networkPolicy設定は、カスタム・ネットワーキングには適用されません。VCNはアウトバウンド・アクセスを制御します。

profile_name="DEFAULT"
region="us-chicago-1"
compartment_id="COMPARTMENT_OCID"

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai generative-ai-project create \
  --compartment-id "$compartment_id" \
  --display-name custom-network-sandbox-project \
  --sandbox-config file://sandbox-config.json

サンドボックスを作成する前に、プロジェクトがACTIVEになるまで待機します。返されたプロジェクトOCIDを、「サンドボックスの作成および使用」のサンドボックス作成コマンドとともに使用します。

重要

別のカスタム・サブネットまたはNSGセットを使用するには、別のプロジェクトを作成します。

公開済みポート

ポートを公開すると、サンドボックスで実行されているサービスが、返されたURLでアクセスできるようになります。これは、サンドボックスの作成時に構成され、プロジェクトのアウトバウンド・ネットワーク設定とは別のものです。

重要

公開されたポート・エンドポイントでは、OCIサインインまたはアプリケーション認可は追加されません。サンドボックスの実行中にURLを持つユーザーは、アプリケーションが独自の認証および認可を提供しないかぎり、サービスにアクセスできます。URLを機密として扱います。

「公開されたポートでのサービスの実行」を参照してください。