Oracle Cloud Infrastructureドキュメント

アプリケーションの作成

アプリケーションは、スケーリング、マネージド・ストレージ、ネットワーキング、認証など、ホスト・デプロイメントの管理対象ランタイム設定を定義します。このタスクでは、OCI生成AIサービスのOracle Cloudコンソールを使用してアプリケーションを作成する方法について説明します。

「アプリケーション」リスト・ページで、「アプリケーションの作成」を選択します。リスト・ページの検索に関するヘルプが必要な場合は、アプリケーションのリストを参照してください。

基本的な情報

  1. アプリケーションの名前を入力します。
    名前は文字またはアンダースコアで開始し、その後に文字、数字、ハイフンまたはアンダースコアが続きます。長さは1 - 255文字です。
  2. (オプション)アプリケーションに関する説明を入力します。
  3. アプリケーションを作成するコンパートメントを選択します。デフォルト・コンパートメントはリスト・ページと同じですが、作業する権限がある任意のコンパートメントを選択できます。

タグ

  1. (オプション)「タグの追加」を選択し、このアプリケーションにタグを割り当てます。リソース・タグを参照してください。
  2. 「作成」を選択します。

スケーリング

  1. 自動スケーリングでは、ホストされたデプロイメントがロードを処理するためにどのようにスケーリングされるかを定義します。
    • 最小レプリカ

      常に実行する必要があるレプリカの最小数。この値は、最大レプリカ数以下にする必要があります。デフォルトは1です。

    • 最大レプリカ数

      実行可能なレプリカの最大数。負荷が増加すると、この制限まで新しいレプリカが追加されます。デフォルトは3で、最大値は30です。自動スケーリングを無効にするには、この値を「最小レプリカ」に設定します。

  2. スケーリング・メトリックを選択します。
    サービスは、選択したメトリックが構成済ターゲットを超えたときに、最大レプリカ値までレプリカを追加します。
    • CPU使用率(%)

      CPU使用率がこのパーセンテージを超えた場合に、設定した最大レプリカまでレプリカを追加します。範囲: 50–95%。

    • メモリー使用率(%)

      メモリー使用率がこのパーセンテージを超えた場合に、設定した最大レプリカまでレプリカを追加します。範囲: 50–95%。

    • コンカレント要求

      コンカレント要求がこの値を超えた場合に、設定した最大レプリカ数までレプリカを追加します。範囲: 1–500。

    • リクエスト数/秒(RPS)

      1秒当たりのリクエストが構成済ターゲットを超えた場合に、設定した最大レプリカまでレプリカを追加します。

ストレージ(オプション)

アプリケーション内のデプロイメントにサービス管理ストレージが必要な場合は、OCI PostgreSQL、OCI CacheまたはOracle Autonomous AI Databaseを有効にできます。

このアプリケーションに関連付けられたホスト・デプロイメントのマネージド・ストレージを有効にします。マネージド・ストレージはサービスによって作成および管理され、このアプリケーションに関連付けられたホスト・デプロイメントからのみアクセスできます。接続の詳細は、環境変数を使用してコンテナに提供されます。

アプリケーションで管理対象ストレージが必要な場合は、次のいずれかのオプションを有効にします。
  • OCI PostgreSQL

    OCI PostgreSQLを有効にして、このアプリケーションのデプロイメントの管理対象データベースを提供します。

    このオプションの場合:
    • OCI PostgreSQLの接続URIを受け取る環境変数名を入力します。サービスは、指定された環境変数に接続文字列を追加します。
    • ストレージ: ストレージを作成するか、既存のストレージを使用するかを選択します。既存のストレージを選択した場合、アプリケーションはOCI PostgreSQLストレージ・リソースをテナンシ内の他のアプリケーションと共有します。各アプリケーションには専用データベースが割り当てられ、このアプリケーションには専用データベースのみにアクセスする権限があります。
  • OCIキャッシュ
    OCIキャッシュを有効にして、このアプリケーションのデプロイメントにマネージド・キャッシュを提供します。このオプションでは、次のことが行われます。
    • OCIキャッシュの接続URIを受け取る環境変数名を入力します。
    • ストレージ: ストレージを作成するか、既存のストレージを使用するかを選択します。
  • Oracle Autonomous Database
    Oracle Autonomous AI Databaseを有効にして、このアプリケーションのデプロイメントに管理対象データベースを提供します。このオプションでは、次のことが行われます。
    • Autonomous AI Databaseの接続URIを受け取る環境変数名を入力します。
    このサービスは、接続文字列に加えて、データベース・ユーザー資格証明をコンテナ内の次のローカル・ファイルにマウントします。
    /mnt/secrets/adb/username
/mnt/secrets/adb/password

環境

  1. (オプション)デプロイメントの1つ以上の環境変数をキーと値のペアとして入力します。変数ごとに、環境変数名とその値を入力します。アプリケーションに必要な数の変数を追加します。
  2. (オプション)「Vault環境変数」に、次を入力します:
    • 変数の名前
    • ボールトOCID
    • ボールト・キー

    • このサービスは、ボールト情報をJSONファイルとしてコンテナに追加します。JSONコードの例:

      {
    "vaultId":<vault-ocid>,
    "key":<the secret in the vault>
}

ネットワーキング(オプション)

