Database governance built for humans and agents — controlling changes and access across every major database.
Go cicddata-governancedata-maskingdata-securitydatabase-accessdatabase-governancedevopsdevsecopsflywaygitopsliquibasemongodbmysqloraclepostgresqlschema-migrationssecuritysql-clientsqlservertidb
fix(helm): consolidate image digest configuration (#21049)
boojack63c46febc4bf
diff --git a/docs/bytebase-1.1.5.tgz b/docs/bytebase-1.1.5.tgznew file mode 100644index 0000000000..05c7395edbBinary files /dev/null and b/docs/bytebase-1.1.5.tgz differdiff --git a/docs/index.yaml b/docs/index.yamlindex e225484aed..3cc3c4db29 100644--- a/docs/index.yaml+++ b/docs/index.yaml@@ -1,6 +1,22 @@apiVersion: v1entries:bytebase:+ - apiVersion: v2+ created: "2026-07-28T10:44:46.236015+08:00"+ description: Safe database schema change and version control for DevOps teams.+ digest: d6ee886f6ed4a5625912187b67bd7147fb62869bccc5d1800d0e234df1e5d7a1+ home: https://www.bytebase.com/+ icon: https://raw.githubusercontent.com/bytebase/bytebase.com/main/public/images/logo.svg+ maintainers:+ - email: [email protected]+ name: Bytebase+ name: bytebase+ sources:+ - https://github.com/bytebase/bytebase+ type: application+ urls:+ - bytebase-1.1.5.tgz+ version: 1.1.5- apiVersion: v2created: "2026-07-16T11:28:47.505117+08:00"description: Safe database schema change and version control for DevOps teams.@@ -65,4 +81,4 @@ entries:urls:- bytebase-1.1.1.tgzversion: 1.1.1-generated: "2026-07-16T11:28:47.504792+08:00"+generated: "2026-07-28T10:44:46.23498+08:00"diff --git a/helm-charts/bytebase/Chart.yaml b/helm-charts/bytebase/Chart.yamlindex 6ec09cbddf..7945e3f389 100644--- a/helm-charts/bytebase/Chart.yaml+++ b/helm-charts/bytebase/Chart.yaml@@ -1,6 +1,6 @@apiVersion: v2name: bytebase-version: 1.1.4+version: 1.1.5description: Safe database schema change and version control for DevOps teams.type: applicationhome: https://www.bytebase.com/diff --git a/helm-charts/bytebase/README.md b/helm-charts/bytebase/README.mdindex caa7b792c9..b8b07ee8e4 100644--- a/helm-charts/bytebase/README.md+++ b/helm-charts/bytebase/README.md@@ -21,16 +21,17 @@ install <RELEASE_NAME> bytebase-repo/bytebase## Pinning container images by digest-Set `bytebase.digest` to a complete OCI digest, including the algorithm prefix. The chart keeps the configured version tag for readability, but Kubernetes uses the digest to select the image.+Set `bytebase.version` to a combined `tag@digest` reference. Kubernetes pulls by digest and treats the tag as documentation.```bashhelm -n <YOUR_NAMESPACE> \---set "bytebase.version"={VERSION} \---set-string "bytebase.digest"="sha256:{DIGEST}" \+--set-string "bytebase.version"="{VERSION}@sha256:{DIGEST}" \install <RELEASE_NAME> bytebase-repo/bytebase```-Set `bytebase.busyboxDigest` to pin the BusyBox init container used when `bytebase.option.externalPg.escapePassword` is enabled. Azure Marketplace deployments can set `global.azure.images.bytebase.digest` for the image copied to the Azure registry.+The BusyBox init container used when `bytebase.option.externalPg.escapePassword` is enabled defaults to a fixed tag via `bytebase.busyboxVersion`, which also accepts a combined `tag@digest` reference. Azure Marketplace deployments can use the same combined reference in `global.azure.images.bytebase.tag`.++When upgrading from chart 1.1.4, move any digest configured through `bytebase.digest`, `bytebase.busyboxDigest`, or `global.azure.images.bytebase.digest` into the corresponding version or tag value. The chart rejects these removed settings to prevent an upgrade from silently losing digest pinning.## High availability note@@ -100,10 +101,9 @@ upgrade bytebase-release bytebase-repo/bytebase| Parameter | Description | Default Value || :------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------: |-| `bytebase.version` | The version of Bytebase to be installed. | "latest" |-| `bytebase.digest` | OCI digest used to pin the Bytebase image. Include the algorithm prefix, for example `sha256:abc123`. The digest takes precedence over the version tag. | "" |+| `bytebase.version` | The version of Bytebase to be installed. May embed a digest as a combined reference, for example `3.21.0@sha256:abc123`. | "latest" || `bytebase.registryMirrorHost` | The host for the Docker registry mirror. Leave empty for default registry usage. | "" |-| `bytebase.busyboxDigest` | OCI digest used to pin the BusyBox init container when PostgreSQL password escaping is enabled. | "" |+| `bytebase.busyboxVersion` | Tag of the BusyBox init container used when PostgreSQL password escaping is enabled. May embed a digest, for example `1.37.0@sha256:abc123`. | "1.37.0" || `bytebase.option.port` | Port where Bytebase server runs. | 8080 || `bytebase.option.data` | Data directory of Bytebase data stored. | /var/opt/bytebase || `bytebase.option.external-url` | The address for users to visit Bytebase, visit [our docs](https://docs.bytebase.com/get-started/self-host/external-url/) to get more details. | "<https://docs.bytebase.com/get-started/self-host/external-url>" |diff --git a/helm-charts/bytebase/templates/_helpers.tpl b/helm-charts/bytebase/templates/_helpers.tplindex b15ad1664e..7c4be42f7c 100644--- a/helm-charts/bytebase/templates/_helpers.tpl+++ b/helm-charts/bytebase/templates/_helpers.tpl@@ -14,7 +14,7 @@ Common labels*/}}{{- define "bytebase.labels" -}}{{ include "bytebase.selectorLabels" . }}-app.kubernetes.io/version: {{ .Values.bytebase.version}}+app.kubernetes.io/version: {{ .Values.bytebase.version | default "" | toString | splitList "@" | first | trunc 63 | quote }}app.kubernetes.io/managed-by: {{ .Release.Service }}{{- end }}@@ -29,27 +29,31 @@ app: bytebaseCreate the Bytebase image reference*/}}{{- define "bytebase.image" -}}-{{- $image := printf "bytebase/bytebase:%s" .Values.bytebase.version -}}+{{- with .Values.bytebase.digest -}}+{{- fail "bytebase.digest is no longer supported; append the digest to bytebase.version" -}}+{{- end -}}+{{- with .Values.bytebase.busyboxDigest -}}+{{- fail "bytebase.busyboxDigest is no longer supported; append the digest to bytebase.busyboxVersion" -}}+{{- end -}}+{{- $version := .Values.bytebase.version | default "" | toString -}}+{{- $image := printf "bytebase/bytebase:%s" $version -}}{{- if .Values.bytebase.registryMirrorHost -}}-{{- $image = printf "%s/bytebase/bytebase:%s" (trimSuffix "/" .Values.bytebase.registryMirrorHost) .Values.bytebase.version -}}+{{- $image = printf "%s/bytebase/bytebase:%s" (trimSuffix "/" .Values.bytebase.registryMirrorHost) $version -}}{{- end -}}-{{- $digest := .Values.bytebase.digest -}}{{- with .Values.global -}}{{- with .azure -}}{{- with .images -}}{{- with .bytebase -}}+ {{- with .digest -}}+ {{- fail "global.azure.images.bytebase.digest is no longer supported; append the digest to global.azure.images.bytebase.tag" -}}+ {{- end -}}{{- $image = printf "%s/%s:%s" .registry .image .tag -}}- {{- $digest = .digest | default "" -}}{{- end -}}{{- end -}}{{- end -}}{{- end -}}-{{- if $digest -}}-{{- printf "%s@%s" $image $digest -}}-{{- else -}}{{- $image -}}{{- end -}}-{{- end -}}{{/*Create the BusyBox image reference@@ -59,11 +63,10 @@ Create the BusyBox image reference{{- if .Values.bytebase.registryMirrorHost -}}{{- $image = printf "%s/busybox" (trimSuffix "/" .Values.bytebase.registryMirrorHost) -}}{{- end -}}-{{- if .Values.bytebase.busyboxDigest -}}-{{- printf "%s@%s" $image .Values.bytebase.busyboxDigest -}}-{{- else -}}-{{- $image -}}+{{- with .Values.bytebase.busyboxVersion | default "" | toString -}}+{{- $image = printf "%s:%s" $image . -}}{{- end -}}+{{- $image -}}{{- end -}}{{/*diff --git a/helm-charts/bytebase/values.yaml b/helm-charts/bytebase/values.yamlindex 6ce24c7d36..a1d7902054 100644--- a/helm-charts/bytebase/values.yaml+++ b/helm-charts/bytebase/values.yaml@@ -6,7 +6,7 @@# Intentionally NOT set by default: when this block is present, the statefulset# uses it for the container image and ignores bytebase.version, which would force# every non-Azure install to docker.io/bytebase/bytebase:latest. Azure Marketplace-# injects these values (global.azure.images.bytebase.{registry,image,tag,digest}) at deploy+# injects these values (global.azure.images.bytebase.{registry,image,tag}) at deploy# time, so the opt-in path still works.# global:# azure:@@ -15,15 +15,13 @@# tag: latest# image: bytebase/bytebase# registry: docker.io-# digest: ""bytebase:version: latest- # OCI image digest including the algorithm prefix, for example sha256:abc123.- digest: ""registryMirrorHost: ""- # OCI digest for the BusyBox init container used to escape PostgreSQL passwords.- busyboxDigest: ""+ # Tag for the BusyBox init container used to escape PostgreSQL passwords.+ # May also embed a digest, for example 1.37.0@sha256:abc123.+ busyboxVersion: "1.37.0"option:port: 8080data: "/var/opt/bytebase"diff --git a/scripts/azure-marketplace/values-azure.yaml b/scripts/azure-marketplace/values-azure.yamlindex b02788212f..30f9569a58 100644--- a/scripts/azure-marketplace/values-azure.yaml+++ b/scripts/azure-marketplace/values-azure.yaml@@ -10,7 +10,6 @@ global:tag: 3.11.1image: bytebase/bytebaseregistry: bytebase.azurecr.io- digest: ""# Standard Bytebase configurationbytebase: