|
|
|
@ -18,6 +18,8 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
the consul-helm repo's values.yaml file -->
|
|
|
|
|
<!-- codegen: start -->
|
|
|
|
|
|
|
|
|
|
### global
|
|
|
|
|
|
|
|
|
|
- `global` ((#v-global)) - Holds values that affect multiple components of the chart.
|
|
|
|
|
|
|
|
|
|
- `enabled` ((#v-global-enabled)) (`boolean: true`) - The main enabled/disabled setting. If true, servers,
|
|
|
|
@ -40,10 +42,10 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
Examples:
|
|
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
|
# Consul 1.5.0
|
|
|
|
|
image: "consul:1.5.0"
|
|
|
|
|
# Consul Enterprise 1.5.0
|
|
|
|
|
image: "hashicorp/consul-enterprise:1.5.0-ent"
|
|
|
|
|
# Consul 1.10.0
|
|
|
|
|
image: "consul:1.10.0"
|
|
|
|
|
# Consul Enterprise 1.10.0
|
|
|
|
|
image: "hashicorp/consul-enterprise:1.10.0-ent"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- `imagePullSecrets` ((#v-global-imagepullsecrets)) (`array<map>`) - Array of objects containing image pull secret names that will be applied to each service account.
|
|
|
|
@ -252,6 +254,8 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
- `enabled` ((#v-global-openshift-enabled)) (`boolean: false`) - If true, the Helm chart will create necessary configuration for running
|
|
|
|
|
its components on OpenShift.
|
|
|
|
|
|
|
|
|
|
### server
|
|
|
|
|
|
|
|
|
|
- `server` ((#v-server)) - Server, when enabled, configures a server cluster to run. This should
|
|
|
|
|
be disabled if you plan on connecting to a Consul cluster external to
|
|
|
|
|
the Kube cluster.
|
|
|
|
@ -519,6 +523,8 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
feature, in case kubernetes cluster is behind egress http proxies. Additionally,
|
|
|
|
|
it could be used to configure custom consul parameters.
|
|
|
|
|
|
|
|
|
|
### externalServers
|
|
|
|
|
|
|
|
|
|
- `externalServers` ((#v-externalservers)) - Configuration for Consul servers when the servers are running outside of Kubernetes.
|
|
|
|
|
When running external servers, configuring these values is recommended
|
|
|
|
|
if setting `global.tls.enableAutoEncrypt` to true (requires consul-k8s >= 0.13.0)
|
|
|
|
@ -561,6 +567,8 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
-o jsonpath="{.clusters[?(@.name=='<your cluster name>')].cluster.server}"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### client
|
|
|
|
|
|
|
|
|
|
- `client` ((#v-client)) - Values that configure running a Consul client on Kubernetes nodes.
|
|
|
|
|
|
|
|
|
|
- `enabled` ((#v-client-enabled)) (`boolean: global.enabled`) - If true, the chart will install all
|
|
|
|
@ -792,6 +800,8 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
...
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### dns
|
|
|
|
|
|
|
|
|
|
- `dns` ((#v-dns)) - Configuration for DNS configuration within the Kubernetes cluster.
|
|
|
|
|
This creates a service that routes to all agents (client or server)
|
|
|
|
|
for serving DNS requests. This DOES NOT automatically configure kube-dns
|
|
|
|
@ -817,6 +827,8 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
This should be a multi-line string mapping directly to a Kubernetes
|
|
|
|
|
ServiceSpec object.
|
|
|
|
|
|
|
|
|
|
### ui
|
|
|
|
|
|
|
|
|
|
- `ui` ((#v-ui)) - Values that configure the Consul UI.
|
|
|
|
|
|
|
|
|
|
- `enabled` ((#v-ui-enabled)) (`boolean: global.enabled`) - If true, the UI will be enabled. This will
|
|
|
|
@ -903,6 +915,8 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
- `baseURL` ((#v-ui-metrics-baseurl)) (`string: http://prometheus-server`) - baseURL is the URL of the prometheus server, usually the service URL.
|
|
|
|
|
This value is only used if `ui.enabled` is set to true.
|
|
|
|
|
|
|
|
|
|
### syncCatalog
|
|
|
|
|
|
|
|
|
|
- `syncCatalog` ((#v-synccatalog)) - Configure the catalog sync process to sync K8S with Consul
|
|
|
|
|
services. This can run bidirectional (default) or unidirectionally (Consul
|
|
|
|
|
to K8S or K8S to Consul only).
|
|
|
|
@ -1076,6 +1090,8 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
anotherLabelKey: another-label-value
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### connectInject
|
|
|
|
|
|
|
|
|
|
- `connectInject` ((#v-connectinject)) - Configures the automatic Connect sidecar injector.
|
|
|
|
|
|
|
|
|
|
- `enabled` ((#v-connectinject-enabled)) (`boolean: false`) - True if you want to enable connect injection. Set to "-" to inherit from
|
|
|
|
@ -1090,7 +1106,7 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
to explicitly opt-out of injection.
|
|
|
|
|
|
|
|
|
|
- `transparentProxy` ((#v-connectinject-transparentproxy)) - Configures Transparent Proxy for Consul Service mesh services.
|
|
|
|
|
Using this feature requires Consul 1.10.0+ and consul-k8s 0.26.0+.
|
|
|
|
|
Using this feature requires Consul 1.10.0-beta1+ and consul-k8s 0.26.0-beta1+.
|
|
|
|
|
|
|
|
|
|
- `defaultEnabled` ((#v-connectinject-transparentproxy-defaultenabled)) (`boolean: true`) - If true, then all Consul Service mesh will run with transparent proxy enabled by default,
|
|
|
|
|
i.e. we enforce that all traffic within the pod will go through the proxy.
|
|
|
|
@ -1110,6 +1126,7 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
add prometheus annotations to connect-injected pods. It will also
|
|
|
|
|
add a listener on the Envoy sidecar to expose metrics. The exposed
|
|
|
|
|
metrics will depend on whether metrics merging is enabled:
|
|
|
|
|
|
|
|
|
|
- If metrics merging is enabled:
|
|
|
|
|
the Consul sidecar will run a merged metrics server
|
|
|
|
|
combining Envoy sidecar and Connect service metrics,
|
|
|
|
@ -1120,7 +1137,7 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
|
|
|
|
|
- `defaultEnableMerging` ((#v-connectinject-metrics-defaultenablemerging)) (`boolean: false`) - Configures the Consul sidecar to run a merged metrics server
|
|
|
|
|
to combine and serve both Envoy and Connect service metrics.
|
|
|
|
|
This feature is available only in Consul v1.10-alpha or greater.
|
|
|
|
|
This feature is available only in Consul v1.10.0 or greater.
|
|
|
|
|
|
|
|
|
|
- `defaultMergedMetricsPort` ((#v-connectinject-metrics-defaultmergedmetricsport)) (`integer: 20100`) - Configures the port at which the Consul sidecar will listen on to return
|
|
|
|
|
combined metrics. This port only needs to be changed if it conflicts with
|
|
|
|
@ -1129,14 +1146,14 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
- `defaultPrometheusScrapePort` ((#v-connectinject-metrics-defaultprometheusscrapeport)) (`integer: 20200`) - Configures the port Prometheus will scrape metrics from, by configuring
|
|
|
|
|
the Pod annotation `prometheus.io/port` and the corresponding listener in
|
|
|
|
|
the Envoy sidecar.
|
|
|
|
|
NOTE: This is *not* the port that your application exposes metrics on.
|
|
|
|
|
NOTE: This is _not_ the port that your application exposes metrics on.
|
|
|
|
|
That can be configured with the
|
|
|
|
|
`consul.hashicorp.com/service-metrics-port` annotation.
|
|
|
|
|
|
|
|
|
|
- `defaultPrometheusScrapePath` ((#v-connectinject-metrics-defaultprometheusscrapepath)) (`string: /metrics`) - Configures the path Prometheus will scrape metrics from, by configuring the pod
|
|
|
|
|
annotation `prometheus.io/path` and the corresponding handler in the Envoy
|
|
|
|
|
sidecar.
|
|
|
|
|
NOTE: This is *not* the path that your application exposes metrics on.
|
|
|
|
|
NOTE: This is _not_ the path that your application exposes metrics on.
|
|
|
|
|
That can be configured with the
|
|
|
|
|
`consul.hashicorp.com/service-metrics-path` annotation.
|
|
|
|
|
|
|
|
|
@ -1293,6 +1310,8 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
|
|
|
|
|
- `initContainer` ((#v-connectinject-initcontainer)) (`map`) - Resource settings for the Connect injected init container.
|
|
|
|
|
|
|
|
|
|
### controller
|
|
|
|
|
|
|
|
|
|
- `controller` ((#v-controller)) - Controller handles config entry custom resources.
|
|
|
|
|
Requires consul >= 1.8.4.
|
|
|
|
|
ServiceIntentions require consul 1.9+.
|
|
|
|
@ -1331,6 +1350,7 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
`global.acls.manageSystemACLs`).
|
|
|
|
|
|
|
|
|
|
If running Consul OSS, requires permissions:
|
|
|
|
|
|
|
|
|
|
```hcl
|
|
|
|
|
operator = "write"
|
|
|
|
|
service_prefix "" {
|
|
|
|
@ -1338,12 +1358,15 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
intentions = "write"
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
If running Consul Enterprise, talk to your account manager for assistance.
|
|
|
|
|
|
|
|
|
|
- `secretName` ((#v-controller-acltoken-secretname)) (`string: null`) - The name of the Kubernetes secret.
|
|
|
|
|
|
|
|
|
|
- `secretKey` ((#v-controller-acltoken-secretkey)) (`string: null`) - The key of the Kubernetes secret.
|
|
|
|
|
|
|
|
|
|
### meshGateway
|
|
|
|
|
|
|
|
|
|
- `meshGateway` ((#v-meshgateway)) - Mesh Gateways enable Consul Connect to work across Consul datacenters.
|
|
|
|
|
|
|
|
|
|
- `enabled` ((#v-meshgateway-enabled)) (`boolean: false`) - If mesh gateways are enabled, a Deployment will be created that runs
|
|
|
|
@ -1469,6 +1492,8 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
'annotation-key': annotation-value
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### ingressGateways
|
|
|
|
|
|
|
|
|
|
- `ingressGateways` ((#v-ingressgateways)) - Configuration options for ingress gateways. Default values for all
|
|
|
|
|
ingress gateways are defined in `ingressGateways.defaults`. Any of
|
|
|
|
|
these values may be overridden in `ingressGateways.gateways` for a
|
|
|
|
@ -1562,6 +1587,8 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
|
|
|
|
|
- `name` ((#v-ingressgateways-gateways-name)) (`string: ingress-gateway`)
|
|
|
|
|
|
|
|
|
|
### terminatingGateways
|
|
|
|
|
|
|
|
|
|
- `terminatingGateways` ((#v-terminatinggateways)) - Configuration options for terminating gateways. Default values for all
|
|
|
|
|
terminating gateways are defined in `terminatingGateways.defaults`. Any of
|
|
|
|
|
these values may be overridden in `terminatingGateways.gateways` for a
|
|
|
|
@ -1643,11 +1670,15 @@ and consider if they're appropriate for your deployment.
|
|
|
|
|
|
|
|
|
|
- `name` ((#v-terminatinggateways-gateways-name)) (`string: terminating-gateway`)
|
|
|
|
|
|
|
|
|
|
### prometheus
|
|
|
|
|
|
|
|
|
|
- `prometheus` ((#v-prometheus)) - Configures a demo Prometheus installation.
|
|
|
|
|
|
|
|
|
|
- `enabled` ((#v-prometheus-enabled)) (`boolean: false`) - When true, the Helm chart will install a demo Prometheus server instance
|
|
|
|
|
alongside Consul.
|
|
|
|
|
|
|
|
|
|
### tests
|
|
|
|
|
|
|
|
|
|
- `tests` ((#v-tests)) - Control whether a test Pod manifest is generated when running helm template.
|
|
|
|
|
When using helm install, the test Pod is not submitted to the cluster so this
|
|
|
|
|
is only useful when running helm template.
|
|
|
|
|