Go modules · #2233

github.com/VictoriaMetrics/operator

v0.74.1VictoriaMetrics/operator ↗

Last release 6 days ago
21 Aug 2026
Ships on a steady schedule
a new release about every 9 days
Most releases are documented
notes for 53 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
753 releases · first in 2020

Release timeline

753 releases since 2020

202120222023202420252026

Releases

v0.69.1-0.20260513083429-c74191c96cdb13 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260513070152-0061988d5fe313 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260513030601-f841a3cf9f1e13 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260512202848-a16cb1ab668a12 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260512123050-d9e520fd038512 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260511141003-80dd9c68117311 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260510142210-9afcf9e23bc610 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260509124703-3785d6c326b69 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260509055145-ebc5d136f0159 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260508173414-ac750f94beba8 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260507123104-22d1bcd82f887 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260501131642-76206e6a81801 May 2026pre-release
Nothing published for this version
v0.69.1-0.20260430115956-693dfd5e336b30 Apr 2026pre-release
Nothing published for this version
v0.69.1-0.20260424103613-9ccea4a6e98c24 Apr 2026pre-release
Nothing published for this version
v0.69.1-0.20260423113344-5c05ab11c20323 Apr 2026pre-release
Nothing published for this version
v0.69.1-0.20260422121820-107f97f1002322 Apr 2026pre-release
Nothing published for this version
v0.69.022 Apr 2026
Release notes
Release date: 22 Apr 2026
- Dependency: vmoperator: Updated default versions for VM apps to v1.140.0 version
- Dependency: vmoperator: Updated default versions for VM apps to v1.139.0 version Update note 1: deprecated env variables for Prometheus CRs conversion VM_ENABLEDPROMETHEUSCONVERTER_PODMONITOR, VM_ENABLEDPROMETHEUSCONVERTER_SERVICESCRAPE, VM_ENABLEDPROMETHEUSCONVERTER_PROMETHEUSRULE, VM_ENABLEDPROMETHEUSCONVERTER_PROBE, VM_ENABLEDPROMETHEUSCONVERTER_SCRAPECONFIG. Use -controller.disableReconcileFor command-line flag with comma-separated list of controller names, that should be disabled. Update note 2: removed operator_prometheus_converter_watch_events_total metric since migration of Prometheus object watchers to controllers made this counter obsolete. Update note 3: made controller.prometheusCRD.resyncPeriod command line flag noop, which was relevant to Prometheus object watchers. Update note 4: -eula flag is not set by default anymore for VMBackup and VMRestore. To avoid VMCluster/VMSingle rollouts set spec.vmstorage.vmBackup.acceptEula: true for VMCluster and spec.vmBackup.acceptEula: true" for VMSingle and replace it with spec.license during VMSingle/VMCluster upgrade. Update note 5: new flag was introduced, so VMAnomaly pods will be recreated. VMAnomaly version should be at least 1.25. Update note 6: fixed port name collision in VMSingle and VMCluster, when VMBackup is enabled. To avoid VMSingle/VMCluster pods recreation set VM_USE_OLD_BACKUP_RESTORE_PORT_NAMES environment variable to true. Update note 7: the default VMDistributed unauthorizedUserAccessSpec was removed to allow users to decide whether access should be anonymous or authorized. Please check documentation with examples for unauthorized and authorized access and update your CRs accordingly.
- Dependency: vmoperator: Updated default versions for VM apps to v1.139.0 version
- Dependency: vmoperator: Updated default versions for VL apps to v1.50.0.
- FEATURE: helm-converter: new CLI tool that helps with migration from Helm charts to their corresponding Operator Custom Resources (CRs).
- FEATURE: vmsingle: VMSingle reuses vmagent implementation to allow scraping and relabelling. See #1694
- FEATURE: vmoperator: perform statefulset pods deletion instead of eviction when maxUnavailable set to 100%, which is important for minimum downtime strategy. See #1706.
- FEATURE: vmuser: support referencing multiple targets of the same kind at targetRefs[*].crd.objects.
- FEATURE: vmoperator: prettify reconcile diff in logs, now diff objects show only changed JSON fields.
- FEATURE: VLCluster, VLSingle, VLAgent, VTCluster, VTSingle, VMCluster, VMAgent, VMAnomaly, VMAlert, VMAlertmanager, VMAuth: add spec.componentVersion as an alternative to spec.clusterVersion. This field also available in all objects deploying pods. See this #1949 issue for details.
- FEATURE: vmanomaly: add support for settings.retention configuration (ttl and check_interval) in configRawYaml and configSecret. See these docs for details.
- FEATURE: vmuser: support JWT-based auth.
- FEATURE: vmagent: support HPA in VMAgent CR and in VMAgent, which is a part of VMDistributed. See #1961.
- FEATURE: vmagent: VMAgent CRs running in statefulSet mode, including VMAgent components in VMDistributed, now support configuring rolling update strategy behavior. See #1987.
- FEATURE: vmagent: VMAgent CRs running in DaemonSet mode now support configuring rolling update strategy behavior.
- FEATURE: vmoperator: Dry-run mode. See #1832.
- FEATURE: vmanomaly: introduce VMAnomalyConfig CRD to enable dynamic configuration and hot-reload support starting from VMAnomaly version 1.25.0.
- FEATURE: vmalertmanager: introduce arbitrary fs access feature for VMAlertmanager. See #899
- FEATURE: vmalertmanagerconfig: add update_message field to SlackConfig. This allows alertmanager to edit the original Slack message in-place when alert status changes instead of sending a new one. Requires alertmanager v0.32.0+. See #2064.
- BUGFIX: vmbackupmanager: remove deprecated -eula flag from vmbackupmanager and vmrestore container args. See #1319.
- BUGFIX: vmoperator: VMPodScrape for VLAgent and VMAgent now uses the correct port; previously it used the wrong port and could cause scrape failures. See #1887.
- BUGFIX: vmdistributed: updated VMAuth config consolidating all VMSelects into a single read and all VMClusters into a single write backend
- BUGFIX: vmdistributed: fix PVC being owned by StatefulSet and top-level object simultaneously. See #1845.
- BUGFIX: vmoperator: remove unneeded finalizer from core K8s resources. See #835.
- BUGFIX: vmdistributed: remove finalizers from VMServiceScrape and VMPodScrape objects, and keep finalizers on VMAgent, VMCluster, and VMAuth when DeletionTimestamp is not empty.
- BUGFIX: vmsingle and vmagent: previously, ingest-only mode could still mount scrape configuration secrets when relabeling or stream aggregation was configured, which caused unexpected secret mounts and RBAC-related failures; now these secrets are not mounted in ingest-only mode, so deployments start with the expected minimal permissions and avoid related runtime errors. See #1828.
- BUGFIX: vmoperator: recreate STS if immutable fields changed.
- BUGFIX: vmoperator: wait for STS deletion in case of recreation without throwing an error.
- BUGFIX: vmdistributed: ignore VMAuth update/delete operations if controller is disabled.
- BUGFIX: vmalertmanager: fixed ignored tracing config, when no alertmanagerconfig CRs collected. See #1983.
- BUGFIX: vmagent: apply scrape class relabellings before job ones. See #1997.
- BUGFIX: vmanomaly and vmagent: render %SHARD_NUM% placeholder when shard count is greater than 0. See #2001.
- BUGFIX: vlcluster and vtcluster: do not ignore ExtraStorageNodes for select, when default storage is disabled. See #1910.
- BUGFIX: vmdistributed: use default stub, when no VMAuth backends are available
- BUGFIX: vmagent: use volume from spec.volumes as persistent queue volume if its name is persistent-queue-data, previously emptyDir was mounted. See #1677.
- BUGFIX: vmcluster: use volume from spec.vmstorage.volumes and spec.vmselect.volumes as data and cache volumes if its name is vmstorage-db and vmselect-cachedir respectively. See #784.
- BUGFIX: vmcluster and vmsingle: renamed vmbackup and vmrestore port names, before they had identical to storage/single port names, which is not allowed.
- BUGFIX: vmsingle: updated scraping implementation to match vmagent functionality.
Open source →
v0.69.0-rc1.0.20260422095119-d1d92fe11b8522 Apr 2026pre-release
Nothing published for this version
v0.69.0-rc1.0.20260418065442-c926f9dd492c18 Apr 2026pre-release
Nothing published for this version
v0.69.0-rc1.0.20260410074107-54c32428523410 Apr 2026pre-release
Nothing published for this version
v0.69.0-rc1.0.20260408171827-8c23758a79e18 Apr 2026pre-release
Nothing published for this version
v0.69.0-rc1.0.20260408104241-b81addaa8f088 Apr 2026pre-release
Nothing published for this version
v0.69.0-rc1.0.20260318120711-68b377017e7018 Mar 2026pre-release
Nothing published for this version
v0.69.0-rc1.0.20260316091643-48fc9e4799f316 Mar 2026pre-release
Nothing published for this version
v0.69.0-rc1.0.20260313073249-ec2119ca833d13 Mar 2026pre-release
Nothing published for this version
v0.69.0-rc1.0.20260304184209-8aa3ae4eeb9c4 Mar 2026pre-release
Nothing published for this version
v0.69.0-rc13 Mar 2026pre-release
Nothing published for this version
v0.69.0-rc0.0.20260227170450-75aeb14d9e5b27 Feb 2026pre-release
Nothing published for this version
v0.69.0-rc027 Feb 2026pre-release
Nothing published for this version
v0.68.727 Jul 2026
Release notes
Dependency: vmoperator: Updated default versions for VM apps to v1.147.0 version

