Skip to content

armgit / Pulse

Public Imported from GitHub
0

Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.

Refresh governed Node and Alpine container digests together

pulse-triage[bot]8f3f67db926a
diff --git a/Dockerfile b/Dockerfile
index ac1288f80f..19334e4caa 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -4,7 +4,7 @@ ARG APPRISE_VERSION=1.12.0
# Build stage for frontend (must be built first for embedding)
# Force amd64 platform to avoid slow QEMU emulation during multi-arch builds
-FROM --platform=linux/amd64 node:24-alpine@sha256:ebfe2f90462722a7a4de65e91990e97fe0d401c70e0e762c5b53302f905ec1c1 AS frontend-builder
+FROM --platform=linux/amd64 node:24-alpine@sha256:06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53 AS frontend-builder
WORKDIR /app/frontend-modern
@@ -214,7 +214,7 @@ RUN --mount=type=cache,id=pulse-go-mod,target=/go/pkg/mod \
# Runtime image for the Docker agent (offered via --target agent_runtime)
-FROM alpine:3.24@sha256:294b683cb724975bec92580e1e685676bd4b50bda910ddb8c51d4cabeaec77e6 AS agent_runtime
+FROM alpine:3.24@sha256:be2656061b536c1883c4034790e21d0a09c5aaaf51968b89368a3c0371ea2c9a AS agent_runtime
# Use TARGETARCH to select the correct binary for the build platform
ARG TARGETARCH
@@ -255,7 +255,7 @@ ENTRYPOINT ["/usr/local/bin/pulse-agent"]
# Build the pinned Apprise CLI separately so release runtimes only retain the
# Python interpreter and installed notification dependencies, not pip.
-FROM alpine:3.24@sha256:294b683cb724975bec92580e1e685676bd4b50bda910ddb8c51d4cabeaec77e6 AS apprise-builder
+FROM alpine:3.24@sha256:be2656061b536c1883c4034790e21d0a09c5aaaf51968b89368a3c0371ea2c9a AS apprise-builder
ARG APPRISE_VERSION
@@ -266,7 +266,7 @@ RUN apk --no-cache add python3 py3-pip && \
# Base operating-system surface shared by source-built and candidate-assembled
# Pulse server images.
-FROM alpine:3.24@sha256:294b683cb724975bec92580e1e685676bd4b50bda910ddb8c51d4cabeaec77e6 AS pulse-runtime-foundation
+FROM alpine:3.24@sha256:be2656061b536c1883c4034790e21d0a09c5aaaf51968b89368a3c0371ea2c9a AS pulse-runtime-foundation
ARG APPRISE_VERSION
@@ -430,7 +430,7 @@ RUN chmod 755 /opt/pulse/scripts/*.sh /opt/pulse/scripts/*.ps1 && \
chown -R pulse:pulse /opt/pulse
# Unified Agent image assembled from the same immutable candidate payload.
-FROM alpine:3.24@sha256:294b683cb724975bec92580e1e685676bd4b50bda910ddb8c51d4cabeaec77e6 AS agent_runtime_prebuilt
+FROM alpine:3.24@sha256:be2656061b536c1883c4034790e21d0a09c5aaaf51968b89368a3c0371ea2c9a AS agent_runtime_prebuilt
ARG TARGETARCH
ARG TARGETVARIANT
diff --git a/deploy/provider-msp/Dockerfile.control-plane b/deploy/provider-msp/Dockerfile.control-plane
index 48afaacce0..cdaa3fe7cc 100644
--- a/deploy/provider-msp/Dockerfile.control-plane
+++ b/deploy/provider-msp/Dockerfile.control-plane
@@ -1,6 +1,6 @@
# syntax=docker/dockerfile:1.7
-FROM --platform=linux/amd64 node:24-alpine@sha256:ebfe2f90462722a7a4de65e91990e97fe0d401c70e0e762c5b53302f905ec1c1 AS frontend-builder
+FROM --platform=linux/amd64 node:24-alpine@sha256:06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53 AS frontend-builder
WORKDIR /app/frontend-modern
COPY frontend-modern/package*.json ./
RUN --mount=type=cache,id=pulse-control-plane-npm-cache,target=/root/.npm \
@@ -51,7 +51,7 @@ RUN --mount=type=cache,id=pulse-control-plane-go-mod,target=/go/pkg/mod \
-trimpath \
-o /pulse-control-plane ./cmd/pulse-control-plane
-FROM alpine:3.24@sha256:294b683cb724975bec92580e1e685676bd4b50bda910ddb8c51d4cabeaec77e6 AS control-plane-runtime-foundation
+FROM alpine:3.24@sha256:be2656061b536c1883c4034790e21d0a09c5aaaf51968b89368a3c0371ea2c9a AS control-plane-runtime-foundation
RUN apk add --no-cache ca-certificates docker-cli
ENTRYPOINT ["pulse-control-plane"]
diff --git a/docs/release-control/v6/internal/subsystems/deployment-installability.md b/docs/release-control/v6/internal/subsystems/deployment-installability.md
index 9cf3b69caf..cc083e56fe 100644
--- a/docs/release-control/v6/internal/subsystems/deployment-installability.md
+++ b/docs/release-control/v6/internal/subsystems/deployment-installability.md
@@ -7975,7 +7975,7 @@ a valid pinned SSH signature and the extracted request expression with absent
and synthetic email. It does not establish installed onboarding, server acceptance
or legal identity. See the qualification evidence below.
-### Node 24 amd64 release-builder digest parity
+### Governed Node 24 and Alpine 3.24 digest parity
The canonical Pulse release Dockerfile and provider-MSP control-plane Dockerfile
pin the same immutable amd64 Node 24 Alpine frontend-builder image. The
@@ -7984,7 +7984,16 @@ build inputs to the current dependency digest. The canonical release-build
metadata proof `TestDockerBuildUsesCanonicalReleaseLdflags` and hosted
provider-MSP control proof `TestProviderMSPControlPlaneDockerfileBuildsReleaseLicenseBinary`
also require that exact digest while retaining their release metadata and
-license-build assertions. These are source-contract checks, not an image build.
+license-build assertions. The selected Node 24 digest is
+`06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53`.
+All four Alpine source/prebuilt server, agent and Apprise foundation stages use
+`be2656061b536c1883c4034790e21d0a09c5aaaf51968b89368a3c0371ea2c9a`;
+the provider-MSP runtime and integration mock use that same Alpine 3.24 image.
+`TestDockerBuildUsesCanonicalReleaseLdflags` binds every production foundation,
+and `TestProviderMSPAlpineRuntimeMatchesIntegrationMock` rejects partial runtime
+refreshes across the hosted control plane and mock. Tag lines, compiler choices,
+release metadata, keys and exact-candidate consumption remain unchanged.
+These are source-contract checks, not an image build or registry verification.
The hosted release build must verify the landed exact source, and provider-MSP
rollout and installed acceptance must be observed separately before this refresh
is considered operationally complete.
diff --git a/scripts/installtests/build_release_assets_test.go b/scripts/installtests/build_release_assets_test.go
index d763d07a1f..bd1f0f6968 100644
--- a/scripts/installtests/build_release_assets_test.go
+++ b/scripts/installtests/build_release_assets_test.go
@@ -1788,6 +1788,11 @@ func TestDockerBuildUsesCanonicalReleaseLdflags(t *testing.T) {
assertDigestPinnedDockerStage(t, dockerfile, `FROM --platform=linux/amd64 golang:1.26.10-alpine@sha256:`, ` AS backend-builder`)
assertDigestPinnedDockerStage(t, dockerfile, `FROM alpine:3.24@sha256:`, ` AS agent_runtime`)
assertDigestPinnedDockerStage(t, dockerfile, `FROM alpine:3.24@sha256:`, ` AS pulse-runtime-foundation`)
+ // Source-built and prebuilt servers/agents must consume the same selected
+ // runtime image; checking only digest syntax would permit a partial refresh.
+ for _, stage := range []string{"agent_runtime", "apprise-builder", "pulse-runtime-foundation", "agent_runtime_prebuilt"} {
+ assertContainsAll(t, dockerfile, "FROM alpine:3.24@sha256:"+alpine324RuntimeDigest+" AS "+stage+"\n")
+ }
hostedStart := strings.Index(dockerfile, `FROM pulse-runtime-base AS hosted_runtime`)
runtimeStart := strings.Index(dockerfile, `FROM pulse-runtime-base AS runtime`)
if hostedStart == -1 || runtimeStart == -1 || hostedStart > runtimeStart {
diff --git a/scripts/installtests/dependency_update_test.go b/scripts/installtests/dependency_update_test.go
index 453cc8d82a..9fbe614a18 100644
--- a/scripts/installtests/dependency_update_test.go
+++ b/scripts/installtests/dependency_update_test.go
@@ -32,7 +32,9 @@ func assertDigestPinnedDockerStage(t *testing.T, dockerfile, prefix, suffix stri
}
}
-const node24Amd64FrontendDigest = "ebfe2f90462722a7a4de65e91990e97fe0d401c70e0e762c5b53302f905ec1c1"
+const alpine324RuntimeDigest = "be2656061b536c1883c4034790e21d0a09c5aaaf51968b89368a3c0371ea2c9a"
+
+const node24Amd64FrontendDigest = "06d7adf3e0ef61a13f1d28682726366f97a15aa1888c934d3ecec86c33918b53"
func TestNode24FrontendBuilderDigestIsAligned(t *testing.T) {
pattern := regexp.MustCompile(`(?m)^FROM --platform=linux/amd64 node:24-alpine@sha256:([0-9a-f]{64}) AS frontend-builder$`)
diff --git a/scripts/installtests/provider_msp_deploy_test.go b/scripts/installtests/provider_msp_deploy_test.go
index 0eecdc6fe1..e83c1f6f31 100644
--- a/scripts/installtests/provider_msp_deploy_test.go
+++ b/scripts/installtests/provider_msp_deploy_test.go
@@ -32,6 +32,24 @@ func TestProviderMSPGoBuilderMatchesIntegrationMock(t *testing.T) {
}
}
+func TestProviderMSPAlpineRuntimeMatchesIntegrationMock(t *testing.T) {
+ // The hosted control plane and its mock must not silently retain an older
+ // runtime base when the server and agent runtime images are refreshed.
+ for _, fixture := range []struct {
+ path []string
+ stage string
+ }{
+ {[]string{"deploy", "provider-msp", "Dockerfile.control-plane"}, " AS control-plane-runtime-foundation"},
+ {[]string{"tests", "integration", "mock-github-server", "Dockerfile"}, ""},
+ } {
+ contents, err := os.ReadFile(repoFile(fixture.path...))
+ if err != nil {
+ t.Fatal(err)
+ }
+ assertContainsAll(t, string(contents), "FROM alpine:3.24@sha256:"+alpine324RuntimeDigest+fixture.stage+"\n")
+ }
+}
+
func TestProviderMSPControlPlaneImageConsumesExactCandidate(t *testing.T) {
dockerfileBytes, err := os.ReadFile(repoFile("deploy", "provider-msp", "Dockerfile.control-plane"))
if err != nil {
diff --git a/tests/integration/mock-github-server/Dockerfile b/tests/integration/mock-github-server/Dockerfile
index 6e64773861..b505d675d7 100644
--- a/tests/integration/mock-github-server/Dockerfile
+++ b/tests/integration/mock-github-server/Dockerfile
@@ -7,7 +7,7 @@ RUN go mod download
COPY main.go ./
RUN CGO_ENABLED=0 GOOS=linux go build -o mock-github-server .
-FROM alpine:3.24@sha256:294b683cb724975bec92580e1e685676bd4b50bda910ddb8c51d4cabeaec77e6
+FROM alpine:3.24@sha256:be2656061b536c1883c4034790e21d0a09c5aaaf51968b89368a3c0371ea2c9a
RUN apk --no-cache add ca-certificates
WORKDIR /app