ASM ゲートウェイ CRD フィールドリファレンス - Alibaba Cloud Service Mesh

Alibaba Cloud Service Mesh (ASM) は、kind が IstioGateway に設定され、apiVersion が istio.alibabacloud.com/v1beta1 に設定されたカスタムリソース定義 (CRD) を提供します。また、ASM には対応するコントローラーも用意されています。このコントローラーは、この CRD リソースの変更を監視し、クラスター内の関連 Kubernetes Service、Deployment、ServiceAccount およびその他の関連リソースを同期します。本トピックでは、ASM ゲートウェイ CRD の構成例とフィールド定義について説明します。

構成例

前提条件

ASM インスタンスにクラスターを追加する。

重要

必要な構成情報にアクセスできるようにするため、すべての新しい ASM ゲートウェイは istio-system 名前空間内に作成してください。Istio 1.6 以降のバージョンでは、他の名前空間にゲートウェイをデプロイすると必要な構成にアクセスできず、ASM ゲートウェイが起動しません。

例 1: Kubernetes API を使用してイングレスゲートウェイを管理する

ASM コンソールにログインします。左側のナビゲーションウィンドウで、Service Mesh > Mesh 管理を選択します。
Mesh 管理ページで、ASM インスタンスの名前をクリックします。左側のナビゲーションウィンドウで、ASM ゲートウェイ > Ingress Gatewayを選択します。
Ingress Gatewayページで、Create from YAMLをクリックします。

Createページで、ゲートウェイのNameを入力し、Namespacesとしてistio-systemを選択し、以下の YAML を設定して、Createをクリックします。

各フィールドの詳細については、「CRD フィールドリファレンス」をご参照ください。

YAML ファイルを表示するには展開してください

apiVersion: istio.alibabacloud.com/v1beta1
kind: IstioGateway
metadata:   
  name: "myexample-customingressgateway"  
  namespace: "istio-system"
  labels:
    asm-gateway-type: ingress
spec:
  runAsRoot: true
  dnsPolicy: ClusterFirst
  hostNetwork: false
  clusterIds:
    - "${actual cluster ID}"
    - "${actual cluster ID}"   # ASM ゲートウェイは複数クラスター間でのデプロイメントをサポートしています。
  cpu: 
    targetAverageUtilization: 80
  env:
    - name: "envname1"
      value: "envvalue1"
  externalTrafficPolicy: Local
  gatewayType: ingress
  podLabels:
    key1: value1
  ports:  
  - name: status-port    
    port: 15020    
    targetPort: 15020  
  - name: http2    
    port: 80    
    targetPort: 80  
  - name: https    
    port: 443    
    targetPort: 443
  - name: tls    
    port: 15443    
    targetPort: 15443  
  replicaCount: 1  
  resources:
    limits:
      cpu: '2'
      memory: 2G
    requests:
      cpu: 200m
      memory: 256Mi
# - name: config-volume-lua
#  configMapName: lua-libs
#  mountPath: /var/lib/lua
# secretVolumes:
# - name: myexample-customingressgateway-certs
#   secretName: istio-myexample-customingressgateway-certs
#   mountPath: /etc/istio/myexample-customingressgateway-certs
  serviceType: LoadBalancer  
  serviceAnnotations:    
    service.beta.kubernetes.io/alicloud-loadbalancer-address-type: internet  
  serviceLabels:
    serviceLabelKey1: "serviceLabelValue1"
  podAnnotations:
    podAnnotationsKey1: "podAnnotationsValue1"
  rollingMaxSurge: "100%"
  rollingMaxUnavailable: "25%"
  overrides:
    cluster1Id:
      replicaCount: 1 
      resources:
        limits:
          cpu: '2'
          memory: 2G
        requests:
          cpu: 200m
          memory: 256Mi
      serviceAnnotations:    
        service.beta.kubernetes.io/alicloud-loadbalancer-address-type: internet
        service.beta.kubernetes.io/alibaba-cloud-loadbalancer-spec: "slb.s1.small"
    cluster2Id:
      replicaCount: 2
      resources:
        limits:
          cpu: '4'
          memory: 4G
        requests:
          cpu: 400m
          memory: 512Mi
      serviceAnnotations:    
        service.beta.kubernetes.io/alicloud-loadbalancer-address-type: internet
        service.beta.kubernetes.io/alibaba-cloud-loadbalancer-spec: "slb.s2.small"

説明

Kubernetes クライアントを使用して Ingress Gateway を管理する場合は、「Gateway Go 構造体の実装」をご参照ください。

Ingress Gateway のサービス情報を表示します。
1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、クラスターリストをクリックします。
2. クラスターリストページで、ご利用のクラスターの名前をクリックします。左側のナビゲーションウィンドウで、ネットワーク > サービスをクリックします。
3. サービスページの上部にある名前空間ドロップダウンリストから、istio-systemを選択します。
4. サービス一覧で、対象のサービス名をクリックして、その Ingress Gateway 情報を表示します。
Ingress Gateway の Pod 情報を表示します。
1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、クラスターリストをクリックします。
2. クラスターリストページで、ご利用のクラスターの名前をクリックします。左側のナビゲーションウィンドウで、ワークロード > ポッドをクリックします。
3. ポッドページの上部にある名前空間ドロップダウンリストから、istio-systemを選択します。
4. Pod 一覧で、対象の Pod 名をクリックして、その Ingress Gateway 情報を表示します。

例 2： Kubernetes API を使用したエグレスゲートウェイの管理

Alibaba Cloud Service Mesh (ASM) は、メッシュ内のアプリケーション向けに統一されたトラフィック出口ポイントを提供するエグレスゲートウェイサービスを提供します。

ASM コンソールにログインします。左側のナビゲーションウィンドウで、[Service Mesh] > [メッシュ管理] を選択します。
[メッシュ管理] ページで、ASM インスタンスの名前をクリックします。左側のナビゲーションウィンドウで、ASM ゲートウェイ > イグレスゲートウェイ を選択します。
[Egress Gateway] ページで、[Create from YAML] をクリックします。

[Create] ページで、エグレスゲートウェイの [Name] を入力し、[Namespaces] として istio-system を選択し、以下の YAML を設定して、[Create] をクリックします。

各フィールドの詳細については、「CRD フィールドリファレンス」をご参照ください。

YAML ファイルを表示するには展開してください

apiVersion: istio.alibabacloud.com/v1beta1
kind: IstioGateway
metadata:
  name: egressgateway
  namespace: istio-system
  labels:
    asm-gateway-type: egress
spec:
  autoCreateGatewayYaml: false
  clusterIds:
    - ${actual cluster ID}
  disableContainerPortExposed: true
  dnsPolicy: ClusterFirst
  gatewayType: egress
  hostNetwork: false
  podLabels:
    security.istio.io/tlsMode: istio
  ports:
    - name: http-0
      port: 80
      protocol: HTTP
      targetPort: 80
    - name: https-1
      port: 443
      protocol: HTTPS
      targetPort: 443
  readinessProbe: {}
  replicaCount: 1
  resources:
    limits:
      cpu: '2'
      memory: 4G
    requests:
      cpu: 200m
      memory: 256Mi
  rollingMaxSurge: 25%
  rollingMaxUnavailable: 25%
  runAsRoot: true
  serviceType: ClusterIP

エグレスゲートウェイのサービス情報を表示します。
1. [ACK コンソール] にログインします。左側のナビゲーションウィンドウで、[クラスターリスト] をクリックします。
2. [クラスターリスト] ページで、クラスターの名前をクリックします。左側のナビゲーションウィンドウで、ネットワーク > サービス をクリックします。
3. [サービス] ページで、[名前空間] ドロップダウンリストから istio-system を選択します。
4. サービス一覧で、対象のサービス名をクリックして、そのエグレスゲートウェイ情報を表示します。
エグレスゲートウェイの Pod 情報を表示します。
1. [ACK コンソール] にログインします。左側のナビゲーションウィンドウで、[クラスターリスト] をクリックします。
2. [クラスターリスト] ページで、クラスターの名前をクリックします。左側のナビゲーションウィンドウで、ワークロード > ポッド をクリックします。
3. [ポッド] ページで、[名前空間] ドロップダウンリストから istio-system を選択します。
4. Pod 一覧で、対象の Pod 名をクリックして、そのエグレスゲートウェイ情報を表示します。

CRD フィールドリファレンス

