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

Kong Managerのインストール

Kong Managerは、Kong Gatewayのグラフィカルユーザーインターフェース（GUI）です。内部的にはKong Admin APIを使用してKong Gatewayを管理および制御します。

Kong Managerを使用するには、ローカルマシンからKongのAdmin APIにHTTP経由でアクセスできる必要があります。

前提条件

Kong Gatewayがインストール済み
KongのAdmin APIはローカルマシンからHTTP経由でアクセスできます。

インストール

Kong Managerは、Admin APIと同じノードから提供されます。Kong Managerを有効にするには、values-cp.yamlファイルに次の変更を加えます。

envキーの下に、admin_gui_url、admin_gui_api_url、admin_gui_session_confを設定します。

env:
  admin_gui_url: http://manager.example.com
  admin_gui_api_url: http://admin.example.com
  # Change the secret and set cookie_secure to true if using a HTTPS endpoint
  admin_gui_session_conf: '{"secret":"secret","storage":"kong","cookie_secure":false}'

構成内のexample.comをドメインに置き換えてください。

enterpriseキーでKong Manager認証を有効にします。

enterprise:
  rbac:
    enabled: true
    admin_gui_auth: basic-auth

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

EKS

AKS

GKE

KIC

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

manager:
  enabled: true
  http:
    enabled: true
  tls:
    enabled: false
     
  ingress:
    enabled: true
    hostname: manager.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アノテーションを追加します。これは 長期にわたるデプロイメントにはお勧めできません

manager:
  enabled: true
  http:
    enabled: true
  tls:
    enabled: false
     
  ingress:
    enabled: true
    hostname: manager.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アノテーションを追加します。これは 長期にわたるデプロイメントにはお勧めできません

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

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

manager:
  enabled: true
  http:
    enabled: true
  tls:
    enabled: false
     
  ingress:
    enabled: true
    hostname: manager.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-manager -o jsonpath='{.spec.rules[0].host}{": "}{range .status.loadBalancer.ingress[0]}{@.ip}{@.hostname}{end}'
```

テスト

Kong Managerのログインページを表示するには、ウェブブラウザでenv.admin_gui_urlのURLにアクセスします。デフォルトのユーザー名は「kong_admin」で、パスワードは前のステップでKong Gatewayコントロールプレーン（CP）をインストールしたときに、env.passwordに設定した値です。

トラブルシューティング

Kong Manager にログインできません

Kong をインストールする前に、 values-cp.yamlにenv.passwordが設定されていることを確認してください。Kong Gatewayは、設定されていない場合はランダムな管理者パスワードを生成します。このパスワードは回復できないため、新しい管理者パスワードを設定するにはKongを再インストールする必要があります。

私のログイン認証情報は何ですか?

Kong のスーパー管理者のユーザー名は kong_admin で、パスワードは values-cp.yaml の env.password に設定された値です。

Kong Managerが白い画面を表示する

env.admin_gui_api_urlがvalues-cp.yaml に正しく設定されていることを確認してください。

前へ Admin APIを構成する