Dependency: vmoperator: Updated default versions for VT apps to v0.9.4 version.

Dependency: vmoperator: Updated default versions for VMAnomaly to v1.28.7 version

SECURITY: vmagent, vmsingle: remove cluster-wide secrets and configmaps permissions from the operator-managed ClusterRole. Secret access for the config-reloader is now granted via a namespace-scoped Role limited to the single operator-managed config secret. For vmsingle in ingest-only mode (the default), no secret or configmap permissions are granted at all.

BUGFIX: vmanomaly: add missing scatter_infer_jobs field to the periodic scheduler config struct. See #2328.

BUGFIX: vmanomaly: preserve insertion order of keys in ProphetModel seasonalities, tz_seasonalities, compression, and args fields; previously the operator re-emitted them with keys sorted alphabetically, which broke round-trips for configs that specified keys in a non-alphabetical order. Also renamed the singular seasonality/tz_seasonality YAML keys (deprecated) to the plural seasonalities/tz_seasonalities to match the vmanomaly configuration format. See #2356.

BUGFIX: vmagent, vmsingle: create a Role and RoleBinding in each namespace listed in WATCH_NAMESPACES so that vmagent/vmsingle can perform service discovery in all watched namespaces, not only its own. Previously, in namespaced mode, vmagent/vmsingle could only scrape targets from its own namespace due to missing RBAC in other watched namespaces.