フィールド	説明	デフォルト
metadata.name	名前。生成される Kubernetes Service および Deployment の名前は istio-{この値} になります。	なし
metadata.namespace	生成される Kubernetes Service および Deployment が配置される名前空間。重要 Istio 1.6 以降のバージョンとの互換性を維持するため、この名前空間は istio-system である必要があります。	istio-system
clusterIds	配列型。ゲートウェイをデプロイするクラスターの ID。これらのクラスターは現在のメッシュインスタンスに属します。	なし
env	配列型。ゲートウェイ Pod の環境変数。	なし
externalTrafficPolicy	外部トラフィックをノードローカルまたはクラスター全体のエンドポイントにルーティングするかどうかを指定します。有効な値は Cluster または Local です。説明このフィールドはイングレスゲートウェイにのみ適用されます。	Cluster
ports	配列型。ゲートウェイ Pod に定義されたポートおよびプロトコルの一覧。例: `name: http2 port: 80 targetPort: 80 protocol: HTTP2` `name: https port: 443 targetPort: 443 protocol: HTTPS` 説明 1.9.7.107 より前のバージョンでは、protocol フィールドは明示的に宣言されません。TCP として統一的に宣言する必要があります。	なし
gatewayType	ゲートウェイタイプ。有効な値は ingress または egress です。 ingress：イングレスゲートウェイは、メッシュ内のアプリケーション向けに統一されたトラフィック入口ポイントを提供します。 egress：エグレスゲートウェイは、メッシュ内のアプリケーション向けに統一されたトラフィック出口ポイントを提供します。	ingress
replicaCount	レプリカ数。	1
configVolumes	ゲートウェイ Pod にマウントされる ConfigMap ボリューム。例: `- name: config-volume-lua configMapName: lua-libs mountPath: /var/lib/lua`	なし
resources	ゲートウェイ Pod のリソース構成。	limits: cpu: '2' memory: 2G requests: cpu: 200m memory: 256Mi
secretVolumes	ゲートウェイ Pod にマウントされるシークレットボリューム。例: `- name: myexample-customingressgateway-certs secretName: istio-myexample-customingressgateway-certs mountPath: /etc/istio/myexample-customingressgateway-certs`	なし
serviceType	ゲートウェイのサービスタイプ。有効な値は LoadBalancer、NodePort、または ClusterIP です。エグレスゲートウェイは通常 ClusterIP に設定されます。重要データプレーンクラスターが登録済みクラスターであり、このフィールドを LoadBalancer に設定する場合、クラスターが LoadBalancer タイプのサービスをサポートしていることを確認してください。サポートされていない場合、ASM ゲートウェイの作成が失敗します。	LoadBalancer
loadBalancerClass	ゲートウェイサービスの loadBalancerClass を指定します。このフィールドは serviceType が LoadBalancer の場合にのみ有効です。このフィールドは ASM バージョン 1.18 以降でサポートされています。詳細については、「ASM イングレスゲートウェイでの Network Load Balancer (NLB) の使用」をご参照ください。	なし
serviceAnnotations	ゲートウェイサービスのアノテーション。例: `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-connection-drain: 'on' service.beta.kubernetes.io/alibaba-cloud-loadbalancer-connection-drain-timeout: '20'`。一般的なアノテーションの例については、「アノテーションを使用した負荷分散の構成」をご参照ください。説明このフィールドは serviceType が LoadBalancer に設定されたゲートウェイにのみ適用されます。エグレスゲートウェイでは通常このフィールドは使用されません。	なし
serviceLabels	ゲートウェイサービスのラベル。	なし
podLabels	ゲートウェイ Pod のラベル。	なし
podAnnotations	ゲートウェイ Pod のアノテーション。	なし
rollingMaxSurge	ローリングアップデート中に、希望するレプリカ数を超えて存在できる最大 Pod 数。この値は絶対数またはパーセンテージで指定できます。	"100%"
rollingMaxUnavailable	ローリングアップデート中に許容される最大の利用不可な Pod 数。この値は絶対数またはパーセンテージで指定できます。	"25%"
overrides	clusterIds で 2 つ以上のクラスターを指定する場合、上記の一般的なパラメーターとは異なるクラスター固有の構成を定義できます。値はマップ型です。説明 key：`clusterIds` に記載されているクラスター ID のいずれか。 overrides でサポートされるフィールドは以下のとおりです: serviceAnnotations podAnnotations resources replicaCount HPA 関連の構成 (ASM 1.16 以降でサポート) serviceType (ASM 1.16 以降でサポート)	なし
kernel.enabled	カスタムカーネルパラメーターは有効ですか？	false
kernel.parameters	カーネルパラメーター設定。現在サポートされているカーネルパラメーターは以下のとおりです: net.core.somaxconn net.core.netdev_max_backlog net.ipv4.tcp_rmem net.ipv4.tcp_wmem net.ipv4.ip_local_port_range net.ipv4.tcp_fin_timeout net.ipv4.tcp_tw_timeout net.ipv4.tcp_tw_reuse net.ipv4.tcp_tw_recycle net.ipv4.tcp_timestamps net.ipv4.tcp_retries2 net.ipv4.tcp_slow_start_after_idle net.ipv4.tcp_max_orphans net.ipv4.tcp_max_syn_backlog net.ipv4.tcp_no_metrics_save net.ipv4.tcp_autocorking kernel.printk vm.swappiness 説明ホストのカーネルバージョンによっては、一部のカーネルパラメーターがサポートされていない場合があります。その場合、メッシュ Pod でエラーが報告される可能性があります。 `kubectl describe pod` コマンドを使用してゲートウェイのエラーメッセージを確認してください。サポートされていないパラメーターを削除後、コンテナは正常に起動します。すべてのカーネルパラメーター値は文字列である必要があります。YAML 構文ではプレーンな数値が数値型として解析されるため、値を二重引用符 ("") で囲んでください。例: net.core.somaxconn: "65535"。	なし
compression.enabled	イングレスゲートウェイの圧縮機能を有効にします。説明 compression 関連のフィールドはイングレスゲートウェイにのみ適用されます。	false
compression.content_type	圧縮対象の ContentType の一覧。例: text/html application/json	なし
compression.disable_on_etag_header	true に設定：応答に etag_header が含まれる場合、圧縮を無効にします。 false に設定：etag_header が含まれていても応答を圧縮します。	false
compression.min_content_length	ContentLength がこの値以上の場合に圧縮をトリガーします。	30
compression.remove_accept_encoding_header	true に設定：クライアントリクエストをアップストリームに転送する前に Accept-Encoding ヘッダーを削除します。 false に設定：クライアントリクエストをアップストリームに転送する前に Accept-Encoding ヘッダーを保持します。	false
compression.gzip	現在は gzip 圧縮のみがサポートされています。圧縮を有効にするには、このフィールドを含める必要があります。すべてのパラメーターがデフォルト値であっても、空の構造体を含めてください。例: `gzip: {}`。	なし
compression.gzip.memory_level	zlib 内部処理のメモリ使用量レベル。有効な値は 1～9 です。値が高いほどメモリ使用量が増えますが、圧縮速度と圧縮率が向上します。	5
compression.gzip.compression_level	zlib の圧縮レベル。有効な値: COMPRESSION_LEVEL_1 COMPRESSION_LEVEL_2 COMPRESSION_LEVEL_3 COMPRESSION_LEVEL_4 COMPRESSION_LEVEL_5 COMPRESSION_LEVEL_6 COMPRESSION_LEVEL_7 COMPRESSION_LEVEL_8 COMPRESSION_LEVEL_9 DEFAULT_COMPRESSION BEST_COMPRESSION BEST_SPEED 説明 BEST_COMPRESSION は最高の圧縮品質を提供します。BEST_SPEED は最速の圧縮速度を提供します。具体的には: COMPRESSION_LEVEL_1 は BEST_SPEED と同等です。最も高速に圧縮されますが、圧縮率は低くなります。 COMPRESSION_LEVEL_9 は BEST_COMPRESSION と同等です。レベル 7～9 は最大の圧縮率を提供しますが、速度は遅くなります。 COMPRESSION_LEVEL_6 は DEFAULT_COMPRESSION と同等です。レベル 2～6 は中程度の圧縮で、速度と圧縮率のバランスが取れています。	DEFAULT_COMPRESSION
compression.gzip.compression_strategy	zlib の圧縮戦略。有効な値: DEFAULT_STRATEGY FILTERED FIXED HUFFMAN_ONLY RLE 説明 DEFAULT_STRATEGY デフォルトの圧縮戦略は、基盤となるデフォルト動作を使用し、ほとんどのケースで満足のいく結果を提供します。 FILTERED 主に繰り返しデータを含むシナリオ向けに、フィルターレイヤーの圧縮アルゴリズムを優先します。テキストや人工的に生成されたデータに対して高い圧縮率を提供します。 HUFFMAN_ONLY 他の圧縮アルゴリズムを使用せずにハフマン符号化のみを使用します。通常、高速な展開を必要とする静的データに使用されます。 RLE ランレングスエンコーディングを使用し、同一データの連続シーケンス（例：ビットマップ）を効率的に圧縮します。 FIXED 入力データに基づいて動的に生成する代わりに、事前定義されたエンコーディングツリーを使用してハフマン符号化を行います。高速な圧縮および展開を可能にしますが、一般的に圧縮率は低くなります。	DEFAULT_STRATEGY
compression.gzip.window_bits	zlib のウィンドウサイズ。有効な値は 9～15 です。	12
compression.gzip.chunk_size	zlib の出力バッファーサイズ。	4096
hostNetwork	ホストネットワーキング。 true に設定：ゲートウェイ Pod はホストのネットワークを使用します。 false に設定：ゲートウェイ Pod は独自のネットワークを使用します。	false
dnsPolicy	DNS ポリシー。dnsPolicy の詳細については、「サービスと Pod の DNS」をご参照ください。	ClusterFirst
cpu.targetAverageUtilization	HPA が有効な場合の CPU ターゲット使用率。有効な値は 1～100 です。使用率がこの値を超えるとレプリカ数が増加し、下回ると減少します。	なし
memory.targetAverageUtilization	HPA が有効な場合のメモリターゲット使用率。有効な値は 1～100 です。使用率がこの値を超えるとレプリカ数が増加し、下回ると減少します。	なし
maxReplicas	HPA によって調整される最大レプリカ数。正の整数である必要があります。	なし
minReplicas	HPA によって調整される最小レプリカ数。正の整数である必要があり、最小値は 1 です。	なし
nodeSelector	ゲートウェイ Pod を実行するノードを指定します。このフィールドの下にカスタムのキーと値のペアを定義します。例: `nodeSelector: key1: value1`	なし
affinity	ノードアフィニティを使用して、ゲートウェイ Pod のノードを指定します。詳細については、「アフィニティとアンチアフィニティ」をご参照ください。	なし
tolerations	ノードの Taint と併用します。詳細については、「Taint と Toleration」をご参照ください。	なし

