2024-11-07 14:24:36 +01:00
![Type: application ](https://img.shields.io/badge/Type-application-informational?style=flat-square ) ![Version: 0.5.5 ](https://img.shields.io/badge/Version-0.5.5-informational?style=flat-square )
2024-09-20 16:11:23 +02:00
[![Artifact Hub ](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/victoriametrics )](https://artifacthub.io/packages/helm/victoriametrics/victoria-metrics-gateway)
[![Slack ](https://img.shields.io/badge/join%20slack-%23victoriametrics-brightgreen.svg )](https://slack.victoriametrics.com/)
2024-11-05 19:05:24 +01:00
Victoria Metrics Gateway - Auth & Rate-Limitting proxy for Victoria Metrics
2024-09-20 16:11:23 +02:00
# Table of Content
* [Prerequisites ](#prerequisites )
* [Chart Details ](#chart-details )
* [How to Install ](#how-to-install )
* [How to Uninstall ](#how-to-uninstall )
* [How to use JWT signature verification ](#how-to-use-jwt-signature-verification )
* [Documentation of Helm Chart ](#documentation-of-helm-chart )
## Prerequisites
2024-10-04 10:50:23 +02:00
* Install the follow packages: ``git``, ``kubectl``, ``helm``, ``helm-docs``. See this [tutorial ](https://docs.victoriametrics.com/helm/requirements/ ).
2024-09-20 16:11:23 +02:00
* PV support on underlying infrastructure
## Chart Details
This chart will do the following:
* Rollout victoria metrics gateway
## How to install
Access a Kubernetes cluster.
### Setup chart repository (can be omitted for OCI repositories)
Add a chart helm repository with follow commands:
```console
helm repo add vm https://victoriametrics.github.io/helm-charts/
helm repo update
```
List versions of `vm/victoria-metrics-gateway` chart available to installation:
```console
helm search repo vm/victoria-metrics-gateway -l
```
### Install `victoria-metrics-gateway` chart
Export default values of `victoria-metrics-gateway` chart to file `values.yaml` :
- For HTTPS repository
```console
helm show values vm/victoria-metrics-gateway > values.yaml
```
- For OCI repository
```console
helm show values oci://ghcr.io/victoriametrics/helm-charts/victoria-metrics-gateway > values.yaml
```
Change the values according to the need of the environment in ``values.yaml`` file.
Test the installation with command:
- For HTTPS repository
```console
helm install vmg vm/victoria-metrics-gateway -f values.yaml -n NAMESPACE --debug --dry-run
```
- For OCI repository
```console
helm install vmg oci://ghcr.io/victoriametrics/helm-charts/victoria-metrics-gateway -f values.yaml -n NAMESPACE --debug --dry-run
```
Install chart with command:
- For HTTPS repository
```console
helm install vmg vm/victoria-metrics-gateway -f values.yaml -n NAMESPACE
```
- For OCI repository
```console
helm install vmg oci://ghcr.io/victoriametrics/helm-charts/victoria-metrics-gateway -f values.yaml -n NAMESPACE
```
Get the pods lists by running this commands:
```console
kubectl get pods -A | grep 'vmg'
```
Get the application by running this command:
```console
helm list -f vmg -n NAMESPACE
```
See the history of versions of `vmg` application with command.
```console
helm history vmg -n NAMESPACE
```
# How to use [JWT signature verification](https://docs.victoriametrics.com/vmgateway#jwt-signature-verification)
Kubernetes best-practice is to store sensitive configuration parts in secrets. For example, 2 keys will be stored as:
```yaml
apiVersion: v1
data:
key: "< < KEY_DATA > >"
kind: Secret
metadata:
name: key1
---
apiVersion: v1
data:
key: "< < KEY_DATA > >"
kind: Secret
metadata:
name: key2
```
In order to use those secrets it is needed to:
- mount secrets into pod
- provide flag pointing to secret on disk
Here is an example `values.yml` file configuration to achieve this:
```yaml
auth:
enable: true
extraVolumes:
- name: key1
secret:
secretName: key1
- name: key2
secret:
secretName: key2
extraVolumeMounts:
- name: key1
mountPath: /key1
- name: key2
mountPath: /key2
extraArgs:
envflag.enable: "true"
envflag.prefix: VM_
loggerFormat: json
auth.publicKeyFiles: "/key1/key,/key2/key"
```
Note that in this configuration all secret keys will be mounted and accessible to pod.
Please, refer to [this ](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.19/#secretvolumesource-v1-core ) doc to see all available secret source options.
## How to uninstall
Remove application with command.
```console
helm uninstall vmg -n NAMESPACE
```
## Documentation of Helm Chart
2024-10-04 10:50:23 +02:00
Install ``helm-docs`` following the instructions on this [tutorial ](https://docs.victoriametrics.com/helm/requirements/ ).
2024-09-20 16:11:23 +02:00
Generate docs with ``helm-docs`` command.
```bash
cd charts/victoria-metrics-gateway
helm-docs
```
The markdown generation is entirely go template driven. The tool parses metadata from charts and generates a number of sub-templates that can be referenced in a template file (by default ``README.md.gotmpl``). If no template file is provided, the tool has a default internal template that will generate a reasonably formatted README.
## Parameters
The following tables lists the configurable parameters of the chart and their default values.
Change the values according to the need of the environment in ``victoria-metrics-gateway/values.yaml`` file.
2024-09-23 07:17:34 +02:00
< table class = "helm-vars" >
2024-09-20 16:11:23 +02:00
< thead >
2024-09-23 07:17:34 +02:00
< th class = "helm-vars-key" > Key< / th >
< th class = "helm-vars-type" > Type< / th >
< th class = "helm-vars-default" > Default< / th >
< th class = "helm-vars-description" > Description< / th >
2024-09-20 16:11:23 +02:00
< / thead >
< tbody >
< tr >
< td > affinity< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Affinity configurations< / p >
< / td >
< / tr >
< tr >
< td > annotations< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Annotations to be added to the deployment< / p >
< / td >
< / tr >
< tr >
< td > auth< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > enabled: false
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Access Control configuration. Check < a href = "https://docs.victoriametrics.com/vmgateway#access-control" target = "_blank" > here< / a > for details< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > auth.enabled< / td >
< td > bool< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > false
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Enable/Disable access-control< / p >
< / td >
< / tr >
< tr >
< td > clusterMode< / td >
< td > bool< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > false
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Specify to True if the source for rate-limiting, reading and writing as a VictoriaMetrics Cluster. Must be true for rate limiting< / p >
< / td >
< / tr >
< tr >
< td > configMap< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Use existing configmap if specified otherwise .config values will be used. Check < a href = "https://docs.victoriametrics.com/vmgateway" target = "_blank" > here< / a > for details< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > containerWorkingDir< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > /
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Container working directory< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > env< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Additional environment variables (ex.: secret tokens, flags). Check < a href = "https://github.com/VictoriaMetrics/VictoriaMetrics#environment-variables" target = "_blank" > here< / a > for details.< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > envFrom< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Specify alternative source for env variables< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
2024-09-23 07:17:34 +02:00
< td > extraArgs< / td >
< td > object< / td >
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > envflag.enable: "true"
envflag.prefix: VM_
loggerFormat: json
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Extra command line arguments for container of component< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > extraContainers< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Extra containers to run in a pod with vmgateway< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > extraHostPathMounts< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Additional hostPath mounts< / p >
2024-11-07 14:24:36 +01:00
< / td >
< / tr >
< tr >
< td > extraLabels< / td >
< td > object< / td >
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
< / pre >
< / td >
< td > < p > Labels to be added to Deployment< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > extraVolumeMounts< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Extra Volume Mounts for the container< / p >
< / td >
< / tr >
< tr >
< td > extraVolumes< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Extra Volumes for the pod< / p >
< / td >
< / tr >
< tr >
< td > fullnameOverride< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-11-12 17:00:19 +01:00
< td > < p > Override resources fullname< / p >
2024-11-07 14:24:36 +01:00
< / td >
< / tr >
< tr >
< td > global.cluster.dnsDomain< / td >
< td > string< / td >
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > cluster.local.
< / code >
< / pre >
< / td >
< td > < p > K8s cluster domain suffix, uses for building storage pods’ FQDN. Details are < a href = "https://kubernetes.io/docs/tasks/administer-cluster/dns-custom-nameservers/" target = "_blank" > here< / a > < / p >
2024-09-23 07:17:34 +02:00
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
2024-09-23 07:17:34 +02:00
< td > global.compatibility< / td >
< td > object< / td >
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > openshift:
adaptSecurityContext: auto
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Openshift security context compatibility configuration< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > global.image.registry< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Image registry, that can be shared across multiple helm charts< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > global.imagePullSecrets< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Image pull secrets, that can be shared across multiple helm charts< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > image.pullPolicy< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > IfNotPresent
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Pull policy of Docker image< / p >
< / td >
< / tr >
< tr >
< td > image.registry< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Victoria Metrics gateway Docker registry< / p >
< / td >
< / tr >
< tr >
< td > image.repository< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > victoriametrics/vmgateway
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Victoria Metrics gateway Docker repository and image name< / p >
< / td >
< / tr >
< tr >
< td > image.tag< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Tag of Docker image override Chart.AppVersion< / p >
< / td >
< / tr >
< tr >
< td > image.variant< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Variant of the image to use. e.g. enterprise, enterprise-scratch< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > imagePullSecrets< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Image pull secrets< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > ingress.annotations< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Ingress annotations< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > ingress.enabled< / td >
< td > bool< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > false
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Enable deployment of ingress for server component< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > ingress.extraLabels< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Ingress extra labels< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > ingress.hosts< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Array of host objects< / p >
< / td >
< / tr >
< tr >
< td > ingress.ingressClassName< / td >
< td > string< / td >
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
< / pre >
< / td >
< td > < p > Ingress controller class name< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > ingress.pathType< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > Prefix
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Ingress path type< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > ingress.tls< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Array of TLS objects< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > license< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > key: ""
2024-09-20 16:11:23 +02:00
secret:
key: ""
name: ""
2024-09-23 07:17:34 +02:00
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Enterprise license key configuration for VictoriaMetrics enterprise. Required only for VictoriaMetrics enterprise. Check docs < a href = "https://docs.victoriametrics.com/enterprise" target = "_blank" > here< / a > , for more information, visit < a href = "https://victoriametrics.com/products/enterprise/" target = "_blank" > site< / a > . Request a trial license < a href = "https://victoriametrics.com/products/enterprise/trial/" target = "_blank" > here< / a > Supported starting from VictoriaMetrics v1.94.0< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > license.key< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > License key< / p >
< / td >
< / tr >
< tr >
< td > license.secret< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > key: ""
2024-09-20 16:11:23 +02:00
name: ""
2024-09-23 07:17:34 +02:00
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Use existing secret with license key< / p >
< / td >
< / tr >
< tr >
< td > license.secret.key< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Key in secret with license key< / p >
< / td >
< / tr >
< tr >
< td > license.secret.name< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Existing secret name< / p >
< / td >
< / tr >
< tr >
< td > nameOverride< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-11-12 17:00:19 +01:00
< td > < p > Override chart name< / p >
2024-09-23 07:17:34 +02:00
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > nodeSelector< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > NodeSelector configurations. Check < a href = "https://kubernetes.io/docs/user-guide/node-selection/" target = "_blank" > here< / a > for details< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > podAnnotations< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Annotations to be added to pod< / p >
< / td >
< / tr >
< tr >
< td > podDisruptionBudget< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > enabled: false
2024-09-20 16:11:23 +02:00
labels: {}
2024-09-23 07:17:34 +02:00
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > See < code > kubectl explain poddisruptionbudget.spec< / code > for more. Check < a href = "https://kubernetes.io/docs/tasks/run-application/configure-pdb/" target = "_blank" > here< / a > for details< / p >
2024-11-07 14:24:36 +01:00
< / td >
< / tr >
< tr >
< td > podLabels< / td >
< td > object< / td >
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
< / pre >
< / td >
< td > < p > Labels to be added to pod< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
2024-09-23 07:17:34 +02:00
< td > podSecurityContext< / td >
< td > object< / td >
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > enabled: true
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Pod’ s security context. Details are < a href = "https://kubernetes.io/docs/tasks/configure-pod-container/security-context/" target = "_blank" > here< / a > < / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > probe.liveness< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > initialDelaySeconds: 5
2024-09-20 16:11:23 +02:00
periodSeconds: 15
tcpSocket: {}
timeoutSeconds: 5
2024-09-23 07:17:34 +02:00
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Liveness probe< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > probe.readiness< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > httpGet: {}
2024-09-20 16:11:23 +02:00
initialDelaySeconds: 5
periodSeconds: 15
2024-09-23 07:17:34 +02:00
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Readiness probe< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > probe.startup< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Startup probe< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > rateLimiter< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > config: {}
2024-09-20 16:11:23 +02:00
datasource:
url: ""
enabled: false
2024-09-23 07:17:34 +02:00
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Rate limiter configuration. Docs are < a href = "https://docs.victoriametrics.com/vmgateway#rate-limiter" target = "_blank" > here< / a > < / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > rateLimiter.datasource.url< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Datasource VictoriaMetrics or vmselects. Required. Example < a href = "http://victoroametrics:8428" target = "_blank" > http://victoroametrics:8428< / a > or < a href = "http://vmselect:8481/select/0/prometheus" target = "_blank" > http://vmselect:8481/select/0/prometheus< / a > < / p >
< / td >
< / tr >
< tr >
< td > rateLimiter.enabled< / td >
< td > bool< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > false
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Enable/Disable rate-limiting< / p >
< / td >
< / tr >
< tr >
< td > read.url< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Read endpoint without suffixes, victoriametrics or vmselect. Example < a href = "http://victoroametrics:8428" target = "_blank" > http://victoroametrics:8428< / a > or < a href = "http://vmselect:8481" target = "_blank" > http://vmselect:8481< / a > < / p >
< / td >
< / tr >
< tr >
< td > replicaCount< / td >
< td > int< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > 1
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Number of replicas of vmgateway< / p >
< / td >
< / tr >
< tr >
< td > resources< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > We usually recommend not to specify default resources and to leave this as a conscious choice for the user. This also increases chances charts run on environments with little resources, such as Minikube. If you do want to specify resources, uncomment the following lines, adjust them as necessary, and remove the curly braces after ‘ resources:’ .< / p >
< / td >
< / tr >
< tr >
< td > securityContext< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > enabled: true
2024-09-20 16:11:23 +02:00
runAsGroup: 1000
runAsNonRoot: true
runAsUser: 1000
2024-09-23 07:17:34 +02:00
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Pod security context. Check < a href = "https://kubernetes.io/docs/tasks/configure-pod-container/security-context/" target = "_blank" > here< / a > for details< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > service.annotations< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Service annotations< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > service.clusterIP< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Service ClusterIP< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > service.enabled< / td >
< td > bool< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > true
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Enabled vmgateway service< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > service.externalIPs< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
< / pre >
< / td >
< td > < p > Service external IPs. Check < a href = "https://kubernetes.io/docs/user-guide/services/#external-ips" target = "_blank" > here< / a > for details< / p >
< / td >
< / tr >
< tr >
< td > service.externalTrafficPolicy< / td >
< td > string< / td >
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Service external traffic policy. Check < a href = "https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/#preserving-the-client-source-ip" target = "_blank" > here< / a > for details< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > service.extraLabels< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Service labels< / p >
< / td >
< / tr >
< tr >
< td > service.healthCheckNodePort< / td >
< td > string< / td >
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
< / pre >
< / td >
< td > < p > Health check node port for a service. Check < a href = "https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/#preserving-the-client-source-ip" target = "_blank" > here< / a > for details< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > service.ipFamilies< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > List of service IP families. Check < a href = "https://kubernetes.io/docs/concepts/services-networking/dual-stack/#services" target = "_blank" > here< / a > for details.< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > service.ipFamilyPolicy< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Service IP family policy. Check < a href = "https://kubernetes.io/docs/concepts/services-networking/dual-stack/#services" target = "_blank" > here< / a > for details.< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > service.loadBalancerIP< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-11-05 19:05:24 +01:00
< td > < p > Service load balacner IP< / p >
2024-09-23 07:17:34 +02:00
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > service.loadBalancerSourceRanges< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Load balancer source range< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > service.servicePort< / td >
< td > int< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > 8431
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Service port< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > service.type< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ClusterIP
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Service type< / p >
< / td >
2024-09-20 16:11:23 +02:00
< / tr >
< tr >
< td > serviceAccount.annotations< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Annotations to add to the service account< / p >
< / td >
< / tr >
< tr >
< td > serviceAccount.create< / td >
< td > bool< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > true
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Specifies whether a service account should be created< / p >
< / td >
< / tr >
< tr >
< td > serviceAccount.name< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > null
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > The name of the service account to use. If not set and create is true, a name is generated using the fullname template< / p >
< / td >
< / tr >
< tr >
< td > serviceMonitor.annotations< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Service Monitor annotations< / p >
< / td >
< / tr >
< tr >
< td > serviceMonitor.basicAuth< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Basic auth params for Service Monitor< / p >
< / td >
< / tr >
< tr >
< td > serviceMonitor.enabled< / td >
< td > bool< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > false
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Enable deployment of Service Monitor for server component. This is Prometheus operator object< / p >
< / td >
< / tr >
< tr >
< td > serviceMonitor.extraLabels< / td >
< td > object< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > {}
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Service Monitor labels< / p >
< / td >
< / tr >
< tr >
< td > serviceMonitor.metricRelabelings< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Service Monitor metricRelabelings< / p >
< / td >
< / tr >
< tr >
< td > serviceMonitor.relabelings< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Service Monitor relabelings< / p >
< / td >
< / tr >
< tr >
< td > tolerations< / td >
< td > list< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "plaintext" >
< code class = "language-yaml" > []
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
2024-09-23 07:17:34 +02:00
< td > < p > Tolerations configurations. Check < a href = "https://kubernetes.io/docs/concepts/configuration/assign-pod-node/" target = "_blank" > here< / a > for details< / p >
2024-09-20 16:11:23 +02:00
< / td >
< / tr >
< tr >
< td > write.url< / td >
< td > string< / td >
2024-09-23 07:17:34 +02:00
< td > < pre class = "helm-vars-default-value" language-yaml " lang = "" >
< code class = "language-yaml" > ""
< / code >
2024-09-20 16:11:23 +02:00
< / pre >
< / td >
< td > < p > Write endpoint without suffixes, victoriametrics or vminsert. Example < a href = "http://victoroametrics:8428" target = "_blank" > http://victoroametrics:8428< / a > or < a href = "http://vminsert:8480" target = "_blank" > http://vminsert:8480< / a > < / p >
< / td >
< / tr >
< / tbody >
< / table >