Database governance built for humans and agents — controlling changes and access across every major database.
Go cicddata-governancedata-maskingdata-securitydatabase-accessdatabase-governancedevopsdevsecopsflywaygitopsliquibasemongodbmysqloraclepostgresqlschema-migrationssecuritysql-clientsqlservertidb
feat(helm): support image digest pinning (#20921)
boojack2fc5fe5aa36d
diff --git a/docs/bytebase-1.1.4.tgz b/docs/bytebase-1.1.4.tgznew file mode 100644index 0000000000..14924a8201Binary files /dev/null and b/docs/bytebase-1.1.4.tgz differdiff --git a/docs/index.yaml b/docs/index.yamlindex fe4b1764da..e225484aed 100644--- a/docs/index.yaml+++ b/docs/index.yaml@@ -1,6 +1,22 @@apiVersion: v1entries: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:+ - email: [email protected]+ name: Bytebase+ name: bytebase+ sources:+ - https://github.com/bytebase/bytebase+ type: application+ urls:+ - bytebase-1.1.4.tgz+ version: 1.1.4- apiVersion: v2created: "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.tgzversion: 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.yamlindex ddb343e6f5..6ec09cbddf 100644--- a/helm-charts/bytebase/Chart.yaml+++ b/helm-charts/bytebase/Chart.yaml@@ -1,6 +1,6 @@apiVersion: v2name: bytebase-version: 1.1.3+version: 1.1.4description: 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 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 noteThe 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.tplindex 1912efb7de..b15ad1664e 100644--- a/helm-charts/bytebase/templates/_helpers.tpl+++ b/helm-charts/bytebase/templates/_helpers.tpl@@ -25,6 +25,47 @@ Selector labelsapp: 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.yamlindex 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: IfNotPresentenv:- 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: Alwaysenv:{{- if $externalPgExistingPgURLSecret }}diff --git a/helm-charts/bytebase/values.yaml b/helm-charts/bytebase/values.yamlindex 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: 8080data: "/var/opt/bytebase"diff --git a/scripts/azure-marketplace/values-azure.yaml b/scripts/azure-marketplace/values-azure.yamlindex 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.1image: bytebase/bytebaseregistry: bytebase.azurecr.io+ digest: ""# Standard Bytebase configurationbytebase: