Ingress のセットアップ

ステップ 1: ClusterIP サービスを作成する

公開するアプリ・デプロイメントごとに、Kubernetes ClusterIP サービスを作成します。 アプリを Ingress ロード・バランシングに含めるには、Kubernetes サービスを介してアプリを公開する必要があります。

kubectl expose deploy <app_deployment_name> --name my-app-svc --port <app_port> -n <namespace>

ステップ2： TLS 証明書と Kubernetes シークレットを使って TLS ターミネーションをセットアップする

TLS 証明書は、アプリが存在する各ネームスペースに Kubernetes シークレットとして保存する必要があります。

• IBM-提供されたIngressサブドメインを使用するには、 IBM-提供されたIngressサブドメインに TLS シークレットを設定する を参照のこと。

• カスタムドメインを使用するには、 カスタムサブドメインの TLS シークレットの設定を 参照してください。

ステップ 3: Ingress リソースを作成する

Ingressリソースを作成し、Ingressコントローラーがアプリサービスにトラフィックをルーティングするために使用するルーティングルールを定義します。

1. YAML ファイルに Ingress リソースを作成します。

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: my-ingress-resource
   spec:
     ingressClassName: nginx-example
     tls:
     - hosts:
       - <domain_name>
       secretName: <tls_secret_name>
     rules:
     - host: HOSTNAME
       http:
         paths:
         - path: <app_path_1>
           pathType: Prefix
           backend:
             service:
               name: <app_service_1>
               port:
                 number: 80
         - path: <app_path_2>
           pathType: Prefix
           backend:
             service:
               name: <app_service_2>
               port:
                 number: 80
   
   

リソース・フィールド

ingressClassName

Ingress クラス名。 IBM提供の Ingress クラスは、パブリック ALB の場合は public-iks-k8s-nginx 、プライベート ALB の場合は private-iks-k8s-nginx です。

tls.hosts

TLS を使用するには、<domain> を、IBM 提供の Ingress サブドメインまたはカスタム・ドメインで置き換えます。

tls.secretName

<tls_secret_name> は、 TLS 証明書が 保存されている Kubernetes シークレットの名前に置き換えてください。

host

<domain> を、IBM 提供の Ingress サブドメインまたはカスタム・ドメインに置き換えます。

path

<app_path> を、スラッシュまたはアプリが listen しているパスに置き換えます。 指定したIngressドメインにパスが付加され、アプリへのユニークなルートが作成される。 この経路を Web ブラウザーに入力すると、ネットワーク・トラフィックが ALB にルーティングされます。 ALB は、関連付けられたサービスを検索し、ネットワーク・トラフィックをそのサービスに送信します。 そして、サービスが、アプリを実行するポッドにトラフィックを転送します。

pathType

URL パス・マッチング方式。 サポートされている値は、ImplementationSpecific、Exact、または Prefix です。 各パスタイプの詳細と例については、 コミュニティ Kubernetes のドキュメントを参照してください。

service.name

app1_service および app2_service などを、アプリを公開するために作成したサービスの名前に置き換えます。 指定するアプリが同じ名前空間内にあることを確認してください。

service.name

<app1_service> および <app2_service> などを、アプリを公開するために作成したサービスの名前に置き換えます。 指定するアプリが同じ名前空間内にあることを確認してください。

service.port.number

サービスが listen するポート。 アプリ用に Kubernetes サービスを作成したときに定義したものと同じポートを使用します。

2. Ingressリソースをクラスタに適用します。 リソースで指定したアプリ・サービスと同じ名前空間にリソースがデプロイされていることを確認します。

   kubectl apply -f community-ingress-resource.yaml -n <namespace>
   

ステップ 4: Ingress セットアップを確認する

1. ALB をリストアップし、 Kubernetes Ingress イメージを実行している ALB の IP アドレス（クラシック）またはホスト名（VPC）をコピーします。 出力で、Build が形式 <community_version>_<ibm_build>_iks になっている ALB を選択します。

   ibmcloud ks ingress alb ls -c <cluster>
   

2. ALBのIPアドレス（クラシック）またはホスト名（VPC）、アプリのパス、およびドメインを使用して、このALBを介してアプリにトラフィックを正常に送信できることを確認します。

   curl http://<ALB_IP>/<app_path> -H "Host: <ingress_subdomain>"
   

   例えば、デフォルトのIngressサブドメインを使用して、 myapp というアプリにリクエストを送信するには、以下のコマンドを実行する。

   curl http://169.X.X.X/myapp -H "Host: mycluster-a1b2cdef345678g9hi012j3kl4567890-0000.us-south.containers.appdomain.cloud"
   

Ingress を介したアプリへの接続に問題が発生していますか? Ingress のトラブルシューティングを試してください。 ibmcloud ks ingress status-report get -c <cluster_name_or_ID> を実行すれば、Ingress コンポーネントの正常性と状況を確認できます。

パブリック ALB 用のカスタム・ドメインの作成

パブリック ALB のカスタム・ドメインを作成するには、以下の手順を実行します。

1. カスタム・ドメインを作成します。 カスタム・ドメインを登録する時には、Domain Name Service (DNS) プロバイダーまたは IBM Cloud DNS を使用してください。 Ingress で公開するアプリが 1 つのクラスター内の別々の名前空間にある場合は、カスタム・ドメインをワイルドカード・ドメイン (*.custom_domain.net など) として登録します。 Kubernetes バージョン 1.20 以降では、ドメインは 130 文字以下に制限されていることに注意してください。

2. IBM 提供サブドメインを正規名レコード (CNAME) として指定することで、カスタム・ドメインの別名を定義します。 IBM 提供の Ingress ドメインを確認するには、ibmcloud ks cluster get --cluster <cluster_name> を実行し、Ingress サブドメインフィールドを見つけます。

   IBM-提供されたサブドメインをCNAMEとして指定することは、DNSレスポンスから失敗したIPを削除する自動ヘルスチェックと、ALBを追加または削除したときにカスタムドメインが更新されることを保証するために必要です。

プライベート ALB 用のカスタム・ドメインの作成

プライベート ALB のカスタム・ドメインを作成するには、以下の手順を実行します。 プライベート ALB で Ingress を使用するには、カスタム・ドメインが必要であることに注意してください。

プライベート VLAN のみを使用するクラシック・クラスターの場合は、まず、プライベート・ネットワークで使用可能な独自の DNS サービスを構成する必要があります。

1. DNS サービス・プロバイダーを介してカスタム・ドメインを作成します。 Ingress URL は 130 文字以下でなければならないことに注意してください。

2. プライベート ALB の IP アドレスを A レコードとして追加するか (クラシック・クラスター)、VPC ホスト名を CNAME として追加して (VPC クラスター)、カスタム・ドメインをプライベート ALB にマップします。 ALB の IP アドレス (クラシック) またはホスト名 (VPC) を見つけるには、ibmcloud ks ingress alb ls -c <cluster_name_or_ID> を実行します。