ローリングリスタートをトリガーするフィールド

以下のフィールドを変更すると、ゲートウェイのローリングリスタートがトリガーされます。慎重に操作してください。

env
ports (ASM バージョン 1.16 より前ではリスタートがトリガーされますが、1.16 以降ではトリガーされません)
configVolumes
resources
secretVolumes
podLabels
podAnnotations
kernel.enabled
kernel.parameters
hostNetwork
dnsPolicy
nodeSelector (スケジューリングに依存)
affinity (スケジューリングに依存)
tolerations (スケジューリングに依存)

ゲートウェイ Go 構造体の実装

ファイル例を表示するには展開してください

package v1beta1

import (
    corev1 "k8s.io/api/core/v1"
    metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
)

type GatewayType string
type ConfigState string

const (
    GatewayTypeIngress GatewayType = "ingress"
    GatewayTypeEgress  GatewayType = "egress"
)

// IstioGatewaySpec defines the desired state of Istio
// +k8s:openapi-gen=true
type IstioGatewaySpec struct {
    // +kubebuilder:validation:Enum=ingress;egress
    GatewayType                    GatewayType `json:"gatewayType,omitempty"`
    IstioGatewayBasicConfiguration `json:",inline"`
    ClusterIds                     []string                                  `json:"clusterIds,omitempty"`
    clusterId                      string                                    `json:"clusterId,omitempty"`
    Overrides                      map[string]IstioGatewayBasicConfiguration `json:"overrides,omitempty"`
}

type KernelParameters struct {
    NetCoreSoMaxConn             *string `json:"net.core.somaxconn,omitempty"`
    NetCoreNetdevMaxBacklog      *string `json:"net.core.netdev_max_backlog,omitempty"`
    NetIpv4TcpRMem               *string `json:"net.ipv4.tcp_rmem,omitempty"`
    NetIpv4TcpWMem               *string `json:"net.ipv4.tcp_wmem,omitempty"`
    NetIpv4IpLocalPortRange      *string `json:"net.ipv4.ip_local_port_range,omitempty"`
    NetIpv4TcpFinTimeout         *string `json:"net.ipv4.tcp_fin_timeout,omitempty"`
    NetIpv4TcpTwTimeout          *string `json:"net.ipv4.tcp_tw_timeout,omitempty"`
    NetIpv4TcpTwReuse            *string `json:"net.ipv4.tcp_tw_reuse,omitempty"`
    NetIpv4TcpTwRecycle          *string `json:"net.ipv4.tcp_tw_recycle,omitempty"`
    NetIpv4TcpTimestamps         *string `json:"net.ipv4.tcp_timestamps,omitempty"`
    NetIpv4TcpRetries2           *string `json:"net.ipv4.tcp_retries2,omitempty"`
    NetIpv4TcpSlowStartAfterIdle *string `json:"net.ipv4.tcp_slow_start_after_idle,omitempty"`
    NetIpv4TcpMaxOrphans         *string `json:"net.ipv4.tcp_max_orphans,omitempty"`
    NetIpv4TcpMaxSynBacklog      *string `json:"net.ipv4.tcp_max_syn_backlog,omitempty"`
    NetIpv4TcpNoMetricsSave      *string `json:"net.ipv4.tcp_no_metrics_save,omitempty"`
    NetIpv4TcpAutocorking        *string `json:"net.ipv4.tcp_autocorking,omitempty"`
    KernelPrintk                 *string `json:"kernel.printk,omitempty"`
    VmSwappiness                 *string `json:"vm.swappiness,omitempty"`
}

type KernelConfiguration struct {
    Enabled    *bool            `json:"enabled,omitempty"`
    Parameters KernelParameters `json:"parameters,omitempty"`
}

type GzipCompressorConfiguration struct {
    MemoryLevel         *uint32 `json:"memory_level,omitempty"`
    CompressionLevel    *string `json:"compression_level,omitempty"`
    CompressionStrategy *string `json:"compression_strategy,omitempty"`
    WindowBits          *uint32 `json:"window_bits,omitempty"`
    ChunkSize           *uint32 `json:"chunk_size,omitempty"`
}

type CompressorConfiguration struct {
    Enabled                    *bool                        `json:"enabled,omitempty"`
    MinContentLength           *uint32                      `json:"min_content_length,omitempty"`
    ContentType                *[]string                    `json:"content_type,omitempty"`
    DisableOnETagHeader        *bool                        `json:"disable_on_etag_header,omitempty"`
    RemoveAcceptEncodingHeader *bool                        `json:"remove_accept_encoding_header,omitempty"`
    Gzip                       *GzipCompressorConfiguration `json:"gzip,omitempty"`
}

type ReadinessProbeConfiguration struct {
    FailureThreshold int32 `json:"failureThreshold,omitempty"`
    PeriodSeconds    int32 `json:"periodSeconds,omitempty"`
    SuccessThreshold int32 `json:"successThreshold,omitempty"`
}

