Container Service for Kubernetes:Nginx Ingress Controller のネットワークタイプの設定

仕組み

クラスター内で、SLB インスタンスがクライアントからのリクエストを受け取り、Nginx Ingress Controller ワークロードに転送します。その後、ワークロードが他のサービスにリクエストを転送します。

パブリックネットワークおよびプライベートネットワークの両方へのアクセスを有効にする Nginx Ingress の設定

Nginx Ingress Controller のバックエンド Pod に対して 2 つのサービスをデプロイします。1 つはパブリック SLB インスタンスに関連付け、もう 1 つはプライベート SLB インスタンスに関連付けます。これにより、パブリックネットワークおよびプライベートネットワークの両方へのアクセスが可能になります。

1. 現在の SLB のネットワークタイプを確認します。

   kubectl describe service -n kube-system nginx-ingress-lb | grep "service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type"

   出力に intranet が含まれている場合、現在のタイプはプライベートです。それ以外の場合はパブリックです。

2. パブリックおよびプライベートの両方のネットワークタイプが存在することを保証するため、新しいサービスを作成します。

   nginx-ingress-lb-new.yaml という名前のファイルを作成して保存し、kubectl apply -f nginx-ingress-lb-new.yaml を実行してサービスを作成します。

   プライベートネットワークのサービスを追加

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb-intranet
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
     annotations:
       service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type: intranet # SLB インスタンスがプライベートネットワークアドレスを使用することを指定します。
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

   パブリックネットワークのサービスを追加

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb-internet
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

3. 次のコマンド内の <service-name> を新しく作成したサービスの名前に置き換え、コマンドを実行します。戻り値が 200 の場合、新しいサービスが正しく動作しています。

   curl -s -o /dev/null -w "%{http_code}\n" http://$(kubectl get service -n kube-system <service-name> -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

4. <service-name> を新しく作成したサービスの名前に置き換え、kubectl get service <service-name> を実行します。サービスの External IP を記録し、サービスのタイプに基づいて DNS を設定します。

   新しいプライベートネットワークのサービス

   1. Alibaba Cloud DNS – Private DNS にログインします。イントラネット権威 > User Defined Zones タブで、Add Zone をクリックします。すでにドメインを追加済みの場合は、手順 c に進んでください。

   2. イントラネット権威ドメイン名 (Zone) にドメイン名を入力します。その他のオプションはデフォルトのままにして、OK をクリックします。

   3. 対象のドメインをクリックします。Settings タブで、Add Record をクリックします。以下の表の値を使用してフォームに入力します。その他の設定はデフォルトのままにして、OK をクリックします。

      設定項目	値
      Record Type	A
      Hostname	必要に応じてサブドメインプレフィックスを入力します。
      Record Value	新しいサービスの IP アドレス。

   4. User Defined Zones リストに戻ります。対象ドメインの操作列で、Effective Scope を選択します。Alibaba Cloud VPC イントラネットで有効 の下で、ACK クラスターが配置されている VPC を選択し、OK をクリックします。

   新しいパブリックネットワークのサービス

   1. Alibaba Cloud DNS – Public Authoritative DNS にログインします。対象のドメインをクリックして 解決設定 ページを開き、Add Record ボタンをクリックします。

   2. 以下の表の値を使用してフォームに入力します。その他の設定はデフォルトのままにして、OK をクリックします。

      設定項目	値
      レコードタイプ	A.
      ホストレコード	必要に応じてサブドメインプレフィックスを入力します。
      レコード値	新しいサービスの IP アドレス。

ネットワークタイプの変更

1. 既存の SLB インスタンスにトラフィックがないことを確認します。

   1. Container Service 管理コンソール にログインします。対象のクラスターをクリックし、左側のナビゲーションウィンドウで ネットワーク > サービス に移動します。kube-system 名前空間で nginx-ingress-lb を探します。外部 IP アドレス (External IP) を記録します。

   2. Classic Load Balancer コンソール にログインします。クラスターと同じリージョンを選択します。前の手順で記録した IP アドレスと一致する IP を持つ CLB インスタンスを探します。インスタンスをクリックし、モニタ タブで接続数が 0 であることを確認してから、次の手順に進んでください。

2. Nginx Ingress Controller で使用中の現在のサービスを削除します。

   kubectl delete svc -n kube-system nginx-ingress-lb

3. nginx-ingress-lb.yaml という名前のファイルを作成して保存し、kubectl apply -f nginx-ingress-lb.yaml を実行してサービスを作成します。

   重要

   新しいサービス名は nginx-ingress-lb である必要があります。

   プライベートネットワークのサービス

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
     annotations:
       service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type: intranet # SLB インスタンスがプライベートネットワークアドレスを使用することを指定します。
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

   パブリックネットワークのサービス

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

4. 新しいサービスをテストします。戻り値が 200 の場合、サービスが正しく動作しています。

   curl -s -o /dev/null -w "%{http_code}\n" http://$(kubectl get service -n kube-system nginx-ingress-lb -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

5. kubectl get service nginx-ingress-lb を実行します。サービスの External IP を記録し、サービスのタイプに基づいて DNS を設定します。

   新しいプライベートネットワークのサービス

   1. Alibaba Cloud DNS – Private DNS にログインします。イントラネット権威 > User Defined Zones タブで、Add Zone をクリックします。すでにドメインを追加済みの場合は、手順 c に進んでください。

   2. イントラネット権威ドメイン名 (Zone) にドメイン名を入力します。その他のオプションはデフォルトのままにして、OK をクリックします。

   3. 対象のドメインをクリックします。Settings タブで、Add Record をクリックします。以下の表の値を使用してフォームに入力します。その他の設定はデフォルトのままにして、OK をクリックします。

      設定項目	値
      Record Type	A
      Hostname	必要に応じてサブドメインプレフィックスを入力します。
      Record Value	新しいサービスの IP アドレス。

   4. User Defined Zones リストに戻ります。対象ドメインの操作列で、Effective Scope を選択します。Alibaba Cloud VPC イントラネットで有効 の下で、ACK クラスターが配置されている VPC を選択し、OK をクリックします。

   新しいパブリックネットワークのサービス

   1. Alibaba Cloud DNS – Public Authoritative DNS にログインします。対象のドメインをクリックして 解決設定 ページを開き、Add Record ボタンをクリックします。

   2. 以下の表の値を使用してフォームに入力します。その他の設定はデフォルトのままにして、OK をクリックします。

      設定項目	値
      レコードタイプ	A.
      ホストレコード	必要に応じてサブドメインプレフィックスを入力します。
      レコード値	新しいサービスの IP アドレス。

よくある質問

関連ドキュメント

既存の SLB インスタンスに対するアノテーションの設定方法の詳細については、「既存の SLB インスタンスの使用」をご参照ください。