リソースラベル

このページでは、Istioの動作を制御するためにIstioがサポートするさまざまなリソースラベルについて説明します。

istio.io/rev

名称istio.io/rev
機能ステータスアルファ
リソースタイプ[名前空間]
説明

リソースに関連付けられたIstioコントロールプレーンリビジョン。例:`canary`

networking.istio.io/gatewayPort

名称networking.istio.io/gatewayPort
機能ステータスアルファ
リソースタイプ[サービス]
説明

マルチネットワークゲートウェイのポートとして使用するデフォルトの15443値を上書きするIstioGatewayPortLabel

service.istio.io/canonical-name

名称service.istio.io/canonical-name
機能ステータスアルファ
リソースタイプ[Pod]
説明

ワークロードが属する標準的なサービスの名前

service.istio.io/canonical-revision

名称service.istio.io/canonical-revision
機能ステータスアルファ
リソースタイプ[Pod]
説明

ワークロードが属する標準的なサービス内のリビジョンの名前

sidecar.istio.io/inject

名称sidecar.istio.io/inject
機能ステータスベータ
リソースタイプ[Pod]
説明

Envoyサイドカーをワークロードに自動的に注入するかどうかを指定します。

topology.istio.io/cluster

名称topology.istio.io/cluster
機能ステータスアルファ
リソースタイプ[Pod]
説明

このラベルは、ワークロードを含むKubernetesクラスタを識別する、内部的にワークロードに適用されるラベルです。クラスタIDは、`values.global.multiCluster.clusterName`を介して各クラスタのIstioインストール時に指定されます。これはIstio内部でのみ使用され、ワークロードPodの実際のラベルではないことに注意してください。Podにこのラベルが含まれている場合、Istioインストール時に指定されたクラスタIDによってIstio内部で上書きされます。このラベルにより、DestinationRulesを使用する際にクラスタ別にワークロードを選択できます。たとえば、サービス所有者はクラスタごとのサブセットを含むDestinationRuleを作成し、これらのサブセットを使用して各クラスタへのトラフィックフローを個別に制御できます。

topology.istio.io/network

名称topology.istio.io/network
機能ステータスベータ
リソースタイプ[名前空間 Pod サービス]
説明

1つ以上のPodのネットワークを識別するために使用されるラベル。これは、Istioが同じL3ドメイン/ネットワークに存在するPodをグループ化するために内部的に使用されます。Istioは、同じネットワーク内のPodはお互いに直接到達可能であると想定しています。Podが異なるネットワークにある場合、Istioゲートウェイ(例:東西ゲートウェイ)を使用して通常接続が確立されます(AUTO_PASSTHROUGHモードを使用)。このラベルは、Istioのマルチネットワーク設定の自動化を支援するために、次のリソースに適用できます。

  • Istioシステム名前空間:このラベルをシステム名前空間に適用すると、コントロールプレーンによって管理されるPodのデフォルトネットワークが確立されます。これは通常、管理者によって指定された値を使用してコントロールプレーンのインストール時に設定されます。

  • Pod:このラベルをPodに適用すると、Podごとにデフォルトネットワークをオーバーライドできます。これは通常、Webhook注入を介してPodに適用されますが、サービスオーナーがPodで手動で指定することもできます。各クラスタのIstioインストールは、管理者によって指定された値を使用してWebhook注入を設定します。

  • ゲートウェイサービス:Istioゲートウェイのサービスにこのラベルを適用すると、ネットワーク間トラフィックの設定時に、Istioがそのサービスをネットワークのゲートウェイとして使用するように指示します。Istioは、ネットワーク外部に存在するPodが`spec.externalIPs`、`status.loadBalancer.ingress[].ip`、またはNodePortサービスの場合はノードのアドレスを介してゲートウェイサービスにアクセスするように設定します。このラベルは、ゲートウェイ(例:東西ゲートウェイ)のインストール時に設定され、コントロールプレーンのデフォルトネットワーク(Istioシステム名前空間ラベルで指定)またはターゲットPodのネットワークのいずれかと一致する必要があります。

topology.istio.io/subzone

名称topology.istio.io/subzone
機能ステータスベータ
リソースタイプノード
説明

ワークロードのローカルサブゾーンを識別するためのユーザー提供のノードラベル。これにより、管理者は、Kubernetesのリージョンとゾーンでデフォルトで提供されるものよりも詳細なレベルのローカル性を指定できます。

この情報は役に立ちましたか?
改善のための提案はありますか?

ご意見ありがとうございます!