// +k8s:openapi-gen=true
type IstioGatewayBasicConfiguration struct {
    ReplicaCount     int32 `json:"replicaCount,omitempty"`
    AutoscaleEnabled bool  `json:"autoscaleEnabled,omitempty"`
    MinReplicas      int32 `json:"minReplicas,omitempty"`
    MaxReplicas      int32 `json:"maxReplicas,omitempty"`
    // +kubebuilder:validation:Enum=ClusterIP;NodePort;LoadBalancer
    ServiceType           corev1.ServiceType           `json:"serviceType,omitempty"`
    LoadBalancerIP        string                       `json:"loadBalancerIP,omitempty"`
    ExternalTrafficPolicy string                       `json:"externalTrafficPolicy,omitempty"`
    ServiceAnnotations    map[string]string            `json:"serviceAnnotations,omitempty"`
    PodAnnotations        map[string]string            `json:"podAnnotations,omitempty"`
    ServiceLabels         map[string]string            `json:"serviceLabels,omitempty"`
    PodLabels             map[string]string            `json:"podLabels,omitempty"`
    Resources             *corev1.ResourceRequirements `json:"resources,omitempty"`
    EnvVars               []corev1.EnvVar              `json:"env,omitempty"`
    Ports                 []corev1.ServicePort         `json:"ports,omitempty"`
    MeshExpansionPorts    []corev1.ServicePort         `json:"meshExpansionPorts,omitempty"`
    NodeSelector          map[string]string            `json:"nodeSelector,omitempty"`
    ApplicationPorts      string                       `json:"applicationPorts,omitempty"`
    RequestedNetworkView  string                       `json:"requestedNetworkView,omitempty"`
    Affinity              *corev1.Affinity             `json:"affinity,omitempty"`
    Tolerations           []corev1.Toleration          `json:"tolerations,omitempty"`
    SecretVolumes         []SecretVolume               `json:"secretVolumes,omitempty"`
    ConfigVolumes         []ConfigVolume               `json:"configVolumes,omitempty"`
    RollingMaxSurge       *string                      `json:"rollingMaxSurge,omitempty"`
    RollingMaxUnavailable *string                      `json:"rollingMaxUnavailable,omitempty"`
    CPU                   HpaCPU                       `json:"cpu,omitempty"`
    Memory                HpaMemory                    `json:"memory,omitempty"`
    Kernel                KernelConfiguration          `json:"kernel,omitempty"`
    Compressor            CompressorConfiguration      `json:"compression,omitempty"`
    RunAsRoot             *bool                        `json:"runAsRoot,omitempty"`
    Lifecycle             *corev1.Lifecycle            `json:"lifecycle,omitempty"`
    ReadinessProbe        ReadinessProbeConfiguration  `json:"readinessProbe,omitempty"`
    HostNetwork           *bool                        `json:"hostNetwork,omitempty"`
    DnsPolicy             corev1.DNSPolicy             `json:"dnsPolicy,omitempty"`
    AutoCreateGatewayYaml *bool                        `json:"autoCreateGatewayYaml,omitempty"`
}

type SecretVolume struct {
    Name       string `json:"name,omitempty"`
    SecretName string `json:"secretName,omitempty"`
    MountPath  string `json:"mountPath,omitempty"`
}

type ConfigVolume struct {
    Name          string `json:"name,omitempty"`
    ConfigMapName string `json:"configMapName,omitempty"`
    MountPath     string `json:"mountPath,omitempty"`
}

// +k8s:openapi-gen=true
type HpaCPU struct {
    TargetAverageUtilization *int32 `json:"targetAverageUtilization,omitempty"`
}

// +k8s:openapi-gen=true
type HpaMemory struct {
    TargetAverageUtilization *int32 `json:"targetAverageUtilization,omitempty"`
}

// +k8s:openapi-gen=true
type IstioGatewayStatus struct {
    // INSERT ADDITIONAL STATUS FIELD - define observed state of cluster
    // Important: Run "operator-sdk generate k8s" to regenerate code after modifying this file
    // Add custom validation using kubebuilder tags: https://book.kubebuilder.io/beyond_basics/generating_crd.html
    Status                     ConfigState      `json:"Status,omitempty"`
    GatewayAddress             []string         `json:"GatewayAddress,omitempty"`
    ClusterIdGatewayAddressMap []GatewayAddress `json:"ClusterIdGatewayAddressMap,omitempty"`

    ErrorMessage string `json:"ErrorMessage,omitempty"`
}

// +k8s:openapi-gen=true
type GatewayAddress struct {
    IPAddress string `json:"ipAddress,omitempty"`
    ClusterId string `json:"clusterId,omitempty"`
}

// +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object

// IstioGateway is the Schema for the istiogateways API
// +k8s:openapi-gen=true
// +kubebuilder:subresource:status
type IstioGateway struct {
    metav1.TypeMeta   `json:",inline"`
    metav1.ObjectMeta `json:"metadata,omitempty"`

    Spec   IstioGatewaySpec   `json:"spec,omitempty"`
    Status IstioGatewayStatus `json:"status,omitempty"`
}

// +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object

// IstioGatewayList contains a list of IstioGateway
type IstioGatewayList struct {
    metav1.TypeMeta `json:",inline"`
    metav1.ListMeta `json:"metadata,omitempty"`
    Items           []IstioGateway `json:"items"`
}