このページは、まだ日本語ではご利用いただけません。翻訳中です。
旧バージョンのドキュメントを参照しています。 最新のドキュメントはこちらをご参照ください。
Kong Mesh with Helm
To install and run Kong Mesh on Kubernetes using Helm:
Finally, you can follow the Quickstart to take it from here and continue your Kong Mesh journey.
Prerequisites
You have a license for Kong Mesh.
1. Add the Kong Mesh Helm Repository
To start using Kong Mesh with Helm charts, first add the Kong Mesh charts repository to your local Helm deployment:
$ helm repo add kong-mesh https://kong.github.io/kong-mesh-charts
Once the repo is added, any following updates can be fetched with
helm repo update
.
2. Run Kong Mesh
Install and run Kong Mesh using the following commands.
You can use any Kubernetes namespace to install Kong Mesh, but as a default, we
suggest kong-mesh-system
.
-
Create the
kong-mesh-system
namespace:$ kubectl create namespace kong-mesh-system
-
Upload the license secret to the cluster:
$ kubectl create secret generic kong-mesh-license -n kong-mesh-system --from-file=/path/to/license.json
Where
/path/to/license.json
is the path to a valid Kong Mesh license file on the file system.The filename should be
license.json
, unless otherwise specified invalues.yaml
. -
Deploy the Kong Mesh Helm chart.
By default, the license option is disabled, so you need to enable it for the license to take effect. The easiest option is to override each field on the CLI. The only downside to this method is that you need to supply these values every time you run a
helm upgrade
, otherwise they will be reverted back to what the chart’s default values are for those fields, i.e. disabled.$ helm repo update $ helm upgrade -i -n kong-mesh-system kong-mesh kong-mesh/kong-mesh \ --set kuma.controlPlane.secrets[0].Env="KMESH_LICENSE_INLINE" \ --set kuma.controlPlane.secrets[0].Secret="kong-mesh-license" \ --set kuma.controlPlane.secrets[0].Key="license.json"
This example will run Kong Mesh in standalone mode for a flat deployment, but there are more advanced deployment modes like multi-zone.
You can see all possible parameters of the charts by running
helm show values kong-mesh/kong-mesh
. The Kong-Mesh chart has the Kuma chart as a helm dependency any value present inhelm show values kuma/kuma
is available by prepending it with:kuma
.For example, see the following
values.yaml
snippet:kuma: controlPlane: zone: "us-west" mode: "zone"
This will configure the control-plane as the zone “us-west” in
zone
mode.
3. Verify the Installation
Now that Kong Mesh (kuma-cp
) has been installed in the newly
created kong-mesh-system
namespace, you can access the control plane using either
the GUI, kubectl
, the HTTP API, or the CLI:
You will notice that Kong Mesh automatically creates a Mesh
entity with the name default
.
4. Quickstart
The Kuma quickstart documentation is fully compatible with Kong Mesh, except that you are running Kong Mesh containers instead of Kuma containers.
To start using Kong Mesh, see the quickstart guide for Kubernetes deployments.