2022-11-29 18:19:46 +00:00
|
|
|
---
|
2023-10-02 12:50:08 +00:00
|
|
|
weight: 9
|
2023-01-11 15:38:18 +00:00
|
|
|
title: FAQ
|
2023-10-05 10:43:28 +00:00
|
|
|
menu:
|
|
|
|
docs:
|
|
|
|
parent: "operator"
|
|
|
|
weight: 9
|
|
|
|
identifier: "operator-faq"
|
2023-11-22 11:59:07 +00:00
|
|
|
aliases:
|
2024-08-16 14:32:25 +00:00
|
|
|
- /operator/faq/
|
|
|
|
- /operator/faq/index.html
|
2022-11-29 18:19:46 +00:00
|
|
|
---
|
2023-10-02 12:50:08 +00:00
|
|
|
## How do you monitor the operator itself?
|
|
|
|
|
2024-08-16 14:32:25 +00:00
|
|
|
You can read about vmoperator monitoring in [this document](https://docs.victoriametrics.com/operator/monitoring).
|
2022-11-29 18:19:46 +00:00
|
|
|
|
|
|
|
## How to change VMStorage PVC storage class
|
|
|
|
|
|
|
|
With Helm chart deployment:
|
|
|
|
|
|
|
|
1. Update the PVCs manually
|
2023-07-26 21:39:35 +00:00
|
|
|
1. Run `kubectl delete statefulset --cascade=orphan {vmstorage-sts}` which will delete the sts but keep the pods
|
|
|
|
1. Update helm chart with the new storage class in the volumeClaimTemplate
|
|
|
|
1. Run the helm chart to recreate the sts with the updated value
|
2022-11-29 18:19:46 +00:00
|
|
|
|
|
|
|
With Operator deployment:
|
|
|
|
|
|
|
|
1. Update the PVCs manually
|
2023-07-26 21:39:35 +00:00
|
|
|
1. Run `kubectl delete vmcluster --cascade=orphan {cluster-name}`
|
|
|
|
1. Run `kubectl delete statefulset --cascade=orphan {vmstorage-sts}`
|
|
|
|
1. Update VMCluster spec to use new storage class
|
|
|
|
1. Apply cluster configuration
|
2023-10-02 12:50:08 +00:00
|
|
|
|
|
|
|
## How to override image registry
|
|
|
|
|
|
|
|
You can use `VM_CONTAINERREGISTRY` parameter for operator:
|
|
|
|
|
2024-08-16 14:32:25 +00:00
|
|
|
- See details about tuning [operator settings here](https://docs.victoriametrics.com/operator/setup#settings).
|
|
|
|
- See [available operator settings](https://docs.victoriametrics.com/operator/vars) here.
|
2023-10-02 12:50:08 +00:00
|
|
|
|
|
|
|
## How to set up automatic backups?
|
|
|
|
|
|
|
|
You can read about backups:
|
|
|
|
|
2024-08-16 14:32:25 +00:00
|
|
|
- for `VMSingle`: [Backup automation](https://docs.victoriametrics.com/operator/resources/vmsingle#backup-automation)
|
|
|
|
- for `VMCluster`: [Backup automation](https://docs.victoriametrics.com/operator/resources/vmcluster#backup-automation)
|
2023-10-02 12:50:08 +00:00
|
|
|
|
|
|
|
## How to migrate from Prometheus-operator to VictoriaMetrics operator?
|
|
|
|
|
2024-08-16 14:32:25 +00:00
|
|
|
You can read about migration from prometheus operator on [this page](https://docs.victoriametrics.com/operator/migration).
|
2023-10-02 12:50:08 +00:00
|
|
|
|
|
|
|
## How to turn off conversion for prometheus resources
|
|
|
|
|
2024-08-16 14:32:25 +00:00
|
|
|
You can read about it on [this page](https://docs.victoriametrics.com/operator/migration#objects-convesion).
|
2023-10-02 12:50:08 +00:00
|
|
|
|
|
|
|
## My VM objects are not deleted/changed when I delete/change Prometheus objects
|
|
|
|
|
|
|
|
You can read about it in following sections of "Migration from prometheus-operator" docs:
|
|
|
|
|
2024-08-16 14:32:25 +00:00
|
|
|
- [Deletion synchronization](https://docs.victoriametrics.com/operator/migration#deletion-synchronization)
|
|
|
|
- [Update synchronization](https://docs.victoriametrics.com/operator/migration#update-synchronization)
|
|
|
|
- [Labels synchronization](https://docs.victoriametrics.com/operator/migration#labels-synchronization)
|
2023-10-02 12:50:08 +00:00
|
|
|
|
|
|
|
## What permissions does an operator need to run in a cluster?
|
|
|
|
|
2024-08-16 14:32:25 +00:00
|
|
|
You can read about needed permissions for operator in [this document](https://docs.victoriametrics.com/operator/security#roles).
|
2023-10-02 12:50:08 +00:00
|
|
|
|
|
|
|
## How to know the version of VM components in the operator?
|
|
|
|
|
2024-08-16 14:32:25 +00:00
|
|
|
See [printDefaults mode](https://docs.victoriametrics.com/operator/configuration).
|
2023-10-02 12:50:08 +00:00
|
|
|
|
|
|
|
In addition, you can use [Release notes](https://github.com/VictoriaMetrics/operator/releases)
|
2024-08-16 14:32:25 +00:00
|
|
|
or [CHANGELOG](https://docs.victoriametrics.com/operator/changelog).
|
2023-10-02 12:50:08 +00:00
|
|
|
- that's where we describe default version of VictoriaMetrics components.
|
|
|
|
|
|
|
|
## How to run VictoriaMetrics operator with permissions for one namespace only?
|
|
|
|
|
2024-08-16 14:32:25 +00:00
|
|
|
See this document for details: [Configuration -> Namespaced mode](https://docs.victoriametrics.com/operator/configuration#namespaced-mode).
|
2023-10-02 12:50:08 +00:00
|
|
|
|
2024-01-23 15:22:16 +00:00
|
|
|
## How to configure VMAgent and VMServiceScrape for using with [Istio Service Mesh](https://istio.io/) and its mTLS?
|
|
|
|
|
2024-08-16 14:32:25 +00:00
|
|
|
See this example in operator repository: https://github.com/VictoriaMetrics/operator/blob/master/config/examples/vmagent_istio.yaml
|
2024-01-23 15:22:16 +00:00
|
|
|
|
2023-10-02 12:50:08 +00:00
|
|
|
## What versions of Kubernetes is the operator compatible with?
|
|
|
|
|
|
|
|
Operator tested at kubernetes versions from 1.16 to 1.27.
|