Skip to content

Database governance built for humans and agents — controlling changes and access across every major database.

fix(helm): consolidate image digest configuration (#21049)

boojack63c46febc4bf
diff --git a/docs/bytebase-1.1.5.tgz b/docs/bytebase-1.1.5.tgz
new file mode 100644
index 0000000000..05c7395edb
Binary files /dev/null and b/docs/bytebase-1.1.5.tgz differ
diff --git a/docs/index.yaml b/docs/index.yaml
index e225484aed..3cc3c4db29 100644
--- a/docs/index.yaml
+++ b/docs/index.yaml
@@ -1,6 +1,22 @@
apiVersion: v1
entries:
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:
+ name: Bytebase
+ name: bytebase
+ sources:
+ - https://github.com/bytebase/bytebase
+ type: application
+ urls:
+ - bytebase-1.1.5.tgz
+ version: 1.1.5
- apiVersion: v2
created: "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.tgz
version: 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.yaml
index 6ec09cbddf..7945e3f389 100644
--- a/helm-charts/bytebase/Chart.yaml
+++ b/helm-charts/bytebase/Chart.yaml
@@ -1,6 +1,6 @@
apiVersion: v2
name: bytebase
-version: 1.1.4
+version: 1.1.5
description: Safe database schema change and version control for DevOps teams.
type: application
home: https://www.bytebase.com/
diff --git a/helm-charts/bytebase/README.md b/helm-charts/bytebase/README.md
index 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.
```bash
helm -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.tpl
index 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: bytebase
Create 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.yaml
index 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: 8080
data: "/var/opt/bytebase"
diff --git a/scripts/azure-marketplace/values-azure.yaml b/scripts/azure-marketplace/values-azure.yaml
index 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.1
image: bytebase/bytebase
registry: bytebase.azurecr.io
- digest: ""
# Standard Bytebase configuration
bytebase: