docs/Dockerfile at main · livetemplate/docs · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
# Multi-stage build for the LiveTemplate docs site. Two binaries ship
# in the final image: tinkerdown (renders docs) and site (hosts recipe
# apps on a loopback port). The entrypoint script starts both; tinkerdown
# auto-proxies embed-lvt blocks to localhost:9091 where site listens.
#
# Tinkerdown is built from source because `go install ...@latest` fails
# until upstream fixes the vendored asset embed (Phase 0 finding T0-1).
# `TINKERDOWN_REF` selects which branch/tag to clone and is overridable.

ARG TINKERDOWN_REF=v0.3.9

# ---- Stage 1: Build TypeScript client assets for tinkerdown ----
FROM node:20-alpine AS client-builder
ARG TINKERDOWN_REF
RUN apk add --no-cache git
WORKDIR /src
RUN git clone --depth=1 --branch=${TINKERDOWN_REF} https://github.com/livetemplate/tinkerdown.git .
WORKDIR /src/client
RUN npm ci --prefer-offline --no-audit && npm run build

# ---- Stage 2: Build the tinkerdown binary ----
FROM golang:1.26-alpine AS tinkerdown-builder
ARG TINKERDOWN_REF
RUN apk add --no-cache git ca-certificates
ENV GOTOOLCHAIN=auto
WORKDIR /src
RUN git clone --depth=1 --branch=${TINKERDOWN_REF} https://github.com/livetemplate/tinkerdown.git .
COPY --from=client-builder /src/client/dist/ ./client/dist/
RUN mkdir -p internal/assets/client && \
    cp client/dist/tinkerdown-client.browser.js internal/assets/client/ && \
    cp client/dist/tinkerdown-client.browser.js.map internal/assets/client/ && \
    cp client/dist/tinkerdown-client.browser.css internal/assets/client/ && \
    cp client/dist/tinkerdown-client.browser.css.map internal/assets/client/
RUN go mod download
RUN CGO_ENABLED=0 GOOS=linux go build \
    -ldflags="-s -w" \
    -o /out/tinkerdown ./cmd/tinkerdown

# ---- Stage 3: Build the docs-site recipes binary ----
FROM golang:1.26-alpine AS site-builder
RUN apk add --no-cache git ca-certificates
ENV GOTOOLCHAIN=auto
WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build \
    -ldflags="-s -w" \
    -o /out/site ./cmd/site

# ---- Stage 4: Runtime image — both binaries + docs content + entrypoint ----
FROM alpine:3.21
RUN apk add --no-cache ca-certificates tzdata
RUN adduser -D -u 1000 docs
WORKDIR /site
COPY --from=tinkerdown-builder /out/tinkerdown /usr/local/bin/tinkerdown
COPY --from=site-builder       /out/site       /usr/local/bin/site
# Mirror the repo layout inside /site so tinkerdown's site-rooted
# `include="/examples/..."` paths resolve correctly. Site-rooted includes
# resolve against filepath.Dir(servedRoot) — with servedRoot=/site/content,
# /examples/foo.go → /site/examples/foo.go. Keeping content/ and examples/
# as siblings under /site reproduces the in-repo layout that local
# `tinkerdown serve content/` already relies on.
COPY content/  /site/content/
COPY examples/ /site/examples/
COPY docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
RUN chmod +x /usr/local/bin/docker-entrypoint.sh && chown -R docs:docs /site
USER docs
EXPOSE 8080
ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]