NetScaler® CPX Kubernetes Gateway Controllerのデプロイ

1. 開始するには、サンプルアプリケーションをデプロイします。
   apiVersion: apps/v1
kind: Deployment
metadata:
  name: cnn-website
  labels:
    name: cnn-website
    app: cnn-website
spec:
  selector:
    matchLabels:
      app: cnn-website
  replicas: 2
  template:
    metadata:
      labels:
        name: cnn-website
        app: cnn-website
    spec:
      containers:
      - name: cnn-website
        image: quay.io/sample-apps/cnn-website:v1.0.0
        ports:
        - name: http-80
          containerPort: 80
        - name: https-443
          containerPort: 443
---
apiVersion: v1
kind: Service
metadata:
  name: cnn-website
  labels:
    app: cnn-website
spec:
  type: NodePort
  ports:
  - name: http-80
    port: 80
    targetPort: 80
  - name: https-443
    port: 443
    targetPort: 443
  selector:
    name: cnn-website
2. Gateway API CRDがまだインストールされていない場合は、公式標準チャネルからインストールします。
3. ユースケースに基づいてvalues.yamlを生成します。NetScaler Kubernetes Gateway Controllerのインストール中に構成できる必須およびオプションのパラメータについては、構成を参照してください。
   gatewayController:
    entityPrefix: gwy
    gatewayControllerName: "citrix.com/nscpxgw-controller"
license:
    accept: yes
service:
    annotations: {}
    spec:
        type: NodePort
        ports:
        - port: 80
          targetPort: 80
          protocol: TCP
          name: http
        - port: 443
          targetPort: 443
          protocol: TCP
          name: https
        - port: 6379
          targetPort: 6379
          protocol: TCP
          name: tcp6379
        - port: 5353
          targetPort: 5353
          protocol: UDP
          name: udp5353
   注：
   entityPrefixとgatewayControllerNameは必須であり、NetScaler CPXとKubernetes Gateway Controllerのすべてのデプロイメントで一意である必要があります。

4. Helmチャートと、前の手順で生成されたvalues.yamlを使用して、NetScaler CPXとKubernetes Gateway Controllerをデプロイします。詳細については、Helmチャートを使用したNetScaler CPXとKubernetes Gateway Controllerのデプロイを参照してください。
   helm repo add netscaler https://netscaler.github.io/netscaler-helm-charts/

helm install cpx-gateway-controller netscaler/netscaler-cpx-with-gateway-controller  -f values.yaml

GatewayおよびHTTPRoute CRDのサンプル

1. Gatewayオブジェクトを処理するコントローラーを定義するために、GatewayClassリソースを作成します。
   GatewayClassのサンプル
   apiVersion: gateway.networking.k8s.io/v1
kind: GatewayClass
metadata:
  name: example-gateway-class
spec:
  controllerName: citrix.com/nscpxgw-controller
2. (オプション) TLS構成のためにGateway-Listenerで使用する自己署名SSL証明書とキーを作成します。
   以下のコマンドは、自己署名証明書を作成するための単なるサンプルコマンドであり、アプリケーションのホスト名がexample.comであると仮定しています。
   openssl genrsa -out cnnwebsite_key.pem 2048
openssl req -new -key cnnwebsite_key.pem -out cnnwebsite_csr.pem -subj "/CN=example.com"
openssl x509 -req -in cnnwebsite_csr.pem -sha256 -days 365 -extensions v3_ca -signkey cnnwebsite_key.pem -CAcreateserial -out cnnwebsite_cert.pem
   注:
   すでにSSL証明書をお持ちの場合は、それを使用してKubernetesシークレットを作成できます。

3. SSL証明書とキー（TLSペア）を保存するためのKubernetes Secretを作成します。
   kubectl create secret tls app1-secret --key cnnwebsite_key.pem --cert cnnwebsite_cert.pem

4. 定義されたリスナーに基づいてサービスを公開するためのGatewayリソースを定義します。
   apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: example-gateway
spec:
  gatewayClassName: example-gateway-class
  listeners:
  - name: http
    protocol: HTTP
    port: 80
  - name: https
    protocol: HTTPS
    port: 443
    tls:
      mode: Terminate
      certificateRefs:
      - kind: Secret
        name: app1-secret
        group: ""
   注:
   • Gatewayで定義されているgatewayClassNameが、前の手順で作成されたGatewayClassリソースと一致することを確認します。

5. HTTPRouteまたはその他のルートCRDを適用して、バックエンドサービスにトラフィックをルーティングします。
   apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: example-route
spec:
  parentRefs:
  - name: example-gateway
  hostnames:
    - "example.com"
  rules:
  - matches:
    - path:
        type: PathPrefix
        value: /
    backendRefs:
    - name: cnn-website
      namespace: default
      port: 80
   注:
   • parentRefsで指定されたゲートウェイ名が、前の手順で確立されたGateway CRDと一致することを確認してください。
   • 現在、HTTPRoute CRDは単一のparentRefのみをサポートしています。

6. gatewayClassのステータスを確認します。ステータスがACCEPTED: Trueと表示されている場合、コントローラーはリソースを受け入れています。
   kubectl get gatewayclass
NAME                     CONTROLLER                   ACCEPTED   AGE  
example-gateway-class   citrix.com/nscpxgw-controller   True       2dkubectl describe gatewayclass
...
Spec:
Controller Name:  citrix.com/nscpxgw-controller
Status:
Conditions:
    Last Transition Time:  2025-10-16T06:24:51Z
    Message:               Accepted by the controller.
    Reason:                Accepted
    Status:                True
    Type:                  Accepted
Events:                    <none>
   Gatewayリソースのステータスを確認します。ステータスがPROGRAMMED : Trueと表示されている場合、コントローラーは設定をNetScalerに正常にプッシュしています。
   kubectl get gateway example-gateway

NAME            CLASS                    ADDRESS  PROGRAMMED  AGE
example-gateway   example-gateway-class   10.244.2.28   True         14mkubectl describe gateway example-gateway

Status:
    Addresses:
        Type:   IPAddress
        Value:  10.244.2.28
    Conditions:
        Last Transition Time:  2025-10-16T06:24:53Z
        Message:               Accepted by the controller.
        Reason:                CreatedCRDInstance
        Status:                True
        Type:                  Accepted
        Last Transition Time:  2025-10-16T06:25:01Z
        Message:               Config pushed by the controller.
        Reason:                ConfigPushedToNetscaler
        Status:                True
        Type:                  Programmed
    Events:                    <none>
7. トラフィックの場合、CPXのサービスはnodePortとしてデプロイされているため、nodeIP:NodePortを使用してトラフィックを送信できます。
   kubectl get svc -o wide

NAME                                 TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE   SELECTOR
cpx-gateway-controller-cpx-service   NodePort       10.104.175.74   <none>        80:31375/TCP,443:31994/TCP   11m   app=cpx-gateway-controller-netscaler-cpx-with-gateway-controller
curl -vik --resolve example.com:<nodePort>:<nodeIP> https://example.com:<nodePort>

curl -vik --resolve example.com:31994:<nodeIP> https://example.com:31994

GatewayおよびTCPRoute CRDを使用してTCPアプリケーションを公開する

Gateway および UDPRoute CRD を使用した UDP アプリケーションの公開