Skip to content

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

feat(helm): support image digest pinning (#20921)

boojack2fc5fe5aa36d
diff --git a/docs/bytebase-1.1.4.tgz b/docs/bytebase-1.1.4.tgz
new file mode 100644
index 0000000000..14924a8201
Binary files /dev/null and b/docs/bytebase-1.1.4.tgz differ
diff --git a/docs/index.yaml b/docs/index.yaml
index fe4b1764da..e225484aed 100644
--- a/docs/index.yaml
+++ b/docs/index.yaml
@@ -1,6 +1,22 @@
apiVersion: v1
entries:
bytebase:
+ - apiVersion: v2
+ created: "2026-07-16T11:28:47.505117+08:00"
+ description: Safe database schema change and version control for DevOps teams.
+ digest: 952083ed4c42a55ec6dabd9233538f51343a190062da13ea8f1972178231a398
+ 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.4.tgz
+ version: 1.1.4
- apiVersion: v2
created: "2026-06-01T19:04:44.237896-07:00"
description: Safe database schema change and version control for DevOps teams.
@@ -49,4 +65,4 @@ entries:
urls:
- bytebase-1.1.1.tgz
version: 1.1.1
-generated: "2026-06-01T19:04:44.237515-07:00"
+generated: "2026-07-16T11:28:47.504792+08:00"
diff --git a/helm-charts/bytebase/Chart.yaml b/helm-charts/bytebase/Chart.yaml
index ddb343e6f5..6ec09cbddf 100644
--- a/helm-charts/bytebase/Chart.yaml
+++ b/helm-charts/bytebase/Chart.yaml
@@ -1,6 +1,6 @@
apiVersion: v2
name: bytebase
-version: 1.1.3
+version: 1.1.4
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 42b7e58049..caa7b792c9 100644
--- a/helm-charts/bytebase/README.md
+++ b/helm-charts/bytebase/README.md
@@ -19,6 +19,19 @@ install <RELEASE_NAME> bytebase-repo/bytebase
- Kubernetes 1.24+
- Helm 3.9.0+
+## 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.
+
+```bash
+helm -n <YOUR_NAMESPACE> \
+--set "bytebase.version"={VERSION} \
+--set-string "bytebase.digest"="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.
+
## High availability note
The bundled Helm chart currently deploys Bytebase as a single-replica StatefulSet. It does not expose a Helm value for running multiple Bytebase application replicas.
@@ -49,7 +62,7 @@ $ helm -n bytebase \
--set "bytebase.option.port"=443 \
--set "bytebase.option.externalPg.url"="postgresql://bytebase:[email protected]/bytebase" \
--set "bytebase.option.external-url"="https://bytebase.ngrok-free.app" \
---set "bytebase.version"=2.11.1 \
+--set "bytebase.version"=3.20.1 \
--set "bytebase.persistence.enabled"="true" \
--set "bytebase.persistence.storage"="10Gi" \
--set "bytebase.persistence.storageClass"="csi-disk" \
@@ -87,8 +100,10 @@ upgrade bytebase-release bytebase-repo/bytebase
| Parameter | Description | Default Value |
| :------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------: |
-| `bytebase.version` | The version of Bytebase to be installed. | "2.11.1" |
+| `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.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.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 1912efb7de..b15ad1664e 100644
--- a/helm-charts/bytebase/templates/_helpers.tpl
+++ b/helm-charts/bytebase/templates/_helpers.tpl
@@ -25,6 +25,47 @@ Selector labels
app: bytebase
{{- end }}
+{{/*
+Create the Bytebase image reference
+*/}}
+{{- define "bytebase.image" -}}
+{{- $image := printf "bytebase/bytebase:%s" .Values.bytebase.version -}}
+{{- if .Values.bytebase.registryMirrorHost -}}
+{{- $image = printf "%s/bytebase/bytebase:%s" (trimSuffix "/" .Values.bytebase.registryMirrorHost) .Values.bytebase.version -}}
+{{- end -}}
+{{- $digest := .Values.bytebase.digest -}}
+{{- with .Values.global -}}
+ {{- with .azure -}}
+ {{- with .images -}}
+ {{- with .bytebase -}}
+ {{- $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
+*/}}
+{{- define "bytebase.busyboxImage" -}}
+{{- $image := "busybox" -}}
+{{- 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 -}}
+{{- end -}}
+{{- end -}}
+
{{/*
Create the name of the general service account
*/}}
@@ -34,4 +75,4 @@ Create the name of the general service account
{{- else -}}
{{ default "default" .Values.serviceAccount.name }}
{{- end -}}
-{{- end -}}
\ No newline at end of file
+{{- end -}}
diff --git a/helm-charts/bytebase/templates/statefulset.yaml b/helm-charts/bytebase/templates/statefulset.yaml
index 17b4d6d7fe..74c59ed836 100644
--- a/helm-charts/bytebase/templates/statefulset.yaml
+++ b/helm-charts/bytebase/templates/statefulset.yaml
@@ -1,6 +1,4 @@
# bytebase
-{{- $version := .Values.bytebase.version -}}
-{{- $registryMirrorHost := .Values.bytebase.registryMirrorHost -}}
{{- $extraSecretMounts := .Values.bytebase.extraSecretMounts -}}
{{- $extraVolumes := .Values.bytebase.extraVolumes }}
# bytebase.option
@@ -60,11 +58,7 @@ spec:
# Hence, we do the escaping in the initialization container, and write the escaped password to the shared volume.
initContainers:
- name: init-container
- {{- if $registryMirrorHost }}
- image: {{ trimSuffix "/" $registryMirrorHost }}/busybox
- {{- else }}
- image: busybox
- {{- end }}
+ image: {{ include "bytebase.busyboxImage" . }}
imagePullPolicy: IfNotPresent
env:
- name: PG_PASSWORD
@@ -120,36 +114,7 @@ spec:
{{- end }}
containers:
- name: bytebase
- {{- if .Values.global }}
- {{- if .Values.global.azure }}
- {{- if .Values.global.azure.images }}
- {{- if .Values.global.azure.images.bytebase }}
- # Azure Marketplace image path - Microsoft will retag images to their registry
- image: {{ .Values.global.azure.images.bytebase.registry }}/{{ .Values.global.azure.images.bytebase.image }}:{{ .Values.global.azure.images.bytebase.tag }}
- {{- else if $registryMirrorHost }}
- # If user specifies a registry mirror host, we should use that instead of the default.
- image: {{ trimSuffix "/" $registryMirrorHost }}/bytebase/bytebase:{{ $version }}
- {{- else }}
- image: bytebase/bytebase:{{ $version }}
- {{- end }}
- {{- else if $registryMirrorHost }}
- # If user specifies a registry mirror host, we should use that instead of the default.
- image: {{ trimSuffix "/" $registryMirrorHost }}/bytebase/bytebase:{{ $version }}
- {{- else }}
- image: bytebase/bytebase:{{ $version }}
- {{- end }}
- {{- else if $registryMirrorHost }}
- # If user specifies a registry mirror host, we should use that instead of the default.
- image: {{ trimSuffix "/" $registryMirrorHost }}/bytebase/bytebase:{{ $version }}
- {{- else }}
- image: bytebase/bytebase:{{ $version }}
- {{- end }}
- {{- else if $registryMirrorHost }}
- # If user specifies a registry mirror host, we should use that instead of the default.
- image: {{ trimSuffix "/" $registryMirrorHost }}/bytebase/bytebase:{{ $version }}
- {{- else }}
- image: bytebase/bytebase:{{ $version }}
- {{- end }}
+ image: {{ include "bytebase.image" . }}
imagePullPolicy: Always
env:
{{- if $externalPgExistingPgURLSecret }}
diff --git a/helm-charts/bytebase/values.yaml b/helm-charts/bytebase/values.yaml
index c983a4a58d..6ce24c7d36 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}) at deploy
+# injects these values (global.azure.images.bytebase.{registry,image,tag,digest}) at deploy
# time, so the opt-in path still works.
# global:
# azure:
@@ -15,10 +15,15 @@
# 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: ""
option:
port: 8080
data: "/var/opt/bytebase"
diff --git a/scripts/azure-marketplace/values-azure.yaml b/scripts/azure-marketplace/values-azure.yaml
index 30f9569a58..b02788212f 100644
--- a/scripts/azure-marketplace/values-azure.yaml
+++ b/scripts/azure-marketplace/values-azure.yaml
@@ -10,6 +10,7 @@ global:
tag: 3.11.1
image: bytebase/bytebase
registry: bytebase.azurecr.io
+ digest: ""
# Standard Bytebase configuration
bytebase: