Container Service for Kubernetes:MSE Ingress を使用した ACK クラスター内のアプリケーションへのアクセス

方法 1：Kubernetes IngressClass リソースの使用 (推奨)

この方法は、MSE Ingress にアクセスする新しいサービスに使用します。クラスターの Kubernetes バージョンに基づいて、次のいずれかのコマンドを実行します。

Kubernetes バージョンが v1.19 より前のクラスター

cat << EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1beta1
kind: IngressClass
metadata:
  name: mse
spec:
  controller: mse.alibabacloud.com/ingress
  parameters:
    apiGroup: mse.alibabacloud.com       # MseIngressConfig の API グループ
    kind: MseIngressConfig               # リソースの種類
    name: test                           # ステップ 1 で作成した MseIngressConfig の名前
EOF

Kubernetes v1.19 以降を実行するクラスター

cat << EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1
kind: IngressClass
metadata:
  name: mse
spec:
  controller: mse.alibabacloud.com/ingress
  parameters:
    apiGroup: mse.alibabacloud.com       # MseIngressConfig の API グループ
    kind: MseIngressConfig               # リソースの種類
    name: test                           # ステップ 1 で作成した MseIngressConfig の名前
EOF

方法 2：MseIngressConfig リソースの使用 (移行用)

この方法は、NGINX Ingress から MSE Ingress に移行する場合、または IngressClass リソースを作成できないシナリオで使用します。移行中、NGINX Ingress と MSE Ingress の両方が同じ IngressClass リソースをリッスンする必要があります。この方法では、IngressClass を MseIngressConfig 内で直接設定できるため、IngressClass 名の競合を回避できます。

ステップ 1 で作成した MseIngressConfig に ingressClass フィールドを追加します。

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  common:
    instance:
      spec: 2c4g
      replicas: 3
  ingress:
    local:
      ingressClass: mse                  # リッスンする IngressClass 名

ingress.local.ingressClass の値を次の表に示します。

ゲートウェイのステータスの確認

次のコマンドを実行して、MseIngressConfig のステータスを確認します。

kubectl get MseIngressConfig test

期待される出力：

NAME   STATUS      AGE
test   Listening   3m15s

Listening ステータスは、クラウドネイティブゲートウェイが実行中であり、mse IngressClass に関連付けられた Ingress リソースを監視していることを示します。

ステータスは次の順序で遷移します。

サンプルのバックエンドサービスのデプロイ

次のコマンドを実行して、go-httpbin サービスをデプロイします。

cat << EOF | kubectl apply -f -
apiVersion: apps/v1
kind: Deployment
metadata:
  name: go-httpbin
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: go-httpbin
  template:
    metadata:
      labels:
        app: go-httpbin
        version: v1
    spec:
      containers:
        - image: specialyang/go-httpbin:v3
          args:
            - "--port=8090"            # アプリケーションがリッスンするポート 8090
            - "--version=v1"           # バージョン v1 を報告
          imagePullPolicy: Always
          name: go-httpbin
          ports:
            - containerPort: 8090
---
apiVersion: v1
kind: Service
metadata:
  name: go-httpbin
  namespace: default
spec:
  ports:
    - port: 80                         # Ingress に公開されるサービスポート
      targetPort: 8090                 # コンテナーポート 8090 に転送
      protocol: TCP
  selector:
    app: go-httpbin
EOF

Ingress リソースの作成

次のいずれかのコマンドを実行して Ingress リソースを作成します。この Ingress は example.com/version へのリクエストを go-httpbin サービスにルーティングします。

cat << EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: ingress
  namespace: default
spec:
  ingressClassName: mse                  # MSE IngressClass に関連付け
  rules:
   - host: example.com
     http:
      paths:
      - path: /version
        backend:
          serviceName: go-httpbin
          servicePort: 80
EOF

cat << EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress
  namespace: default
spec:
  ingressClassName: mse                  # MSE IngressClass に関連付け
  rules:
  - host: example.com
    http:
      paths:
      - backend:
          service:
            name: go-httpbin
            port:
              number: 80
        path: /version
        pathType: Prefix
EOF

結果の確認

1. Ingress に割り当てられたアドレスを取得します。期待される出力：

      kubectl get ingress ingress

      NAME      CLASS   HOSTS            ADDRESS         PORTS   AGE
      ingress   mse     example.com      114.55.XX.XX   80      12m

2. Ingress アドレスを使用してテストリクエストを送信します。期待される出力：version:v1 のレスポンスは、トラフィックが MSE Ingress を経由して go-httpbin バックエンドサービスにルーティングされたことを示します。

      curl -H "host: example.com" <ADDRESS>/version

      version:v1