BUGFIX: vmagent: fix missing credential secret and config-reloader setup in ingestOnlyMode when remote write entries carry authentication secrets (basicAuth.password, bearerTokenSecret, or oauth2.clientSecret). Previously the operator-managed secret containing the credential files was never created in ingest-only mode, causing vmagent to start with dangling file references. The secret is now reconciled and the config-reloader is configured to watch it for credential rotation.
Open source →
v0.68.625 Jun 2026
Nothing published for this version
v0.68.527 May 2026
Nothing published for this version
v0.68.49 Apr 2026
Nothing published for this version
v0.68.316 Mar 2026
Nothing published for this version
v0.68.3-rc013 Mar 2026pre-release
Nothing published for this version
v0.68.24 Mar 2026
Nothing published for this version
v0.68.2-0.20260226204430-c7be5afee83b26 Feb 2026pre-release
Nothing published for this version
v0.68.2-0.20260223135328-bef14e2ee88323 Feb 2026pre-release
Nothing published for this version
v0.68.2-0.20260223125514-340253a9d29b23 Feb 2026pre-release
Nothing published for this version
v0.68.123 Feb 2026
Release notes
Release date: 23 Feb 2026
- SECURITY: upgrade Go builder from Go1.25.5 to Go1.25.7. See the list of issues addressed in Go1.25.7.
- BUGFIX: vmanomaly: fix configuration marshalling for Prophet model. Previously, using Prophet model would lead to panic during configuration marshalling.
Open source →
v0.68.023 Feb 2026
Release notes
Release date: 23 Feb 2026

