旧バージョンのドキュメントを参照しています。最新のドキュメントはこちらをご参照ください。

Admin APIを構成する

Kong Gatewayは現在Kubernetes上で実行されています。Admin API はNodePortサービスであるため、一般には公開されていません。プロキシサービスは、パブリックアドレスを提供するLoadBalancerです。

kubectl port-forwardを使用せずにAdmin APIにアクセスできるようにするには、選択したクラウドに内部ロードバランサーを作成します。このプロセスは、Kong Managerを使用して構成を表示または編集するために必要です。

values-cp.yamlファイルを以下のイングレス構成で更新します。

イングレスコントローラを設定します。
EKS

AKS

GKE

KIC
EKSでイングレスリソースを構成するには、aws-load-balancer-controllerがクラスタにインストールされている必要があります。

インストール後、クラスターがaws-load-balancer-controllerを実行していることを確認します。
kubectl get deployments.apps -n kube-system aws-load-balancer-controller
AKSでイングレスリソースを構成するには、application-gateway-kubernetes-ingressがクラスタにインストールされている必要があります。

インストール後、クラスタがingress-appgw-deploymentを実行していることを確認します。
kubectl get deployments.apps -n kube-system ingress-appgw-deployment
GKEバージョン1.18以降を実行するクラスタは、Ingressリソースの作成に応じてロードバランサーを自動的にプロビジョニングします。

GKEでは、Kongのデプロイメントが正常とマークされるためには BackendConfig リソースを作成する必要があります。
1. ヘルスチェックを構成するには、BackendConfigリソースを作成します。
  
  echo "apiVersion: cloud.google.com/v1 kind: BackendConfig metadata: name: kong-hc namespace: kong spec: healthCheck: checkIntervalSec: 15 port: 8100 type: HTTP requestPath: /status" | kubectl apply -f -
2. この BackendConfig は、次の中にある annotations キーを使用して admin サービスにアタッチされますvalues-cp.yaml
GKEは、Ingress定義ごとにロードバランサを1つプロビジョニングします。このガイドに従うと、複数のロードバランサが作成されます。
Kong Ingress Controller を有効にするには、values-cp.yaml ファイルで ingressController.enabled を true に設定します。イングレスコントローラーを有効にするときは、env.publish_service を設定して、管理された Ingress リソースのアドレスフィールドに Kong Ingress Controller が入力されるようにします。

Kong Ingress ControllerとKong Gateway Admin API間の通信を有効にするには、 ingressController.env.kong_admin_tokenをenv.passwordに保存されている値に設定する必要があります。
ingressController: enabled: true env: publish_service: kong/kong-dp-kong-proxy kong_admin_token: kong_admin_password

values-cp.yamlでadmin セクションを設定します。example.com をカスタムドメイン名に置き換えます。

EKS

AKS

GKE

KIC

テスト中に、VPC に VPN が設定されていない場合は、alb.ingress.kubernetes.io/scheme アノテーションをinternet-facing に変更してパブリック IP アドレスを追加できます。これは、 デプロイが長期間にわたる場合にはお勧めできません

admin:
  enabled: true
  http:
    enabled: true
  tls:
    enabled: false
     
  ingress:
    enabled: true
    hostname: admin.example.com
    path: /
    pathType: Prefix
    ingressClassName: alb
    annotations:
      alb.ingress.kubernetes.io/load-balancer-name: kong-alb-private
      alb.ingress.kubernetes.io/group.name: demo.kong-alb-private
      alb.ingress.kubernetes.io/target-type: instance
      alb.ingress.kubernetes.io/scheme: internal
      alb.ingress.kubernetes.io/healthcheck-path: /
      alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80}]'

テスト中でVPNを設定していない場合は、パブリック IP アドレスを追加するには、 falseにappgw.ingress.kubernetes.io/use-private-ipアノテーションを追加します。これは 長期にわたるデプロイメントにはお勧めできません

admin:
  enabled: true
  http:
    enabled: true
  tls:
    enabled: false
     
  ingress:
    enabled: true
    hostname: admin.example.com
    path: /
    pathType: Prefix
    ingressClassName: azure-application-gateway
    annotations:
      appgw.ingress.kubernetes.io/use-private-ip: "true"

テスト中でVPNを設定していない場合は、パブリック IP アドレスを追加するには、 gceにkubernetes.io/ingress.classアノテーションを追加します。これは 長期にわたるデプロイメントにはお勧めできません

admin:
  enabled: true
  http:
    enabled: true
  tls:
    enabled: false
  annotations:
    beta.cloud.google.com/backend-config: '{"default":"kong-hc"}'
  ingress:
    enabled: true
    hostname: admin.example.com
    path: /
    pathType: Prefix
    annotations:
      kubernetes.io/ingress.class: gce-internal

Kong Ingress Controllerによってプロキシされるすべてのエンドポイントはパブリックにアクセス可能になります。認証プラグインを使用してAPIを保護してください。

admin:
  enabled: true
  http:
    enabled: true
  tls:
    enabled: false
     
  ingress:
    enabled: true
    hostname: admin.example.com
    path: /
    pathType: Prefix
    ingressClassName: kong

helm upgradeを実行してリリースを作成します。

helm upgrade kong-cp kong/kong -n kong --values ./values-cp.yaml

Ingress IPアドレスを取得し、イングレスアドレスを指すようにDNSレコードを更新します。DNSを手動で構成することも、external-dnsなどのツールを使用してDNS構成を自動化することもできます。
```
kubectl get ingress -n kong kong-cp-kong-admin -o jsonpath='{.spec.rules[0].host}{": "}{range .status.loadBalancer.ingress[0]}{@.ip}{@.hostname}{end}'
```

前へ Kong Gatewayのインストール

次へ Kong Managerのインストール