仮想デプロイメントの作成

• コンソール
• CLI
• API

• 1. ナビゲーション・メニューを開き、「開発者サービス」をクリックします。「コンテナおよびアーティファクト」で、「サービス・メッシュ」をクリックします。
  2. 「サービス・メッシュ」をクリックします。
  3. 「サービス・メッシュ」ページの左側にあるコンパートメントのリストから、コンパートメントを選択します。
  4. メッシュのリストから、仮想デプロイメントを作成する仮想サービスを含むメッシュをクリックします。
  5. メッシュの詳細ページで、仮想サービスをクリックします。
  6. 仮想サービスの詳細ページの「仮想デプロイメント」表で、「仮想デプロイメントの作成」をクリックします。
  7. 「仮想デプロイメントの作成」パネルで、次の詳細を指定します:
     • 名前: 仮想デプロイメントの名前を入力します。名前は、文字またはアンダースコアで始まり、文字、数字、ハイフンまたはアンダースコアが続く必要があります。長さは1から255文字です。機密情報を入力しないでください。
     • 説明: (オプション)新しい仮想デプロイメントの説明を追加します。機密情報を入力しないでください。
     • コンパートメント: 仮想デプロイメントを作成するコンパートメントを選択します。デフォルト・コンパートメントは前に選択したコンパートメントですが、作業権限を持つ任意のコンパートメントを選択できます。
     • 「アクセス・ログの有効化」を選択してアクセス・ログを有効にし、その場所を設定します。
  8. (オプション)仮想デプロイメントにタグを追加するには、「拡張オプションの表示」をクリックします。タグ付けの詳細は、リソース・タグを参照してください。
  9. 「仮想デプロイメントの作成」をクリックします。

• virtual-deployment createで使用可能な操作を確認するには、次を使用します:

  oci service-mesh virtual-deployment create -h

  CLIを使用して仮想デプロイメントを作成するには、oci service-mesh virtual-deployment createを実行して仮想デプロイメントを作成します:

  oci service-mesh virtual-deployment create --name <virtual-deployment-name> --description <description> --compartment-id <compartment-ocid> --virtual-service-id <virtual-service-ocid> --service-discovery  --listeners <listeners-list> --access-logging <access-logging-config>

  説明:

  • <virtual-deployment-name> (不変)は、新しい仮想デプロイメントの名前です。名前は仮想サービスで一意にする必要があります。
  • <description> (オプション)は、仮想デプロイメントの説明です。機密情報を入力しないでください。
  • <compartment-OCID>は、新しい仮想デプロイメントが属するコンパートメントのOCIDです。
  • <virtual-service-OCID> (不変)は、仮想デプロイメントを含む仮想サービスのOCIDです。

  • <service-discovery-config>は、使用する仮想デプロイメントのサービス検出構成です。これは複合型で、値は有効なJSONである必要があります。コマンドラインで値を文字列として指定するか、またはfile://path/to/file構文を使用してファイルとして渡します。次のフィールドがあります

    • type (使用可能なオプション DNS)。
    • 仮想デプロイメントの場合は、hostname。

  • <listeners-list>は、仮想デプロイメントのリスナー・オブジェクトのリストです。これは複合型で、値は有効なJSONである必要があります。コマンドラインで値を文字列として指定するか、またはfile://path/to/file構文を使用してファイルとして渡します。各リスナー・オブジェクトには次のフィールドが含まれます。

    • 使用可能なオプション HTTP、HTTP2、GRPC、TCP、および TLS_PASSTHROUGHを持つ「protocol」。
    • [1、 65535]の範囲のリスナーの'port'値
  • <listeners-list> (オプション)は、仮想デプロイメントのアクセス・ログ設定の構成です。この設定のブール・フィールドはis-enabledです。この設定は複合型で、値は有効なJSONである必要があります。値は、コマンドラインで文字列として指定するか、またはfile://path/to/file構文を使用してファイルとして渡すことができます。

  例:

  oci service-mesh virtual-deployment create --name my-virtual-deployment --description "This is a virtual deployment" --compartment-id ocid1.compartment.oc1.id --virtual-service-id ocid1.meshvirtualservice.oc1.id --service-discovery '{"type": "DNS", "hostname":"deployment-1.com"}' --listeners '[{"port": 8080, "protocol": "HTTP"}]' --access-logging '{"is-enabled": "TRUE"}'

  コマンドへのレスポンスには、次が含まれます:

  • 仮想デプロイメントのOCID。
  • ライフサイクルの状態(たとえば、CREATING、ACTIVE、FAILED)。
  • 仮想デプロイメントを作成する作業リクエストのID(作業リクエストの詳細は、完了、取消または失敗の後の7日間利用可能です)。

  仮想デプロイメントがアクティブになる(またはリクエストが失敗する)までコマンドが制御を返すのを待機する場合は、次のいずれかまたは両方のパラメータを含めます。

  • --wait-for-state SUCCEEDED
  • --wait-for-state FAILED

  例:

  oci service-mesh virtual-deployment create --name my-virtual-deployment --description "This is a virtual deployment" --compartment-id ocid1.compartment.oc1.id --virtual-service-id ocid1.meshvirtualservice.oc1.id --service-discovery '{"type": "DNS", "hostname":"deployment-1.com"}' --listeners '[{"port": 8080, "protocol": "HTTP"}]' --access-logging '{"is-enabled": "TRUE"}' --wait-for-state SUCCEEDED

  重要
  
  仮想デプロイメントは、仮想デプロイメントがアクティブになるまで使用できません。

  仮想デプロイメント・ステータスの確認

  (オプション)仮想デプロイメントのステータスを確認するには、次を入力します:

  oci service-mesh virtual-deployment get --virtual-deployment-id <virtual-deployment-ocid>

  (オプション)仮想デプロイメントを作成している作業リクエストのステータスを表示するには、サービス・メッシュ作業リクエストを参照してください。

  JSONファイルを使用した仮想デプロイメントの作成

  または、createコマンドにJSONファイルを指定して仮想デプロイメントを作成します。virtual-deploymentのサンプルJSONファイルを生成します:

  oci service-mesh virtual-deployment create --generate-full-command-json-input

  前のステップで生成された出力のサンプルを含むJSONファイルを作成し、フィールドを適切な値で更新します。仮想デプロイメントcreateコマンドにJSONファイルを指定します。

  oci service-mesh virtual-deployment create --from-json file:///<filename>

  CLIの使用の詳細は、コマンドライン・インタフェース(CLI)/>を参照してください。

• 仮想デプロイメントを作成するには、CreateVirtualDeployment操作を使用します。