ロードバランサーと DNS の設定

1. 次のような service.yamlYAML ファイルを作成します。

2. ファイル service.yaml で「Acceptor」を設定し、お使いの環境に応じて以下のいずれかの手順を実行してください：

   • Azure Kubernetes Service （ AKS ）について：

     apiVersion: v1
     kind: Service
     metadata:
       namespace: instana-core
       annotations:
         # For additional Loadbalancer annotations, kindly refer: https://cloud-provider-azure.sigs.k8s.io/topics/loadbalancer/#loadbalancer-annotations
         service.beta.kubernetes.io/azure-load-balancer-resource-group: <your-resource-group>
         service.beta.kubernetes.io/azure-load-balancer-internal: "false" #if internet facing
         service.beta.kubernetes.io/azure-dns-label-name: <dns-label-name>
       name: loadbalancer-acceptor
     spec:
       type: LoadBalancer
       externalTrafficPolicy: Local
       ports:
         - name: http-service
           port: 443
           protocol: TCP
           targetPort: http-service
       selector:
         app.kubernetes.io/name: instana
         app.kubernetes.io/component: acceptor
         instana.io/group: service
      

   • Amazon Elastic Kubernetes Service （EKS）の場合：

     apiVersion: v1
     kind: Service
     metadata:
       namespace: instana-core
       annotations:
         # To explore on more service annotations, kindly refer the documentation - https://kubernetes-sigs.github.io/aws-load-balancer-controller/v2.8/guide/service/annotations/
         service.beta.kubernetes.io/aws-load-balancer-name: <your-load-balancer-name>
         service.beta.kubernetes.io/aws-load-balancer-subnets: <subnet1-name>,<subnet2-name>,<subnet3-name>
         service.beta.kubernetes.io/aws-load-balancer-ip-address-type: ipv4
         service.beta.kubernetes.io/aws-load-balancer-scheme: "internet-facing"
       name: loadbalancer-acceptor
     spec:
       type: LoadBalancer
       externalTrafficPolicy: Local
       ports:
         - name: http-service
           port: 443
           protocol: TCP
           targetPort: http-service
       selector:
         app.kubernetes.io/name: instana
         app.kubernetes.io/component: acceptor
         instana.io/group: service
      

   • Google Kubernetes Engine （ GKE ）について：

     apiVersion: v1
     kind: Service
     metadata:
       namespace: instana-core
       annotations:
         # To explore on more service annotations, kindly refer the documentation https://cloud.google.com/kubernetes-engine/docs/concepts/service-load-balancer
         cloud.google.com/l4-rbs: "enabled"
       name: loadbalancer-acceptor
     spec:
       type: LoadBalancer
       loadBalancerIP: <your_loadbalancer_IP>
       externalTrafficPolicy: Local
       ports:
         - name: http-service
           port: 443
           protocol: TCP
           targetPort: http-service
       selector:
         app.kubernetes.io/name: instana
         app.kubernetes.io/component: acceptor
         instana.io/group: service
      

     < your_loadbalancer_IP> をロード・バランサーの IP アドレスに置き換えます。

3. ファイル service.yaml でゲートウェイを設定し、お使いの環境に応じて以下のいずれかの手順を実行してください：

   • Azure Kubernetes Service （ AKS ）について：

     apiVersion: v1
     kind: Service
     metadata:
       namespace: instana-core
       name: loadbalancer-gateway
       annotations:
         # For additional Loadbalancer annotations, kindly refer: https://cloud-provider-azure.sigs.k8s.io/topics/loadbalancer/#loadbalancer-annotations
         service.beta.kubernetes.io/azure-load-balancer-resource-group: <your-resource-group>
         service.beta.kubernetes.io/azure-load-balancer-internal: "false" #internet facing
         service.beta.kubernetes.io/azure-dns-label-name: <dns-label-name>
     spec:
       type: LoadBalancer
       externalTrafficPolicy: Local
       ports:
         - name: https
           port: 443
           protocol: TCP
           targetPort: https
         - name: http
           port: 80
           protocol: TCP
           targetPort: http
       selector:
         app.kubernetes.io/name: instana
         app.kubernetes.io/component: gateway
         instana.io/group: service
      

   • Amazon Elastic Kubernetes Service (Amazon EKS) の場合:

   apiVersion: v1
   kind: Service
   metadata:
     namespace: instana-core
     name: loadbalancer-gateway
     annotations:
       # To explore on more service annotations, kindly refer the documentation - https://kubernetes-sigs.github.io/aws-load-balancer-controller/v2.8/guide/service/annotations/
       service.beta.kubernetes.io/aws-load-balancer-name: <your-gateway-name>
       service.beta.kubernetes.io/aws-load-balancer-ip-address-type: ipv4
       service.beta.kubernetes.io/aws-load-balancer-scheme: "internet-facing"
       service.beta.kubernetes.io/aws-load-balancer-subnets: <subnet1-name>,<subnet2-name>,<subnet3-name>
   spec:
     type: LoadBalancer
     externalTrafficPolicy: Local
     ports:
       - name: https
         port: 443
         protocol: TCP
         targetPort: https
       - name: http
         port: 80
         protocol: TCP
         targetPort: http
     selector:
       app.kubernetes.io/name: instana
       app.kubernetes.io/component: gateway
       instana.io/group: service
    

   • Google Kubernetes Engine （ GKE ）について：

   apiVersion: v1
   kind: Service
   metadata:
     namespace: instana-core
     name: loadbalancer-gateway
     annotations:
       # To explore on more service annotations, kindly refer the documentation https://cloud.google.com/kubernetes-engine/docs/concepts/service-load-balancer
       cloud.google.com/l4-rbs: "enabled"
   spec:
     type: LoadBalancer
     loadBalancerIP: <your_loadbalancer_IP>
     externalTrafficPolicy: Local
     ports:
       - name: https
         port: 443
         protocol: TCP
         targetPort: https
       - name: http
         port: 80
         protocol: TCP
         targetPort: http
     selector:
       app.kubernetes.io/name: instana
       app.kubernetes.io/component: gateway
       instana.io/group: service
    

   注： <your_loadbalancer_IP> を、お使いのロードバランサーの IP アドレスに置き換えてください。

   ゲートウェイコントローラーが有効になっている場合は、次の例に示すように、loadbalancer-gatewayのセレクターを更新し、着信トラフィックが新しい gateway-v2 ポッドに正しく転送されるようにしてください。

   apiVersion: v1
   kind: Service
   metadata:
     namespace: instana-core
     name: loadbalancer-gateway
   spec:
     selector:
       ...
       app.kubernetes.io/component: gateway-v2 # changed from gateway
       ...
    

   ゲートウェイコントローラーが有効になっており、いずれかのアクセプター 443 に対してデフォルト以外のポートを設定している場合は、 Kubernetes がトラフィックをCustom Edition 環境に確実に取り込めるように、ゲートウェイロードバランサーに以下の設定ブロックを追加して、それらのポートを公開する必要があります：

   apiVersion: v1
   kind: Service
   metadata:
     namespace: instana-core
     name: loadbalancer-gateway
   spec:
     type: LoadBalancer
     ports:
       ...
       - name: <ACCEPTOR_NAME>
         port: <ACCEPTOR_PORT>
         protocol: TCP
         targetPort: <ACCEPTOR_PORT>
       ...
    

   . 以外のポートに設定されている各アクセプタポート 443について、ポート設定ブロックを追加する必要があります。

4. 次のコマンドを実行して、 YAML ファイルを適用します：

   kubectl apply -f service.yaml -n <CORE_NAMESPACE>
    

   < CORE_NAMESPACE> を Core オブジェクトの名前空間に置き換えます。

クライアントのWebブラウザと、 Red Hat OpenShift 上の Instana バックエンドの間に、ロードバランサーまたはリバースプロキシが配置されているシナリオを考えてみましょう。 このシナリオでは、 Instana バックエンドは、 Red Hat OpenShift Ingress Controllerを使用してリクエストを処理します。 ロードバランサーまたはリバースプロキシを設定することで、クライアントのIPアドレスを保持し、 x-forwarded-for ヘッダーを追加することができます。 この設定では、 TLS 接続を一旦切断し、ヘッダーを挿入した後、接続を再暗号化します。 再暗号化後、ロードバランサーまたはリバースプロキシは、 Red Hat OpenShift Ingress Controllerを介して、リクエストを Instana ゲートウェイに転送します。

この設定では、リクエストに正しいIPアドレスを含むヘッダーが x-forwarded-for すでに追加されているため、ルート passthrough を使用してトラフィックを Instana ゲートウェイに転送することができます。 その結果、Ingressコントローラーはリクエストを復号化する必要がありません。

クライアントのブラウザと Red Hat OpenShift 上の Instana バックエンドの間にロードバランサーやリバースプロキシが存在しない場合、 Red Hat OpenShift Ingress Controller が NAT を実行する唯一のコンポーネントとなります。 このシナリオでは、 ルート reencrypt は、リクエストが Instana ゲートウェイに到達する前に、その x-forwarded-for ヘッダーを追加することができます。 デフォルトでは、 Red Hat OpenShift のIngressコントローラーは、ヘッダーが存在しない場合は x-forwarded-for それを追加し、存在する場合はヘッダーにクライアントのIPアドレスを追加します。