Update note 1: deprecated VMProbe's spec.targets.ingress. Use spec.targets.kubernetes slice instead. Please check example of VMProbe with Ingress discovery. This field will be removed in v0.71.0.

Update note 2: deprecated VMProbe's spec.targets.staticConfig. Use spec.targets.static instead. Please check example of VMProbe with static targets. This field will be removed in v0.71.0.
- Dependency: vmoperator: Updated default versions for VM apps to v1.136.0 version
- Dependency: vmoperator: Updated default versions for VL apps to v1.45.0.
- FEATURE: vmalertmanager: added namespace to --cluster.peer arguments explicitly when spec.clusterDomainName is omitted and added unit tests to test this.
- FEATURE: vmoperator: introduce VMDistributed CR, which helps to propagate changes to each zone without affecting global availability. Before distributed setup deployment was multistep manual action. See #1515.
- FEATURE: vlagent: support ability to override default stream fields for vlagent in logs collection mode.
- FEATURE: vmoperator: added VM_*_EPHEMERAL_STORAGE_REQUEST and VM_*_EPHEMERAL_STORAGE_LIMIT global variables that allow to configure ephemeralStorage requests and limits. See #1711.
- FEATURE: vmalertmanager: added tracing support. See #1770.
- FEATURE: vmprobe: added spec.targets.kubernetes property, that allows to configure probe for ingress, pod and service roles. See #1078 and #1716.
- FEATURE: vmscrapeconfig: added nomad_sd_config support. See #1809.
- FEATURE: vmoperator: support VPA for vmcluster, vtcluster, vlcluster and vmauth. See #1795. Thanks to the @dctrwatson for the pull request #1803.
- FEATURE: vmscrapeconfig: added kuma_sd_config, hetzner_sd_config, eureka_sd_confiig, puppetdb_sd_config and vultr_sd_config support.
- BUGFIX: vmagent: previously the operator requested nodes/proxy RBAC permissions even though vmagent did not use them; now this permission is no longer required, reducing the default privilege footprint for users running vmagent. See #1753.
- BUGFIX: vmalert: throw error if no notifiers found. See #1757.
- BUGFIX: vlagent: previously the operator emitted quoted spec.k8sCollector.{msgField,timeField,ignoreFields,decolorizeFields} values, which caused vlagent to misparse these fields; now these fields are emitted unquoted so collector settings are applied correctly. See #1749.
- BUGFIX: vmoperator: fixed conflicts for VMAlert, VMAlertmanager and VMAuth reconcilers, which are updating same objects concurrently with reconcilers for their child objects.
- BUGFIX: vmoperator: previously PVC downscaling always emitted a warning, which is not expected, while using PVC autoresizer; now warning during attempt to downsize PVC is only emitted if operator.victoriametrics.com/pvc-allow-volume-expansion: false is not set. See #1747.
- BUGFIX: vmoperator: skip self scrape objects management if respective controller is disabled. See #1718.
- BUGFIX: vmagent: support both prometheus-compatible endpointslice and old endpointslices roles.
- BUGFIX: vmanomaly: fix pod metrics port in the default VMPodScrape.
- BUGFIX: vmoperator: support Prometheus operator AlertmanagerConfig spec.muteTimeIntervals conversion to VMAlertmanagerConfig spec.timeIntervals. See #1783.
- BUGFIX: vmoperator: previously StatefulSet/Deployment/DaemonSet rollouts could proceed in parallel, now pods are rolled out sequentially. See #1693.
- BUGFIX: config-reloader: previously --only-init-config still kept the reloader running background watchers; now it exits after the initial config update so the pod terminates as expected. See #1785.
- BUGFIX: vmoperator: previously, recreating a resource after deletion could hang and block updates; now resource recreation completes normally. See #1707.
- BUGFIX: vmoperator: use global image registry unless image.repository is defined. See #1813.
- BUGFIX: vmalertmanagerconfig: previously spec.route and spec.receivers were required; now both parameters are optional to align with prometheus operator. VMAlertmanager now can be used to set just the global inhibition rules. See #1800.
- BUGFIX: vmagent: fixed RBAC, when ingestOnlyMode is enabled and relabel of stream aggregation configurations defined. See #1828.
Open source →
v0.68.0-rc1.0.20260216165401-a429b35d021516 Feb 2026pre-release
Nothing published for this version
v0.68.0-rc116 Feb 2026pre-release
Nothing published for this version
v0.68.0-rc0.0.20260206103814-476fe44a67496 Feb 2026pre-release
Nothing published for this version
v0.68.0-rc0.0.20260205213258-5211a22034515 Feb 2026pre-release
Nothing published for this version
v0.68.0-rc05 Feb 2026pre-release
Nothing published for this version
v0.67.1-0.20260203054717-e07f4c2b6d3e3 Feb 2026pre-release
Nothing published for this version
v0.67.023 Jan 2026
Release notes
Release date: 23 Jan 2026

Update note 1: removed 3rd-party config reloaders. Now VMAlert, VMAgent, VMAuth and VMAlertmanager are using only VM config reloader. Please verify spec.configReloaderExtraArgs in all instances of VMAlert, VMAuth, VMAgent and VMAlertmanager CRs are using valid config-reloader arguments before upgrading.

Update note 2: removed deprecated VMAgent spec.aPIServerConfig property

Update note 3: removed deprecated VMCluster spec.vmselect.persistentVolume property

Update note 4: VM_CUSTOMCONFIGRELOADERIMAGE is deprecated and will be removed in next releases. Use VM_CONFIG_RELOADER_IMAGE instead.

Update note 5: VMAgent's, VMAuth's, VMAlert's and VMAlertmanager's spec.configReloaderImageTag is deprecated and will be removed in next releases. Use spec.configReloaderImage instead.

Update note 6: VMAgent's spec.vmAgentExternalLabelName is deprecated and will be removed in next releases. Use spec.externalLabelName instead.

Update note 7: VMAuth's spec.unauthorizedUserAccessSpec.url_prefix and spec.unauthorizedUserAccessSpec.url_map are deprecated and will be removed in next releases. Use spec.unauthorizedUserAccessSpec.targetRef instead.

Update note 8: VMServiceScrape's endpointslices role is deprecated and will be removed in 0.70.0. Use endpointslice instead.
- Dependency: vmoperator: Updated default versions for VM apps to v1.134.0 version
- Dependency: vmoperator: Updated default versions for VL apps to v1.43.1.
- Dependency: vmoperator: Updated default versions for VT apps to v0.7.0 version.
- Dependency: vmoperator: Updated default versions for VMAnomaly to v1.28.5 version
- FEATURE: vmagent: support namespace parameter in attach_metadata section for all scrape configurations. See #1654.
- FEATURE: vlagent: support logs collection. See #1501.
- FEATURE: vmoperator: use operator_bad_objects_total metric with object_namespace and crd labels to track invalid objects managed by VMAgent, VMAuth, VMAlert and VMAlertmanager. Old operator_alertmanager_bad_objects_count and operator_vmalert_bad_objects_count are deprecated and will be removed in next releases.
- FEATURE: vmoperator: added HPA support for all cluster CR storage. See #1678.
- FEATURE: vlagent, vlsingle and vlcluster: support license options. See #2649.
- FEATURE: vmanomaly: add support of spec.server configuration.
- FEATURE: vlagent: add collector extraFilter, includePodLabels, includePodAnnotations, includeNodeLabels and includeNodeAnnotations support for more flexible Kubernetes logs by metadata selection.
- FEATURE: vlagent: use a single volume for all VLAgent data by default instead of separate volumes/paths for checkpoints and remote write data.
- FEATURE: vmagent: global sample limit per scrape target is supported via sampleLimit option in scrape config. See #10168.
- BUGFIX: vmoperator: fixed HPA cleanup logic for all cluster resources, before it was constantly recreated. Bug introduced in this commit.
- BUGFIX: VMCluster, VLCluster and VTCluster: prevent cluster load balancer secret from infinite reconcile.
- BUGFIX: vmsingle, vlsingle and vtsingle: do not mount emptydir if storage data volume is already present in volumes list. Before it was impossible to mount external PVC without overriding default storageDataPath using spec.extraArgs and without having unneeded emptydir listed among pod volumes. Related issues #1477.
- BUGFIX: vmoperator: use Service labels instead of selector in VMServiceScrape selector. See #1709.
- BUGFIX: vmoperator: update Alertmanager dependency to fix config validation for Incident.io. See #1730.
- BUGFIX: vmoperator: do not add -enterprise suffix to image, if tag contains @ symbol. See #1723.
- BUGFIX: vmoperator: use 127.0.0.1 instead of localhost in reload and snapshot url for setups without IPV6 enabled.
- BUGFIX: vmscrapeconfig: properly convert prometheus ScrapeConfig's role into VMScrapeConfig. See #1735.
- BUGFIX: vmagent: make vmagent container default. See #1740.
- BUGFIX: vmoperator: use 127.0.0.1 instead of localhost in reload url for setups without IPV6 enabled.
- BUGFIX: VLAgent: update strict security mode configuration to work correctly with K8sCollector.
- BUGFIX: VMUser: throw error if username and bearerToken are both set. See #1745.
Open source →
v0.66.2-0.20260521145151-4630b8edec6721 May 2026pre-release
Nothing published for this version
v0.66.2-0.20260521131522-4610acf436ed21 May 2026pre-release
Nothing published for this version
v0.66.2-0.20260520080545-56d283f3426c20 May 2026pre-release
Nothing published for this version
v0.66.2-0.20260520073842-1694db0f621b20 May 2026pre-release
Nothing published for this version
v0.66.2-0.20260520064734-c08e8e64c35c20 May 2026pre-release
Nothing published for this version
v0.66.2-0.20260519173052-68fd7bce41a219 May 2026pre-release
Nothing published for this version
v0.66.2-0.20260519133121-e00b0767259019 May 2026pre-release
Nothing published for this version
v0.66.2-0.20260519125149-f8847e2140da19 May 2026pre-release
Nothing published for this version
v0.66.2-0.20260519122219-88e8d1fe515b19 May 2026pre-release
Nothing published for this version
v0.66.2-0.20260519085325-c414d7a0adce19 May 2026pre-release
Nothing published for this version
v0.66.2-0.20260519051648-13a44aa6cd6719 May 2026pre-release
Nothing published for this version
v0.66.2-0.20260518133710-d8e87afd0f1518 May 2026pre-release
Nothing published for this version