Docker image

The SDK does not require a specific base image. For a Go binary without system dependencies, use a two-stage build.

FROM golang:1.26.2-alpine AS build

WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download

COPY . .
RUN go test ./...
RUN CGO_ENABLED=0 GOOS=linux go build -trimpath -o /out/app .

FROM gcr.io/distroless/static-debian12:nonroot
WORKDIR /app
COPY --from=build /out/app /app/app

USER nonroot:nonroot
ENTRYPOINT ["/app/app"]

Build and run:

docker build -t hello-colibri:v0.2.2 .
docker run --rm \
  -e ENVIRONMENT=production \
  -e APP_NAME=hello-colibri \
  -e APP_TYPE=service \
  -e CLOUD=none \
  -p 8080:8080 \
  hello-colibri:v0.2.2

Inject secrets through the runtime platform, use /health for probes, and allow up to WAIT_GROUP_TIMEOUT_SECONDS for graceful shutdown after SIGTERM.