tking/guildhouse-spire-plugins
SHA256
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

packaging: production Dockerfile for spire-plugins image

Browse source 
Two-stage build. Builder stage: golang:1.23.6-bookworm (pinned to
match the go directive in go.mod exactly), CGO_ENABLED=0, -trimpath
and -s -w linker flags for reproducible, size-minimized static
binaries. Compiles all four plugin binaries into /plugins/.

Runtime stage: debian:bookworm-slim with the /plugins/ directory
copied in and made world-readable. The image is inert — SPIRE server
and agent Deployments consume it via an initContainer that runs
`cp -r /plugins/ /opt/spire/plugins/` into a shared emptyDir volume,
so no ENTRYPOINT is needed.

Path: git.guildhouse.dev/tking/spire-plugins:v0.1.0.

Not replacing Containerfile.dev, which remains the local-dev variant.

Signed-off-by: Tyler J King <tking@guildhouse.dev>
This commit is contained in:
Tyler J King 2026-04-22 12:06:55 -04:00
parent 83b1264ebc
commit f3e1d161d0
1 changed files with 47 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

47
Dockerfile Normal file
View file

@ -0,0 +1,47 @@
# Guildhouse SPIRE Plugins — production image.
#
# This image is a passive binary container: it is not executed directly.
# SPIRE server/agent Deployments mount an emptyDir volume and run an
# initContainer from this image that copies /plugins/ into the shared
# volume. The runtime layer therefore only needs the plugin binaries
# themselves plus a minimal `cp` — distroless static-nonroot ships a
# BusyBox-less runtime, so we use the bookworm slim minimal base here
# which includes coreutils.
#
# Plugin binary paths are /plugins/<name>. SPIRE's HCL plugin_cmd
# directive expects these exact paths.
FROM golang:1.23.6-bookworm AS builder
WORKDIR /src
# Dependency cache layer — go.mod/go.sum copied first so we only redo
# `go mod download` when module graph changes, not on every source edit.
COPY go.mod go.sum ./
RUN go mod download
COPY . .
# Build each plugin binary into /plugins/. CGO disabled so the binaries
# are statically linked and runnable from any base image.
ENV CGO_ENABLED=0
ENV GOOS=linux
ENV GOARCH=amd64
RUN mkdir -p /plugins && \
go build -trimpath -ldflags="-s -w" -o /plugins/oidc-attestor ./cmd/oidc-attestor && \
go build -trimpath -ldflags="-s -w" -o /plugins/ssh-credential-composer ./cmd/ssh-credential-composer && \
go build -trimpath -ldflags="-s -w" -o /plugins/governance-notifier ./cmd/governance-notifier && \
go build -trimpath -ldflags="-s -w" -o /plugins/substrate-keymanager ./cmd/substrate-keymanager
FROM debian:bookworm-slim AS runtime
# No shell commands needed at image boot — this image is inert. The
# initContainer that uses it supplies its own `cp -r /plugins/ /opt/spire/plugins/`
# command. We keep the binaries readable by any UID so SPIRE's
# non-root user can read them out of the shared volume.
COPY --from=builder /plugins/ /plugins/
RUN chmod -R a+rx /plugins
LABEL org.opencontainers.image.source="https://git.guildhouse.dev/tking/guildhouse-spire-plugins" \
org.opencontainers.image.description="Guildhouse SPIRE plugins: oidc-attestor, ssh-credential-composer, governance-notifier, substrate-keymanager" \
org.opencontainers.image.licenses="Apache-2.0"