クラスターレベルの Ingress コントローラー—ArcGIS Enterprise on Kubernetes

組織に、ArcGIS Enterprise on Kubernetes デプロイメントにルーティングされるクライアントトラフィックの処理に関する特定の要件がある場合があります。これらの要件には、Web アプリケーションファイアウォール機能、パスベースおよびホストベースのルート検索、クライアントリクエストヘッダーに基づく他の決定論的なルート検索の動作など、OSI モデルのレイヤー 7 で動作するプロバイダー固有の負荷分散ソリューションが提供する高度な機能を使用する必要があることもあります。

管理者は、クラスターレベルの Ingress コントローラーを使用して、着信トラフィックを ArcGIS Enterprise on Kubernetes デプロイメントにルーティングできます。 Ingress コントローラーは、それぞれの L7 ロードバランサーの実装で Kubernetes Ingress オブジェクトを機能ルート検索ルールに変換します。 Ingress オブジェクト内の仕様には、Kubernetes 名前空間内の 1 つ以上のバックエンドサービスオブジェクトに対するルート検索のセットが含まれています。

これらの Ingress オブジェクトは、Amazon Elastic Kubernetes Service (EKS)、Microsoft Azure Kubernetes Service (AKS)、Google Kubernetes Engine などのマネージドクラウドプロバイダー上でレイヤー 7 対応のロードバランサーにより最終的に実現されます。特定のアノテーションおよび ingressClass 名を持つ Ingress オブジェクトを作成すると、フロントエンドとバックエンドのリスナーおよびターゲットグループの設定を含むロードバランサーのプロビジョニングと構成が開始される場合があります。これらのクラスターレベルの Ingress コントローラーは、クラスターのエッジから内部に公開されたサービスへのトラフィックのルーティングを処理します。

クラスターレベルの Ingress コントローラーを使用して、さまざまなプラットフォームでトラフィックを ArcGIS Enterprise on Kubernetes デプロイメントにルーティングする方法の詳細については、以下をご参照ください。

Kubernetes Ingress オブジェクトの作成によるレイヤー 7 のロードバランサーの初期デプロイメントと構成を行うことができる一般およびプラットフォーム固有の Ingress YAML データが提供されます。 Ingress YAML データは、ドキュメントで、また layer-7-templates フォルダー内のテンプレートとして提供されます。追加の Ingress オブジェクトアノテーションを提供することで、組織のニーズに合わせてこれらの Ingress オブジェクトをさらに構成できます。必要な場合は、既存のクラスター内 NGINX Ingress コントローラーサービスにアノテーションを作成することもでき、これらのアノテーションを実行する手順が提供されています。

注意:

一部のプロバイダーでは、新しく作成された Ingress を使用して正しい接続を作成するには、arcgis-ingress-controller デプロイメントを更新する必要があります。 Ingress を作成した後で ArcGIS Enterprise Manager にアクセスしたときにエラーが表示された場合は、次の操作を実行してみてください。

kubectl rollout restart deployment/arcgis-ingress-controller -n <deploymentNamespace>

一般的な Ingress の要件

このドキュメントで指定されていないプラットフォームで Ingress コントローラーを使用する場合は、次の一般的な要件を考慮してください。

トラフィックを ArcGIS Enterprise on Kubernetes デプロイメントにルーティングするよう Ingress オブジェクトを構成している場合、クライアントトラフィックのルーティング先のバックエンドターゲットとして、クラスター内 arcgis-ingress-nginx サービスを使用します。
Ingress コントローラーが管理するロードバランサーからバックエンドのクラスター内 NGINX Ingress コントローラーにトラフィックを渡している場合、TLS プロトコルを使用します。
id: custom ingress resource ラベルは必須であり、削除することはできません。これは、デプロイメントおよびアンデプロイメント中に Ingress オブジェクトを管理するため、デプロイメントスクリプトによって使用されます。

プロバイダー固有ではなく、トラフィックを ArcGIS Enterprise on Kubernetes デプロイメントにルーティングするために必要な値を含んでいる Ingress YAML の単純化した例を次に示します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: arcgis-enterprise-ingress
  namespace: <deploymentNamespace>
  annotations:

  labels:
    id: custom-ingress-resource
spec:
  tls:
    - hosts:
        - <deploymentFQDN>
      secretName: <tlsSecretName>
  rules:
    - host: <deploymentFQDN>
      http:
        paths:
          - backend:
             service:
               name: arcgis-ingress-nginx
               port:
                 number: 443
            path: /<context>
            pathType: Prefix

注意:

上記の例では、証明書情報を含んでいる TLS シークレットがデプロイメント名前区間内に作成され、Ingress コントローラーで TLS 証明書を構成するために使用されます。一部のプロバイダーでは、アノテーションを使用してこの情報を指定でき、これも使用できます。

デプロイメントの要件

ArcGIS Enterprise on Kubernetes を最初にデプロイしたとき、クラスターレベルの Ingress コントローラーを使用して、トラフィックをデプロイメントにルーティングする必要があります。この方法は、デプロイメントスクリプトを実行するモードによって異なります。

サイレントモードでスクリプトを実行している場合は、INGRESS_SERVICE_USE_CLUSTER_IP=true を deploy.properties ファイル内に設定します。このプロパティは、INGRESS_TYPE パラメーターに設定された値をオーバーライドします。デプロイメントスクリプトの実行中に Ingress オブジェクトを作成する場合は、CLUSTER_INGRESS_CONTROLLER_YAML_FILENAME を Ingress YAML ファイルの場所に設定します。デプロイメントスクリプトの実行中の Ingress オブジェクトの作成は、AWS Application Load Balancer、Azure Application Gateway、および Google Cloud Platform Application Load Balancer でのみサポートされます。
インタラクティブライブモードでスクリプトを実行している場合、クラウドバランサーをプロビジョニングするかどうかをたずねられたら no と答え、クラスターレベルの Ingress コントローラーを使用してトラフィックをデプロイメントにルーティングするかどうかをたずねられたら yes と答えます。これにより、クラスター内 NGINX Ingress コントローラーサービスは ClusterIP タイプとして作成されるようになり、クライアントトラフィックをリクエストされた ArcGIS Enterprise エンドポイントにルーティングできます。

レイヤー 7 ロードバランサーは、クラスター内でサービスへのクライアントトラフィックのアクセスポイントとして機能します。 ArcGIS Enterprise on Kubernetes の場合、クラスターレベルの Ingress コントローラーを、アプリケーションの一部としてデプロイされた埋め込み Ingress コントローラーにトラフィックを渡すように構成する必要があります。

注意:

ArcGIS Enterprise 11.2 以前では、クラスター Ingress コントローラーサービスを ClusterIP タイプとして作成する機能は、OpenShift Route を使用してトラフィックをデプロイメントにルーティングするかどうかを指定するオプションにより提供されました。この質問はデプロイメントスクリプト内で変更され、クラスターレベルの Ingress コントローラーを使用してトラフィックをデプロイメントにルーティングするかどうかをたずねます。このオプションを true に設定すると、デプロイメントの INGRESS_TYPE が NodePort または LoadBalancer に設定されているかどうかに関係なく、Ingress コントローラーサービスは ClusterIP タイプとして作成されます。

このトピックへのフィードバック