手順 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: public-iks-traefik
     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-traefik 、プライベートALBの場合は private-iks-traefik です。

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 を実行します。