このアプリケーションのデプロイメントでアウトバウンド・トラフィックをルーティングする方法と、クライアントがデプロイメント・エンドポイントにアクセスする方法を選択します。

  1. 「ネットワーキング」で、次のオプションのいずれかを選択します。
    • デフォルト(サービス管理)

      サービス管理ネットワークを介したOCIサービスおよびパブリック・インターネットへのアウトバウンド・アクセスを許可します。

    • カスタム(顧客管理)
      プライベート・エンドポイント接続を使用して、テナンシのVCNおよびサブネットを介してアウトバウンド・トラフィックをルーティングします。このオプションは、プライベートなエンタープライズ統合デプロイメントに推奨されます。このオプションでは、次を選択します。
      • VCNコンパートメント
      • VCN
      • サブネット・コンパートメント
      • サブネット
      ノート

      カスタム・ネットワーキングを選択すると、すべてのエグレス・トラフィックがVCNサブネットにルーティングされます。アプリケーションでインターネット・アクセスも必要な場合は、パブリック・サブネットの使用とルート表の構成を検討してください。インターネット・ゲートウェイに関する項を参照してください。
  2. このアプリケーションのアクティブ・デプロイメントに、パブリック・エンドポイントとプライベート・エンドポイントのどちらからアクセスするかを選択します。
    • パブリック

      VCNの外部からアクセスできます。

    • Private

      VCN内からのみアクセス可能です。

      重要

      生成AIプライベート・エンドポイントを使用する必要があります。ない場合は、生成AIプライベート・エンドポイントを作成します。

      次の情報を選択します。

      • プライベート・エンドポイント・コンパートメント
      • プライベート・エンドポイント

    アプリケーションの作成後、そのFQDNまたはIPアドレスを使用して、このプライベート・エンドポイントを介してアプリケーションにアクセスできます。FQDNの例:

    https://<pe-name>.pe.inference.generativeai.<region>
.oci.oraclecloud.com/20251112/hostedApplications/{your_application_ocid}

認証

次のいずれかの認証方式を選択します。

  • アイデンティティ・ドメインベアラー・トークン: OCI IAMアイデンティティ・ドメインによって発行されたOAuth 2.0アクセス・トークンを使用します。トークンはベアラー・トークンとしてターゲット・サービスに送信され、サービスはリクエストを受け入れる前にトークンを検証します。前提条件として、エージェント・サポートの認証の設定のタスクを実行します。
  • OCI IAM: OCI IAMリクエスト署名認証を使用します。各リクエストは、OCI APIリクエスト署名の要件に従って暗号化して署名されます。
ノート

APIを使用する場合は、InboundAuthConfigでアイデンティティ・ドメイン・ベアラー・トークン認証にCreateHostedApplication APIを使用します。OCI IAM認証を使用するアプリケーションを作成するには、CreateHostedApplicationIamDetailsを指定してCreateHostedApplicationIam APIを使用します。OCI IAM APIには、OAuthまたはIDCS構成は必要ありません。

アイデンティティ・ドメインベアラー・トークンの場合は、次のステップを実行します:

アイデンティティ・ドメインベアラー・トークン

  1. 「認証タイプ」で、「アイデンティティ・ドメインベアラー・トークン」を選択します。
  2. 次のオプションのいずれかを選択します。
    • 既存アイデンティティ・ドメインの選択

      Use the same identity domain in which you created the confidential integrated application in Step 2. Create an Application in the Identity Domain.

      • アイデンティティ・ドメイン・コンパートメント
      • アイデンティティ・ドメイン
    • アイデンティティ・ドメインURLの貼付け

      例: https://idcs-xxx.identity.oraclecloud.com:443

  3. アイデンティティ・ドメインについて、次のパラメータの値を入力します:
    • スコープ

      アクセス・トークンが実行を許可されるアクションを指定します。例: user.read、email。

    • 対象者

      アクセス・トークンの対象となるサービスまたはAPIを指定します。ターゲット・リソース・サーバーがトークンを受け入れるのは、オーディエンス要求がそのサーバーと一致する場合のみです。

      この値を見つけるには、アイデンティティ・ドメイン・コンソールを開き、ステップ2で作成した統合アプリケーションを選択します。アイデンティティ・ドメインにアプリケーションを作成します。「OAuth構成」を選択し、「プライマリ・オーディエンス」をコピーしてここに貼り付けます。

      例:
      https://api.example.com
      https://my-service.internal
      urn:my-resource-server
      ocid1.resourceServer.oc1..xxxx

アプリケーション・ログの有効化

リソース・ロギングを有効にして、アプリケーション・アクティビティの追跡、問題のトラブルシューティングを行い、ホストされたデプロイメントの操作インサイトを収集します。

  1. (オプション)「ログの有効化」を選択します。
  2. 「カテゴリ」で、genai-hosted-deployment-logを選択するか、新しいログ・グループを作成します。
  3. 「ログ・グループ」で、既存のログ・グループを選択するか、「新規ログ・グループの作成」を選択します。
  4. ログ・グループを含むコンパートメントを選択します。
  5. ログ名を入力します。
  6. (オプション)「拡張オプション」で、ログ保持期間を選択します。
    デフォルトの保持期間は1か月(30日)です。

確認および作成

アプリケーション設定を確認し、「アプリケーションの作成」を選択します。

ノート

アプリケーションの作成時間は、サービスがアプリケーションにプロビジョニングするリソースによって異なります。

  • 管理対象ストレージが有効な場合、サービスは専用ストレージ・インスタンスをプロビジョニングします。これには数分かかる場合があります。

  • 「カスタム・ネットワーキング」を選択した場合、サービスは必要なネットワーク・ブリッジング・リソースをプロビジョニングします。これには数分かかる場合もあります。

設定を確認し、「アプリケーションの作成」を選択します。
ヒント

アプリケーションを作成した後、その詳細を表示して、別のコンパートメントへの移動、タグの管理、削除など、その他のタスクを実行できます。コンソールの「アクション」メニュー(3つのドット)を使用して、これらのタスクにアクセスします。詳細ページからアプリケーションのデプロイメントを作成することもできます。詳細は、アプリケーションのリストを参照してください。