์ฝ˜ํ…์ธ  ๋Œ€ํ‘œ ์ด๋ฏธ์ง€ - ๐Ÿณ Go์–ธ์–ด Docker ์ปจํ…Œ์ด๋„ˆํ™”์™€ ๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ๋กœ ์ดˆ๊ฒฝ๋Ÿ‰ ์ด๋ฏธ์ง€ ๋งŒ๋“ค๊ธฐ

๐Ÿณ Go์–ธ์–ด Docker ์ปจํ…Œ์ด๋„ˆํ™”์™€ ๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ๋กœ ์ดˆ๊ฒฝ๋Ÿ‰ ์ด๋ฏธ์ง€ ๋งŒ๋“ค๊ธฐ

์นœ๊ตฌ์•ผ, ์˜ค๋Š˜์€ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ Docker๋กœ ํฌ์žฅํ•˜๋Š” ๋งˆ๋ฒ•์„ ์•Œ๋ ค์ค„๊ฒŒ! ๐Ÿš€

๐ŸŽฏ ์™œ Go์™€ Docker๋Š” ์ฐฐ๋–ก๊ถํ•ฉ์ผ๊นŒ?

์•ผ, ์†”์งํžˆ ๋งํ•ด์„œ Go ์–ธ์–ด๋กœ ๊ฐœ๋ฐœํ•˜๋ฉด์„œ Docker ์•ˆ ์“ฐ๋ฉด ์ง„์งœ ์•„๊น๋‹ค๋Š” ๊ฑฐ ์•Œ์•„? ๐Ÿ˜„ Go๋Š” ์ •์  ์ปดํŒŒ์ผ ์–ธ์–ด๋ผ์„œ ์‹คํ–‰ ํŒŒ์ผ ํ•˜๋‚˜๋งŒ ์žˆ์œผ๋ฉด ๋Œ์•„๊ฐ€๊ฑฐ๋“ . ์ด๊ฒŒ ๋ฌด์Šจ ๋œป์ด๋ƒ๋ฉด, ๋ณต์žกํ•œ ๋Ÿฐํƒ€์ž„ ํ™˜๊ฒฝ์ด๋‚˜ ์˜์กด์„ฑ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ๋”ฐ๋กœ ์„ค์น˜ํ•  ํ•„์š”๊ฐ€ ์—†๋‹ค๋Š” ๊ฑฐ์ง€!

์˜ˆ๋ฅผ ๋“ค์–ด๋ณผ๊ฒŒ. Python์ด๋‚˜ Node.js๋กœ ๊ฐœ๋ฐœํ•˜๋ฉด ํ•ด๋‹น ๋Ÿฐํƒ€์ž„์ด ์„œ๋ฒ„์— ๊น”๋ ค์žˆ์–ด์•ผ ํ•˜์ž–์•„? ๊ทผ๋ฐ Go๋Š” ์ปดํŒŒ์ผํ•˜๋ฉด ๊ทธ๋ƒฅ ์‹คํ–‰ ํŒŒ์ผ ํ•˜๋‚˜๊ฐ€ ๋™‡! ๋‚˜์™€. ์ด ํŒŒ์ผ๋งŒ ์žˆ์œผ๋ฉด ์–ด๋””์„œ๋“  ์‹คํ–‰ ๊ฐ€๋Šฅํ•ด. ์ด๋Ÿฐ ํŠน์„ฑ ๋•๋ถ„์— Docker ์ด๋ฏธ์ง€๋ฅผ ๋งŒ๋“ค ๋•Œ ์—„์ฒญ๋‚˜๊ฒŒ ์ž‘๊ฒŒ ๋งŒ๋“ค ์ˆ˜ ์žˆ์–ด. ๐ŸŽ

๐Ÿ’ก ์‹ค์ œ ์‚ฌ๋ก€: ์ผ๋ฐ˜์ ์ธ Node.js ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ Docker ์ด๋ฏธ์ง€๋Š” ๋ณดํ†ต 300MB~1GB ์ •๋„ ๋‚˜๊ฐ€๋Š”๋ฐ, Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ ๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด 10MB ์ดํ•˜๋กœ๋„ ๋งŒ๋“ค ์ˆ˜ ์žˆ์–ด! ์‹ฌ์ง€์–ด 5MB ์ดํ•˜๋„ ๊ฐ€๋Šฅํ•˜์ง€.

์ด๋Ÿฐ ๊ฒฝ๋Ÿ‰ํ™”๊ฐ€ ์™œ ์ค‘์š”ํ•˜๋ƒ๊ณ ? ๐Ÿค” ์ด๋ฏธ์ง€ ํฌ๊ธฐ๊ฐ€ ์ž‘์œผ๋ฉด ๋ฐฐํฌ ์†๋„๊ฐ€ ๋นจ๋ผ์ง€๊ณ , ๋„คํŠธ์›Œํฌ ๋Œ€์—ญํญ์„ ์ ๊ฒŒ ์“ฐ๊ณ , ์Šคํ† ๋ฆฌ์ง€ ๋น„์šฉ๋„ ์ ˆ์•ฝ๋˜๊ฑฐ๋“ . ํŠนํžˆ ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ์•„ํ‚คํ…์ฒ˜์—์„œ ์ˆ˜์‹ญ ๊ฐœ์˜ ์„œ๋น„์Šค๋ฅผ ์šด์˜ํ•œ๋‹ค๋ฉด ์ด ์ฐจ์ด๊ฐ€ ์—„์ฒญ๋‚˜๊ฒŒ ์ปค์ ธ!

๐Ÿ—๏ธ ๊ธฐ๋ณธ์ ์ธ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ Dockerํ™”ํ•˜๊ธฐ

์ž, ์ด์ œ ๋ณธ๊ฒฉ์ ์œผ๋กœ ์‹œ์ž‘ํ•ด๋ณผ๊นŒ? ๋จผ์ € ๊ฐ„๋‹จํ•œ Go ์›น ์„œ๋ฒ„๋ฅผ ๋งŒ๋“ค์–ด๋ณด์ž. ์ด๊ฑด ์ •๋ง ๊ธฐ์ดˆ์ ์ธ ์˜ˆ์ œ์ธ๋ฐ, ์‹ค์ „์—์„œ๋„ ์ด ํŒจํ„ด์„ ๊ทธ๋Œ€๋กœ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์–ด.

๐Ÿ“ ์ƒ˜ํ”Œ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ž‘์„ฑ

๋จผ์ € main.go ํŒŒ์ผ์„ ๋งŒ๋“ค์–ด๋ณด์ž:

package main

import (
    "fmt"
    "log"
    "net/http"
)

func main() {
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "์•ˆ๋…•! Go + Docker ์กฐํ•ฉ ์ตœ๊ณ ์•ผ! ๐Ÿš€")
    })

    http.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
        w.WriteHeader(http.StatusOK)
        fmt.Fprintf(w, "OK")
    })

    log.Println("์„œ๋ฒ„ ์‹œ์ž‘: ํฌํŠธ 8080")
    if err := http.ListenAndServe(":8080", nil); err != nil {
        log.Fatal(err)
    }
}

์ด ์ฝ”๋“œ๋Š” 8080 ํฌํŠธ์—์„œ ๊ฐ„๋‹จํ•œ ์›น ์„œ๋ฒ„๋ฅผ ์‹คํ–‰ํ•˜๋Š” ๊ฑฐ์•ผ. / ๊ฒฝ๋กœ๋กœ ์ ‘์†ํ•˜๋ฉด ์ธ์‚ฌ๋ง์„ ๋ณด์—ฌ์ฃผ๊ณ , /health ๊ฒฝ๋กœ๋Š” ํ—ฌ์Šค์ฒดํฌ์šฉ์ด์ง€. ์‹ค์ œ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” ํ—ฌ์Šค์ฒดํฌ ์—”๋“œํฌ์ธํŠธ๊ฐ€ ์ •๋ง ์ค‘์š”ํ•ด! ๐Ÿฅ

๐Ÿ‹ ๊ธฐ๋ณธ Dockerfile ์ž‘์„ฑ (๋น„์ถ”์ฒœ ๋ฐฉ์‹)

์ฒ˜์Œ Docker๋ฅผ ์ ‘ํ•˜๋ฉด ๋ณดํ†ต ์ด๋ ‡๊ฒŒ ์ž‘์„ฑํ•˜๊ฒŒ ๋ผ:

FROM golang:1.21

WORKDIR /app

COPY . .

RUN go build -o main .

EXPOSE 8080

CMD ["./main"]
โš ๏ธ ์ด ๋ฐฉ์‹์˜ ๋ฌธ์ œ์ : ์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ์ด๋ฏธ์ง€ ํฌ๊ธฐ๊ฐ€ ์•ฝ 800MB~1GB ์ •๋„ ๋‚˜์™€! ์™œ๋ƒํ•˜๋ฉด golang:1.21 ๋ฒ ์ด์Šค ์ด๋ฏธ์ง€์—๋Š” Go ์ปดํŒŒ์ผ๋Ÿฌ, ๋นŒ๋“œ ๋„๊ตฌ, ๊ฐ์ข… ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๊ฐ€ ๋‹ค ๋“ค์–ด์žˆ๊ฑฐ๋“ . ๊ทผ๋ฐ ์‹คํ–‰ํ•  ๋•Œ๋Š” ์ด๋Ÿฐ ๊ฑฐ ํ•„์š” ์—†์ž–์•„? ์ปดํŒŒ์ผ๋œ ๋ฐ”์ด๋„ˆ๋ฆฌ๋งŒ ์žˆ์œผ๋ฉด ๋˜๋Š”๋ฐ ๋ง์ด์•ผ.

์ด๋ฏธ์ง€๋ฅผ ๋นŒ๋“œํ•˜๊ณ  ํ™•์ธํ•ด๋ณด๋ฉด:

docker build -t myapp:basic .
docker images myapp:basic

# ๊ฒฐ๊ณผ
REPOSITORY   TAG       IMAGE ID       CREATED         SIZE
myapp        basic     abc123def456   2 minutes ago   862MB

๋ดค์ง€? 862MB๋‚˜ ๋‚˜์™€. ์ด๊ฑด ๋„ˆ๋ฌด ํฌ์ž–์•„! ๐Ÿ˜ฑ

Docker ์ด๋ฏธ์ง€ ํฌ๊ธฐ ๋น„๊ต ๊ธฐ๋ณธ ๋นŒ๋“œ 862MB golang:1.21 ๋ฒ ์ด์Šค ๐Ÿ˜ฐ ๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ 8MB alpine ๋ฒ ์ด์Šค ๐ŸŽ‰ 99% ๊ฐ์†Œ!

๐ŸŽญ ๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ์˜ ๋งˆ๋ฒ•

์ž, ์ด์ œ ์ง„์งœ ํ•ต์‹ฌ ๊ธฐ์ˆ ์„ ์•Œ๋ ค์ค„๊ฒŒ! ๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ๋Š” Docker์˜ ๊ฟ€๊ธฐ๋Šฅ ์ค‘ ํ•˜๋‚˜์•ผ. ์ด๋ฆ„์—์„œ ์•Œ ์ˆ˜ ์žˆ๋“ฏ์ด ์—ฌ๋Ÿฌ ๋‹จ๊ณ„(stage)๋กœ ๋‚˜๋ˆ ์„œ ๋นŒ๋“œํ•˜๋Š” ๊ฑฐ์ง€. ๐ŸŽช

๊ฐœ๋…์€ ๊ฐ„๋‹จํ•ด. ์ฒซ ๋ฒˆ์งธ ์Šคํ…Œ์ด์ง€์—์„œ๋Š” Go ์ปดํŒŒ์ผ๋Ÿฌ๊ฐ€ ์žˆ๋Š” ํฐ ์ด๋ฏธ์ง€๋กœ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๋นŒ๋“œํ•˜๊ณ , ๋‘ ๋ฒˆ์งธ ์Šคํ…Œ์ด์ง€์—์„œ๋Š” ์ž‘์€ ๋ฒ ์ด์Šค ์ด๋ฏธ์ง€์— ์ปดํŒŒ์ผ๋œ ๋ฐ”์ด๋„ˆ๋ฆฌ๋งŒ ๋ณต์‚ฌํ•˜๋Š” ๊ฑฐ์•ผ. ๋นŒ๋“œ ๋„๊ตฌ๋“ค์€ ์ตœ์ข… ์ด๋ฏธ์ง€์— ํฌํ•จ๋˜์ง€ ์•Š์•„!

๐Ÿ”ฅ ์ตœ์ ํ™”๋œ Dockerfile ์ž‘์„ฑ

# ๋นŒ๋“œ ์Šคํ…Œ์ด์ง€
FROM golang:1.21-alpine AS builder

# ํ•„์š”ํ•œ ๋นŒ๋“œ ๋„๊ตฌ ์„ค์น˜
RUN apk add --no-cache git

WORKDIR /app

# ์˜์กด์„ฑ ํŒŒ์ผ ๋จผ์ € ๋ณต์‚ฌ (์บ์‹ฑ ์ตœ์ ํ™”)
COPY go.mod go.sum ./
RUN go mod download

# ์†Œ์Šค ์ฝ”๋“œ ๋ณต์‚ฌ
COPY . .

# ์ •์  ๋งํฌ ๋ฐ”์ด๋„ˆ๋ฆฌ ๋นŒ๋“œ
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -ldflags '-extldflags "-static"' -o main .

# ์‹คํ–‰ ์Šคํ…Œ์ด์ง€
FROM alpine:latest

# ๋ณด์•ˆ ์—…๋ฐ์ดํŠธ ๋ฐ CA ์ธ์ฆ์„œ ์„ค์น˜
RUN apk --no-cache add ca-certificates tzdata

WORKDIR /root/

# ๋นŒ๋” ์Šคํ…Œ์ด์ง€์—์„œ ๋ฐ”์ด๋„ˆ๋ฆฌ๋งŒ ๋ณต์‚ฌ
COPY --from=builder /app/main .

EXPOSE 8080

CMD ["./main"]

์™€, ์ฝ”๋“œ๊ฐ€ ์ข€ ๊ธธ์–ด ๋ณด์ด์ง€? ํ•˜๋‚˜์”ฉ ๋œฏ์–ด๋ณด์ž! ๐Ÿ”

โœจ ๊ฐ ๋ถ€๋ถ„ ์„ค๋ช…: 1. ๋นŒ๋“œ ์Šคํ…Œ์ด์ง€ (AS builder):
- golang:1.21-alpine์„ ์‚ฌ์šฉํ•ด์„œ ๊ธฐ๋ณธ golang ์ด๋ฏธ์ง€๋ณด๋‹ค ์ž‘๊ฒŒ ์‹œ์ž‘
- go.mod์™€ go.sum์„ ๋จผ์ € ๋ณต์‚ฌํ•ด์„œ ์˜์กด์„ฑ ๋‹ค์šด๋กœ๋“œ๋ฅผ ์บ์‹ฑ
- CGO_ENABLED=0์œผ๋กœ ์ˆœ์ˆ˜ Go ๋ฐ”์ด๋„ˆ๋ฆฌ ์ƒ์„ฑ (C ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์˜์กด์„ฑ ์ œ๊ฑฐ)

2. ์‹คํ–‰ ์Šคํ…Œ์ด์ง€:
- alpine:latest ์‚ฌ์šฉ (์•ฝ 5MB ํฌ๊ธฐ!)
- CA ์ธ์ฆ์„œ ์„ค์น˜ (HTTPS ํ†ต์‹ ํ•  ๋•Œ ํ•„์š”)
- ๋นŒ๋”์—์„œ ์ปดํŒŒ์ผ๋œ ๋ฐ”์ด๋„ˆ๋ฆฌ๋งŒ ๋ณต์‚ฌ

์ด์ œ ๋นŒ๋“œํ•ด๋ณด์ž:

docker build -t myapp:optimized .
docker images myapp:optimized

# ๊ฒฐ๊ณผ
REPOSITORY   TAG         IMAGE ID       CREATED          SIZE
myapp        optimized   xyz789abc123   10 seconds ago   12MB

์งœ์ž”! ๐ŸŽ‰ 862MB์—์„œ 12MB๋กœ ์ค„์—ˆ์–ด! ์•ฝ 98.6% ๊ฐ์†Œ์•ผ. ์ด ์ •๋„๋ฉด ๋ฐฐํฌํ•  ๋•Œ ๋„คํŠธ์›Œํฌ ์ „์†ก ์‹œ๊ฐ„์ด ์—„์ฒญ ์ค„์–ด๋“ค๊ฒ ์ง€?

๐Ÿš€ ๋” ๊ทน๋‹จ์ ์ธ ์ตœ์ ํ™”: Scratch ์ด๋ฏธ์ง€

์นœ๊ตฌ์•ผ, ๋” ์ž‘๊ฒŒ ๋งŒ๋“ค ์ˆ˜ ์žˆ์„๊นŒ? ์žˆ์–ด! scratch๋ผ๋Š” ํŠน๋ณ„ํ•œ ๋ฒ ์ด์Šค ์ด๋ฏธ์ง€๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ๋ผ. ์ด๊ฑด ๋ง ๊ทธ๋Œ€๋กœ ๋นˆ ์ด๋ฏธ์ง€์•ผ. ์•„๋ฌด๊ฒƒ๋„ ์—†์–ด! ๐Ÿ˜ฎ

# ๋นŒ๋“œ ์Šคํ…Œ์ด์ง€
FROM golang:1.21-alpine AS builder

WORKDIR /app

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

COPY . .

# ์™„์ „ ์ •์  ๋งํฌ ๋ฐ”์ด๋„ˆ๋ฆฌ ๋นŒ๋“œ
RUN CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-w -s -extldflags "-static"' -o main .

# ์‹คํ–‰ ์Šคํ…Œ์ด์ง€ - scratch ์‚ฌ์šฉ!
FROM scratch

# CA ์ธ์ฆ์„œ ๋ณต์‚ฌ (HTTPS ํ†ต์‹ ์šฉ)
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/

# ํƒ€์ž„์กด ๋ฐ์ดํ„ฐ ๋ณต์‚ฌ (ํ•„์š”์‹œ)
COPY --from=builder /usr/share/zoneinfo /usr/share/zoneinfo

# ๋ฐ”์ด๋„ˆ๋ฆฌ ๋ณต์‚ฌ
COPY --from=builder /app/main /main

EXPOSE 8080

ENTRYPOINT ["/main"]

์ด๋ ‡๊ฒŒ ํ•˜๋ฉด:

docker build -t myapp:scratch .
docker images myapp:scratch

# ๊ฒฐ๊ณผ
REPOSITORY   TAG       IMAGE ID       CREATED          SIZE
myapp        scratch   def456ghi789   5 seconds ago    6.8MB

6.8MB! ๐Ÿคฏ ์ด์ œ ์ง„์งœ ์ตœ์†Œํ•œ์˜ ํฌ๊ธฐ์•ผ. ํ•˜์ง€๋งŒ ์ฃผ์˜ํ•  ์ ์ด ์žˆ์–ด!

โš ๏ธ Scratch ์ด๋ฏธ์ง€ ์‚ฌ์šฉ ์‹œ ์ฃผ์˜์‚ฌํ•ญ: 1. ๋””๋ฒ„๊น…์ด ์–ด๋ ค์›Œ: ์‰˜๋„ ์—†๊ณ  ๊ธฐ๋ณธ ์œ ํ‹ธ๋ฆฌํ‹ฐ๋„ ์—†์–ด์„œ ์ปจํ…Œ์ด๋„ˆ ์•ˆ์— ๋“ค์–ด๊ฐ€์„œ ๋ญ”๊ฐ€ ํ™•์ธํ•˜๊ธฐ๊ฐ€ ํž˜๋“ค์–ด
2. CA ์ธ์ฆ์„œ ํ•„์ˆ˜: HTTPS ํ†ต์‹ ํ•˜๋ ค๋ฉด ์ธ์ฆ์„œ๋ฅผ ์ง์ ‘ ๋ณต์‚ฌํ•ด์•ผ ํ•ด
3. ํƒ€์ž„์กด ์„ค์ •: ์‹œ๊ฐ„ ๊ด€๋ จ ๊ธฐ๋Šฅ ์“ฐ๋ ค๋ฉด ํƒ€์ž„์กด ๋ฐ์ดํ„ฐ๋„ ๋ณต์‚ฌ ํ•„์š”
4. CGO ์‚ฌ์šฉ ๋ถˆ๊ฐ€: C ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์— ์˜์กดํ•˜๋Š” ํŒจํ‚ค์ง€๋Š” ๋ชป ์จ

๊ฐœ์ธ์ ์œผ๋กœ๋Š” ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” alpine ๋ฒ ์ด์Šค๋ฅผ ์ถ”์ฒœํ•ด. ํฌ๊ธฐ๋Š” ์กฐ๊ธˆ ๋” ํฌ์ง€๋งŒ ๋””๋ฒ„๊น…ํ•  ๋•Œ ํ›จ์”ฌ ํŽธํ•˜๊ฑฐ๋“ ! ๐Ÿ˜Š

โšก ๋นŒ๋“œ ์†๋„ ์ตœ์ ํ™” ์ „๋žต

์ด๋ฏธ์ง€ ํฌ๊ธฐ๋„ ์ค‘์š”ํ•˜์ง€๋งŒ, ๋นŒ๋“œ ์†๋„๋„ ์—„์ฒญ ์ค‘์š”ํ•ด! ํŠนํžˆ CI/CD ํŒŒ์ดํ”„๋ผ์ธ์—์„œ ๋งค๋ฒˆ ๋นŒ๋“œํ•  ๋•Œ๋งˆ๋‹ค ์‹œ๊ฐ„์ด ์˜ค๋ž˜ ๊ฑธ๋ฆฌ๋ฉด ๊ฐœ๋ฐœ ์†๋„๊ฐ€ ๋А๋ ค์ง€์ž–์•„? ๐ŸŒ

๐Ÿ“ฆ ๋ ˆ์ด์–ด ์บ์‹ฑ ํ™œ์šฉํ•˜๊ธฐ

Docker๋Š” ๋ ˆ์ด์–ด ์บ์‹ฑ์ด๋ผ๋Š” ๋ฉ‹์ง„ ๊ธฐ๋Šฅ์ด ์žˆ์–ด. ๊ฐ ๋ช…๋ น์–ด(RUN, COPY ๋“ฑ)๊ฐ€ ๋ ˆ์ด์–ด๋ฅผ ๋งŒ๋“œ๋Š”๋ฐ, ๋ณ€๊ฒฝ๋˜์ง€ ์•Š์€ ๋ ˆ์ด์–ด๋Š” ์บ์‹œ์—์„œ ์žฌ์‚ฌ์šฉํ•ด. ์ด๊ฑธ ์ž˜ ํ™œ์šฉํ•˜๋ฉด ๋นŒ๋“œ ์†๋„๋ฅผ ์—„์ฒญ ๋†’์ผ ์ˆ˜ ์žˆ์–ด!

# โŒ ๋น„ํšจ์œจ์ ์ธ ๋ฐฉ์‹
FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY . .                    # ๋ชจ๋“  ํŒŒ์ผ ๋ณต์‚ฌ
RUN go mod download         # ์†Œ์Šค ์ฝ”๋“œ ๋ฐ”๋€” ๋•Œ๋งˆ๋‹ค ์˜์กด์„ฑ ๋‹ค์‹œ ๋‹ค์šด๋กœ๋“œ!
RUN go build -o main .

# โœ… ํšจ์œจ์ ์ธ ๋ฐฉ์‹
FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./       # ์˜์กด์„ฑ ํŒŒ์ผ๋งŒ ๋จผ์ € ๋ณต์‚ฌ
RUN go mod download         # ์˜์กด์„ฑ ์บ์‹ฑ!
COPY . .                    # ๊ทธ ๋‹ค์Œ ์†Œ์Šค ์ฝ”๋“œ ๋ณต์‚ฌ
RUN go build -o main .

์ฐจ์ด๊ฐ€ ๋ณด์ด์ง€? ๋‘ ๋ฒˆ์งธ ๋ฐฉ์‹์€ go.mod๋‚˜ go.sum์ด ๋ณ€๊ฒฝ๋˜์ง€ ์•Š์œผ๋ฉด go mod download ๋‹จ๊ณ„๋ฅผ ๊ฑด๋„ˆ๋›ฐ์–ด! ์‹ค์ œ๋กœ ํ…Œ์ŠคํŠธํ•ด๋ณด๋ฉด:

๐Ÿ• ๋นŒ๋“œ ์‹œ๊ฐ„ ๋น„๊ต: ์ฒซ ๋ฒˆ์งธ ๋นŒ๋“œ: ์•ฝ 2๋ถ„ 30์ดˆ
์†Œ์Šค ์ฝ”๋“œ๋งŒ ์ˆ˜์ • ํ›„ ์žฌ๋นŒ๋“œ (๋น„ํšจ์œจ์  ๋ฐฉ์‹): ์•ฝ 2๋ถ„ 20์ดˆ
์†Œ์Šค ์ฝ”๋“œ๋งŒ ์ˆ˜์ • ํ›„ ์žฌ๋นŒ๋“œ (ํšจ์œจ์  ๋ฐฉ์‹): ์•ฝ 15์ดˆ!

์˜์กด์„ฑ ๋‹ค์šด๋กœ๋“œ๋ฅผ ๊ฑด๋„ˆ๋›ฐ๋‹ˆ๊นŒ 10๋ฐฐ ๊ฐ€๊นŒ์ด ๋นจ๋ผ์กŒ์–ด! ๐Ÿš€

๐ŸŽฏ .dockerignore ํŒŒ์ผ ํ™œ์šฉ

Git์— .gitignore๊ฐ€ ์žˆ๋“ฏ์ด, Docker์—๋Š” .dockerignore๊ฐ€ ์žˆ์–ด. ์ด๊ฑธ ์‚ฌ์šฉํ•˜๋ฉด ๋ถˆํ•„์š”ํ•œ ํŒŒ์ผ๋“ค์„ ๋นŒ๋“œ ์ปจํ…์ŠคํŠธ์—์„œ ์ œ์™ธํ•  ์ˆ˜ ์žˆ์–ด.

# .dockerignore ์˜ˆ์‹œ
.git
.gitignore
README.md
.env
.env.*
docker-compose.yml
Dockerfile
.dockerignore
*.md
.vscode
.idea
*.log
tmp/
vendor/
node_modules/
coverage/
*.test
*.out

์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ๋นŒ๋“œ ์ปจํ…์ŠคํŠธ๊ฐ€ ์ž‘์•„์ ธ์„œ Docker ๋ฐ๋ชฌ์œผ๋กœ ํŒŒ์ผ์„ ์ „์†กํ•˜๋Š” ์‹œ๊ฐ„์ด ์ค„์–ด๋“ค์–ด. ํŠนํžˆ ํ”„๋กœ์ ํŠธ๊ฐ€ ํฌ๋ฉด ํด์ˆ˜๋ก ํšจ๊ณผ๊ฐ€ ์ปค์ ธ! ๐Ÿ“ฆ

๐Ÿ”ง ๋นŒ๋“œ ์ธ์ž(Build Args) ํ™œ์šฉ

ํ™˜๊ฒฝ์— ๋”ฐ๋ผ ๋‹ค๋ฅธ ์„ค์ •์œผ๋กœ ๋นŒ๋“œํ•˜๊ณ  ์‹ถ์„ ๋•Œ๊ฐ€ ์žˆ์ž–์•„? ๊ทธ๋Ÿด ๋•Œ ๋นŒ๋“œ ์ธ์ž๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ๋ผ:

FROM golang:1.21-alpine AS builder

# ๋นŒ๋“œ ์ธ์ž ์ •์˜
ARG VERSION=dev
ARG BUILD_TIME
ARG GIT_COMMIT

WORKDIR /app

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

COPY . .

# ๋นŒ๋“œ ์‹œ ๋ฒ„์ „ ์ •๋ณด ์ฃผ์ž…
RUN CGO_ENABLED=0 go build \
    -ldflags "-X main.Version=${VERSION} -X main.BuildTime=${BUILD_TIME} -X main.GitCommit=${GIT_COMMIT}" \
    -o main .

FROM alpine:latest
RUN apk --no-cache add ca-certificates
WORKDIR /root/
COPY --from=builder /app/main .
EXPOSE 8080
CMD ["./main"]

๊ทธ๋ฆฌ๊ณ  Go ์ฝ”๋“œ์—์„œ:

package main

import (
    "fmt"
    "log"
    "net/http"
)

var (
    Version   = "unknown"
    BuildTime = "unknown"
    GitCommit = "unknown"
)

func main() {
    http.HandleFunc("/version", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Version: %s\nBuild Time: %s\nGit Commit: %s\n", 
            Version, BuildTime, GitCommit)
    })

    log.Printf("Starting server v%s (commit: %s)", Version, GitCommit)
    http.ListenAndServe(":8080", nil)
}

๋นŒ๋“œํ•  ๋•Œ:

docker build \
  --build-arg VERSION=1.2.3 \
  --build-arg BUILD_TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ") \
  --build-arg GIT_COMMIT=$(git rev-parse --short HEAD) \
  -t myapp:1.2.3 .

์ด์ œ /version ์—”๋“œํฌ์ธํŠธ๋กœ ์ ‘์†ํ•˜๋ฉด ๋นŒ๋“œ ์ •๋ณด๋ฅผ ํ™•์ธํ•  ์ˆ˜ ์žˆ์–ด! ์šด์˜ ํ™˜๊ฒฝ์—์„œ ์–ด๋–ค ๋ฒ„์ „์ด ๋ฐฐํฌ๋˜์–ด ์žˆ๋Š”์ง€ ํ™•์ธํ•  ๋•Œ ์ •๋ง ์œ ์šฉํ•ด. ๐Ÿท๏ธ

๐Ÿ›ก๏ธ ๋ณด์•ˆ ๊ฐ•ํ™” ์ „๋žต

๊ฒฝ๋Ÿ‰ํ™”๋„ ์ค‘์š”ํ•˜์ง€๋งŒ ๋ณด์•ˆ๋„ ์ ˆ๋Œ€ ๋†“์น˜๋ฉด ์•ˆ ๋ผ! Docker ์ปจํ…Œ์ด๋„ˆ๋Š” ๊ฒฉ๋ฆฌ๋˜์–ด ์žˆ๋‹ค๊ณ  ํ•ด๋„ ์ œ๋Œ€๋กœ ์„ค์ •ํ•˜์ง€ ์•Š์œผ๋ฉด ๋ณด์•ˆ ์ทจ์•ฝ์ ์ด ์ƒ๊ธธ ์ˆ˜ ์žˆ์–ด. ๐Ÿ˜จ

๐Ÿ‘ค Non-root ์‚ฌ์šฉ์ž๋กœ ์‹คํ–‰ํ•˜๊ธฐ

๊ธฐ๋ณธ์ ์œผ๋กœ Docker ์ปจํ…Œ์ด๋„ˆ๋Š” root ๊ถŒํ•œ์œผ๋กœ ์‹คํ–‰๋ผ. ์ด๊ฑด ๋ณด์•ˆ์ƒ ์ข‹์ง€ ์•Š์•„. ๋งŒ์•ฝ ์ปจํ…Œ์ด๋„ˆ๊ฐ€ ํ•ดํ‚น๋‹นํ•˜๋ฉด ๊ณต๊ฒฉ์ž๊ฐ€ root ๊ถŒํ•œ์„ ๊ฐ€์ง€๊ฒŒ ๋˜๊ฑฐ๋“ !

FROM golang:1.21-alpine AS builder

WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o main .

FROM alpine:latest

# ๋ณด์•ˆ ์—…๋ฐ์ดํŠธ
RUN apk --no-cache add ca-certificates && \
    apk upgrade

# ์ผ๋ฐ˜ ์‚ฌ์šฉ์ž ์ƒ์„ฑ
RUN addgroup -g 1000 appgroup && \
    adduser -D -u 1000 -G appgroup appuser

WORKDIR /home/appuser

# ๋ฐ”์ด๋„ˆ๋ฆฌ ๋ณต์‚ฌ ๋ฐ ๊ถŒํ•œ ์„ค์ •
COPY --from=builder /app/main .
RUN chown appuser:appgroup main

# ์ผ๋ฐ˜ ์‚ฌ์šฉ์ž๋กœ ์ „ํ™˜
USER appuser

EXPOSE 8080
CMD ["./main"]

์ด์ œ ์ปจํ…Œ์ด๋„ˆ๊ฐ€ ์ผ๋ฐ˜ ์‚ฌ์šฉ์ž ๊ถŒํ•œ์œผ๋กœ ์‹คํ–‰๋ผ! ํ›จ์”ฌ ์•ˆ์ „ํ•˜์ง€? ๐Ÿ”’

๐Ÿ” ์ทจ์•ฝ์  ์Šค์บ”ํ•˜๊ธฐ

์ด๋ฏธ์ง€๋ฅผ ๋นŒ๋“œํ•œ ํ›„์—๋Š” ์ทจ์•ฝ์  ์Šค์บ”์„ ํ•ด์•ผ ํ•ด. Docker Desktop์— ๋‚ด์žฅ๋œ ์Šค์บ” ๊ธฐ๋Šฅ์ด๋‚˜ Trivy ๊ฐ™์€ ๋„๊ตฌ๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์–ด:

# Docker ๋‚ด์žฅ ์Šค์บ”
docker scan myapp:optimized

# Trivy ์‚ฌ์šฉ (๋” ์ƒ์„ธํ•จ)
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
  aquasec/trivy image myapp:optimized

์ทจ์•ฝ์ ์ด ๋ฐœ๊ฒฌ๋˜๋ฉด ๋ฒ ์ด์Šค ์ด๋ฏธ์ง€๋ฅผ ์—…๋ฐ์ดํŠธํ•˜๊ฑฐ๋‚˜ ํŒจํ‚ค์ง€๋ฅผ ์—…๊ทธ๋ ˆ์ด๋“œํ•ด์•ผ ํ•ด. ์ •๊ธฐ์ ์œผ๋กœ ์Šค์บ”ํ•˜๋Š” ๊ฒŒ ์ค‘์š”ํ•ด! ๐Ÿ”Ž

๐Ÿšซ ๋ฏผ๊ฐ ์ •๋ณด ๊ด€๋ฆฌ

์ ˆ๋Œ€๋กœ, ์ ˆ๋Œ€๋กœ ์ด๋ฏธ์ง€์— ๋น„๋ฐ€๋ฒˆํ˜ธ๋‚˜ API ํ‚ค ๊ฐ™์€ ๋ฏผ๊ฐ ์ •๋ณด๋ฅผ ๋„ฃ์œผ๋ฉด ์•ˆ ๋ผ! ๋Œ€์‹  ํ™˜๊ฒฝ ๋ณ€์ˆ˜๋‚˜ Docker Secrets๋ฅผ ์‚ฌ์šฉํ•ด:

package main

import (
    "log"
    "os"
)

func main() {
    // โŒ ํ•˜๋“œ์ฝ”๋”ฉ ๊ธˆ์ง€!
    // apiKey := "sk-1234567890abcdef"
    
    // โœ… ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์‚ฌ์šฉ
    apiKey := os.Getenv("API_KEY")
    if apiKey == "" {
        log.Fatal("API_KEY environment variable is required")
    }
    
    dbPassword := os.Getenv("DB_PASSWORD")
    if dbPassword == "" {
        log.Fatal("DB_PASSWORD environment variable is required")
    }
    
    // ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋กœ์ง...
}

์‹คํ–‰ํ•  ๋•Œ:

docker run -e API_KEY=your-key -e DB_PASSWORD=your-password myapp:optimized

# ๋˜๋Š” .env ํŒŒ์ผ ์‚ฌ์šฉ
docker run --env-file .env myapp:optimized

ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” Kubernetes Secrets, AWS Secrets Manager, HashiCorp Vault ๊ฐ™์€ ์ „๋ฌธ ๋„๊ตฌ๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒŒ ์ข‹์•„! ๐Ÿ”

๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ ํ”„๋กœ์„ธ์Šค Stage 1: Builder golang:1.21-alpine Go ์ปดํŒŒ์ผ๋Ÿฌ + ๋นŒ๋“œ ๋„๊ตฌ 1. ์˜์กด์„ฑ ๋‹ค์šด๋กœ๋“œ 2. ์†Œ์Šค ์ฝ”๋“œ ์ปดํŒŒ์ผ 3. ์ •์  ๋ฐ”์ด๋„ˆ๋ฆฌ ์ƒ์„ฑ ๋นŒ๋“œ ์‚ฐ์ถœ๋ฌผ main (์‹คํ–‰ ํŒŒ์ผ) ํฌ๊ธฐ: ์•ฝ 8MB ์ •์  ๋งํฌ ์™„๋ฃŒ ์™ธ๋ถ€ ์˜์กด์„ฑ ์—†์Œ Stage 2: Runtime alpine:latest ์ตœ์†Œ ๋Ÿฐํƒ€์ž„ ํ™˜๊ฒฝ 1. CA ์ธ์ฆ์„œ ์„ค์น˜ 2. ๋ฐ”์ด๋„ˆ๋ฆฌ๋งŒ ๋ณต์‚ฌ 3. ์‹คํ–‰ ์ค€๋น„ ์™„๋ฃŒ ์ตœ์ข… ์ด๋ฏธ์ง€ alpine + main ์ „์ฒด ํฌ๊ธฐ: ์•ฝ 12MB ๋นŒ๋“œ ๋„๊ตฌ ์ œ์™ธ ํ”„๋กœ๋•์…˜ ์ค€๋น„ ์™„๋ฃŒ COPY 98% ํฌ๊ธฐ ๊ฐ์†Œ! ๐ŸŽ‰

๐ŸŽจ ์‹ค์ „ ์˜ˆ์ œ: REST API ์„œ๋ฒ„

์ด๋ก ์€ ์ถฉ๋ถ„ํžˆ ๋ฐฐ์› ์œผ๋‹ˆ ์ด์ œ ์‹ค์ „ ์˜ˆ์ œ๋ฅผ ๋งŒ๋“ค์–ด๋ณด์ž! ๊ฐ„๋‹จํ•œ TODO REST API ์„œ๋ฒ„๋ฅผ ๋งŒ๋“ค๊ณ  Docker๋กœ ์ปจํ…Œ์ด๋„ˆํ™”ํ•ด๋ณผ๊ฒŒ. ๐Ÿ˜Ž

๐Ÿ“‹ ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ

todo-api/
โ”œโ”€โ”€ main.go
โ”œโ”€โ”€ go.mod
โ”œโ”€โ”€ go.sum
โ”œโ”€โ”€ Dockerfile
โ”œโ”€โ”€ .dockerignore
โ”œโ”€โ”€ handlers/
โ”‚   โ””โ”€โ”€ todo.go
โ”œโ”€โ”€ models/
โ”‚   โ””โ”€โ”€ todo.go
โ””โ”€โ”€ README.md

๐Ÿ’ป ์ฝ”๋“œ ์ž‘์„ฑ

๋จผ์ € models/todo.go:

package models

import "time"

type Todo struct {
    ID        string    `json:"id"`
    Title     string    `json:"title"`
    Completed bool      `json:"completed"`
    CreatedAt time.Time `json:"created_at"`
}

var todos = make(map[string]*Todo)

๋‹ค์Œ handlers/todo.go:

package handlers

import (
    "encoding/json"
    "net/http"
    "time"
    
    "github.com/google/uuid"
    "todo-api/models"
)

func GetTodos(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json")
    
    todoList := make([]*models.Todo, 0)
    for _, todo := range models.todos {
        todoList = append(todoList, todo)
    }
    
    json.NewEncoder(w).Encode(todoList)
}

func CreateTodo(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json")
    
    var todo models.Todo
    if err := json.NewDecoder(r.Body).Decode(&todo); err != nil {
        http.Error(w, err.Error(), http.StatusBadRequest)
        return
    }
    
    todo.ID = uuid.New().String()
    todo.CreatedAt = time.Now()
    models.todos[todo.ID] = &todo
    
    w.WriteHeader(http.StatusCreated)
    json.NewEncoder(w).Encode(todo)
}

๋ฉ”์ธ ํŒŒ์ผ main.go:

package main

import (
    "log"
    "net/http"
    "os"
    
    "todo-api/handlers"
)

var (
    Version   = "dev"
    BuildTime = "unknown"
)

func main() {
    port := os.Getenv("PORT")
    if port == "" {
        port = "8080"
    }
    
    http.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
        w.WriteHeader(http.StatusOK)
        w.Write([]byte("OK"))
    })
    
    http.HandleFunc("/version", func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Content-Type", "application/json")
        w.Write([]byte(`{"version":"` + Version + `","build_time":"` + BuildTime + `"}`))
    })
    
    http.HandleFunc("/todos", func(w http.ResponseWriter, r *http.Request) {
        switch r.Method {
        case http.MethodGet:
            handlers.GetTodos(w, r)
        case http.MethodPost:
            handlers.CreateTodo(w, r)
        default:
            http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
        }
    })
    
    log.Printf("๐Ÿš€ TODO API Server v%s starting on port %s", Version, port)
    if err := http.ListenAndServe(":"+port, nil); err != nil {
        log.Fatal(err)
    }
}

๐Ÿณ ์ตœ์ ํ™”๋œ Dockerfile

# ๋นŒ๋“œ ์Šคํ…Œ์ด์ง€
FROM golang:1.21-alpine AS builder

# ๋นŒ๋“œ ๋„๊ตฌ ์„ค์น˜
RUN apk add --no-cache git ca-certificates tzdata

WORKDIR /app

# ์˜์กด์„ฑ ์บ์‹ฑ
COPY go.mod go.sum ./
RUN go mod download && go mod verify

# ์†Œ์Šค ์ฝ”๋“œ ๋ณต์‚ฌ
COPY . .

# ๋นŒ๋“œ ์ธ์ž
ARG VERSION=dev
ARG BUILD_TIME

# ์ตœ์ ํ™”๋œ ๋นŒ๋“œ
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
    -ldflags="-w -s -X main.Version=${VERSION} -X main.BuildTime=${BUILD_TIME}" \
    -a -installsuffix cgo \
    -o todo-api .

# ์‹คํ–‰ ์Šคํ…Œ์ด์ง€
FROM alpine:latest

# ๋ณด์•ˆ ์—…๋ฐ์ดํŠธ
RUN apk --no-cache add ca-certificates tzdata && \
    apk upgrade --no-cache

# ์ผ๋ฐ˜ ์‚ฌ์šฉ์ž ์ƒ์„ฑ
RUN addgroup -g 1000 appgroup && \
    adduser -D -u 1000 -G appgroup appuser

WORKDIR /home/appuser

# ๋ฐ”์ด๋„ˆ๋ฆฌ ๋ณต์‚ฌ
COPY --from=builder /app/todo-api .

# ๊ถŒํ•œ ์„ค์ •
RUN chown appuser:appgroup todo-api && \
    chmod +x todo-api

# ์ผ๋ฐ˜ ์‚ฌ์šฉ์ž๋กœ ์ „ํ™˜
USER appuser

# ํฌํŠธ ๋…ธ์ถœ
EXPOSE 8080

# ํ—ฌ์Šค์ฒดํฌ
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
    CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1

# ์‹คํ–‰
CMD ["./todo-api"]

์—ฌ๊ธฐ์„œ ์ฃผ๋ชฉํ•  ์ ๋“ค:

๐ŸŽฏ ์ตœ์ ํ™” ํฌ์ธํŠธ: 1. -ldflags="-w -s": ๋””๋ฒ„๊ทธ ์ •๋ณด์™€ ์‹ฌ๋ณผ ํ…Œ์ด๋ธ” ์ œ๊ฑฐ๋กœ ๋ฐ”์ด๋„ˆ๋ฆฌ ํฌ๊ธฐ ๊ฐ์†Œ
2. HEALTHCHECK: ์ปจํ…Œ์ด๋„ˆ ์ƒํƒœ ์ž๋™ ๋ชจ๋‹ˆํ„ฐ๋ง
3. Non-root ์‚ฌ์šฉ์ž: ๋ณด์•ˆ ๊ฐ•ํ™”
4. ํƒ€์ž„์กด ๋ฐ์ดํ„ฐ: ์‹œ๊ฐ„ ๊ด€๋ จ ๊ธฐ๋Šฅ ์ •์ƒ ์ž‘๋™
5. ๋ฉ€ํ‹ฐ ์•„ํ‚คํ…์ฒ˜: GOARCH ๋ช…์‹œ๋กœ ๋‹ค์–‘ํ•œ ํ”Œ๋žซํผ ์ง€์› ๊ฐ€๋Šฅ

๐Ÿš€ ๋นŒ๋“œ ๋ฐ ์‹คํ–‰

# ๋นŒ๋“œ
docker build \
  --build-arg VERSION=1.0.0 \
  --build-arg BUILD_TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ") \
  -t todo-api:1.0.0 \
  .

# ์‹คํ–‰
docker run -d \
  --name todo-api \
  -p 8080:8080 \
  --restart unless-stopped \
  todo-api:1.0.0

# ํ…Œ์ŠคํŠธ
curl http://localhost:8080/health
# ์ถœ๋ ฅ: OK

curl http://localhost:8080/version
# ์ถœ๋ ฅ: {"version":"1.0.0","build_time":"2024-01-15T10:30:00Z"}

# TODO ์ƒ์„ฑ
curl -X POST http://localhost:8080/todos \
  -H "Content-Type: application/json" \
  -d '{"title":"Docker ๊ณต๋ถ€ํ•˜๊ธฐ","completed":false}'

# TODO ๋ชฉ๋ก ์กฐํšŒ
curl http://localhost:8080/todos

์™„๋ฒฝํ•˜๊ฒŒ ์ž‘๋™ํ•˜์ง€? ๐ŸŽ‰ ์ด์ œ ์ด ์ด๋ฏธ์ง€๋ฅผ Docker Hub๋‚˜ ํ”„๋ผ์ด๋น— ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ์— ํ‘ธ์‹œํ•˜๋ฉด ์–ด๋””์„œ๋“  ๋ฐฐํฌํ•  ์ˆ˜ ์žˆ์–ด!

๐Ÿ”„ Docker Compose๋กœ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ๊ตฌ์„ฑ

์‹ค์ œ ๊ฐœ๋ฐœํ•  ๋•Œ๋Š” ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค๋‚˜ Redis ๊ฐ™์€ ๋‹ค๋ฅธ ์„œ๋น„์Šค๋“ค๊ณผ ํ•จ๊ป˜ ์‚ฌ์šฉํ•˜๋Š” ๊ฒฝ์šฐ๊ฐ€ ๋งŽ์ž–์•„? Docker Compose๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ์—ฌ๋Ÿฌ ์ปจํ…Œ์ด๋„ˆ๋ฅผ ํ•œ ๋ฒˆ์— ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด! ๐ŸŽญ

๐Ÿ“ docker-compose.yml ์ž‘์„ฑ

version: '3.8'

services:
  # Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜
  app:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        VERSION: ${VERSION:-dev}
        BUILD_TIME: ${BUILD_TIME:-unknown}
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_USER=todouser
      - DB_PASSWORD=todopass
      - DB_NAME=tododb
      - REDIS_HOST=redis
      - REDIS_PORT=6379
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_started
    networks:
      - app-network
    restart: unless-stopped

  # PostgreSQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค
  postgres:
    image: postgres:15-alpine
    environment:
      - POSTGRES_USER=todouser
      - POSTGRES_PASSWORD=todopass
      - POSTGRES_DB=tododb
    volumes:
      - postgres-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U todouser"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - app-network

  # Redis ์บ์‹œ
  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data
    networks:
      - app-network
    command: redis-server --appendonly yes

volumes:
  postgres-data:
  redis-data:

networks:
  app-network:
    driver: bridge

์ด์ œ ํ•œ ๋ฒˆ์— ๋ชจ๋“  ์„œ๋น„์Šค๋ฅผ ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ์–ด:

# ๋ชจ๋“  ์„œ๋น„์Šค ์‹œ์ž‘
docker-compose up -d

# ๋กœ๊ทธ ํ™•์ธ
docker-compose logs -f app

# ํŠน์ • ์„œ๋น„์Šค๋งŒ ์žฌ์‹œ์ž‘
docker-compose restart app

# ๋ชจ๋“  ์„œ๋น„์Šค ์ค‘์ง€ ๋ฐ ์‚ญ์ œ
docker-compose down

# ๋ณผ๋ฅจ๊นŒ์ง€ ์‚ญ์ œ
docker-compose down -v

๊ฐœ๋ฐœํ•  ๋•Œ ์ •๋ง ํŽธํ•˜์ง€? ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์„ค์น˜ํ•˜๊ณ  ์„ค์ •ํ•˜๊ณ  ๊ทธ๋Ÿด ํ•„์š” ์—†์ด docker-compose up ํ•œ ๋ฒˆ์ด๋ฉด ๋! ๐Ÿ˜Š

๐Ÿ”ง ๊ฐœ๋ฐœ ๋ชจ๋“œ์™€ ํ”„๋กœ๋•์…˜ ๋ชจ๋“œ ๋ถ„๋ฆฌ

๊ฐœ๋ฐœํ•  ๋•Œ์™€ ๋ฐฐํฌํ•  ๋•Œ ์„ค์ •์ด ๋‹ค๋ฅผ ์ˆ˜ ์žˆ์ž–์•„? ๊ทธ๋Ÿด ๋•Œ๋Š” ํŒŒ์ผ์„ ๋ถ„๋ฆฌํ•ด:

# docker-compose.dev.yml (๊ฐœ๋ฐœ์šฉ)
version: '3.8'

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile.dev  # ๊ฐœ๋ฐœ์šฉ Dockerfile
    volumes:
      - .:/app  # ์†Œ์Šค ์ฝ”๋“œ ๋งˆ์šดํŠธ (ํ•ซ ๋ฆฌ๋กœ๋“œ)
    environment:
      - GO_ENV=development
      - DEBUG=true
    ports:
      - "8080:8080"
      - "2345:2345"  # ๋””๋ฒ„๊ฑฐ ํฌํŠธ
# docker-compose.prod.yml (ํ”„๋กœ๋•์…˜์šฉ)
version: '3.8'

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        VERSION: ${VERSION}
        BUILD_TIME: ${BUILD_TIME}
    environment:
      - GO_ENV=production
      - DEBUG=false
    deploy:
      replicas: 3  # 3๊ฐœ ์ธ์Šคํ„ด์Šค ์‹คํ–‰
      resources:
        limits:
          cpus: '0.5'
          memory: 512M
        reservations:
          cpus: '0.25'
          memory: 256M

์‚ฌ์šฉํ•  ๋•Œ:

# ๊ฐœ๋ฐœ ํ™˜๊ฒฝ
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up

# ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ํ™˜๊ฒฝ๋ณ„๋กœ ๊น”๋”ํ•˜๊ฒŒ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด! ๐ŸŽฏ

๐Ÿ“Š ์„ฑ๋Šฅ ๋ชจ๋‹ˆํ„ฐ๋ง๊ณผ ์ตœ์ ํ™”

์ปจํ…Œ์ด๋„ˆ๋ฅผ ๋ฐฐํฌํ–ˆ๋‹ค๊ณ  ๋์ด ์•„๋‹ˆ์•ผ! ์‹ค์ œ๋กœ ์–ผ๋งˆ๋‚˜ ๋ฆฌ์†Œ์Šค๋ฅผ ์‚ฌ์šฉํ•˜๋Š”์ง€, ์„ฑ๋Šฅ์€ ์–ด๋–ค์ง€ ๋ชจ๋‹ˆํ„ฐ๋งํ•ด์•ผ ํ•ด. ๐Ÿ”

๐Ÿ“ˆ ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉ๋Ÿ‰ ํ™•์ธ

# ์‹ค์‹œ๊ฐ„ ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉ๋Ÿ‰
docker stats

# ํŠน์ • ์ปจํ…Œ์ด๋„ˆ๋งŒ
docker stats todo-api

# ์ถœ๋ ฅ ์˜ˆ์‹œ:
CONTAINER ID   NAME       CPU %     MEM USAGE / LIMIT     MEM %     NET I/O
abc123def456   todo-api   0.05%     8.5MiB / 512MiB      1.66%     1.2kB / 850B

๋ณด๋‹ค์‹œํ”ผ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ์ •๋ง ์ ๊ฒŒ ๋จน์–ด! 8.5MB๋ฐ–์— ์•ˆ ์จ. Node.js๋‚˜ Java ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ ๋ณดํ†ต ์ˆ˜๋ฐฑ MB๋ฅผ ์“ฐ๋Š”๋ฐ ๋ง์ด์•ผ. ์ด๊ฒŒ Go์˜ ํฐ ์žฅ์ ์ด์ง€! ๐Ÿ’ช

๐ŸŽฏ ๋ฆฌ์†Œ์Šค ์ œํ•œ ์„ค์ •

์ปจํ…Œ์ด๋„ˆ๊ฐ€ ์‹œ์Šคํ…œ ๋ฆฌ์†Œ์Šค๋ฅผ ๋…์ ํ•˜์ง€ ์•Š๋„๋ก ์ œํ•œ์„ ๊ฑธ์–ด์ค˜์•ผ ํ•ด:

# CPU์™€ ๋ฉ”๋ชจ๋ฆฌ ์ œํ•œ
docker run -d \
  --name todo-api \
  --cpus="0.5" \
  --memory="256m" \
  --memory-swap="512m" \
  -p 8080:8080 \
  todo-api:1.0.0

# ๋˜๋Š” docker-compose.yml์—์„œ
services:
  app:
    deploy:
      resources:
        limits:
          cpus: '0.5'
          memory: 256M
        reservations:
          cpus: '0.25'
          memory: 128M
๐Ÿ’ก ๋ฆฌ์†Œ์Šค ์ œํ•œ ๊ฐ€์ด๋“œ: ๊ฐœ๋ฐœ ํ™˜๊ฒฝ:
- CPU: 0.5~1 ์ฝ”์–ด
- Memory: 256MB~512MB

ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ (ํŠธ๋ž˜ํ”ฝ์— ๋”ฐ๋ผ):
- ๋‚ฎ์€ ํŠธ๋ž˜ํ”ฝ: CPU 0.5 ์ฝ”์–ด, Memory 256MB
- ์ค‘๊ฐ„ ํŠธ๋ž˜ํ”ฝ: CPU 1 ์ฝ”์–ด, Memory 512MB
- ๋†’์€ ํŠธ๋ž˜ํ”ฝ: CPU 2+ ์ฝ”์–ด, Memory 1GB+

Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ ํšจ์œจ์ ์ด๋ผ์„œ ์ƒ๊ฐ๋ณด๋‹ค ์ ์€ ๋ฆฌ์†Œ์Šค๋กœ๋„ ์ถฉ๋ถ„ํ•ด!

๐Ÿ”ฅ ํ”„๋กœํŒŒ์ผ๋ง์œผ๋กœ ๋ณ‘๋ชฉ ์ง€์  ์ฐพ๊ธฐ

Go๋Š” ๋‚ด์žฅ ํ”„๋กœํŒŒ์ผ๋ง ๋„๊ตฌ๊ฐ€ ์ •๋ง ํ›Œ๋ฅญํ•ด! ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์— ๊ฐ„๋‹จํžˆ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์–ด:

package main

import (
    "log"
    "net/http"
    _ "net/http/pprof"  // ํ”„๋กœํŒŒ์ผ๋ง ์—”๋“œํฌ์ธํŠธ ์ž๋™ ๋“ฑ๋ก
)

func main() {
    // ํ”„๋กœํŒŒ์ผ๋ง ์„œ๋ฒ„ (๊ฐœ๋ฐœ/์Šคํ…Œ์ด์ง• ํ™˜๊ฒฝ์—์„œ๋งŒ!)
    go func() {
        log.Println("Profiling server on :6060")
        log.Println(http.ListenAndServe(":6060", nil))
    }()
    
    // ๋ฉ”์ธ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜...
    http.HandleFunc("/", handler)
    log.Fatal(http.ListenAndServe(":8080", nil))
}

์ด์ œ ํ”„๋กœํŒŒ์ผ๋ง ๋ฐ์ดํ„ฐ๋ฅผ ์ˆ˜์ง‘ํ•  ์ˆ˜ ์žˆ์–ด:

# CPU ํ”„๋กœํŒŒ์ผ (30์ดˆ๊ฐ„ ์ˆ˜์ง‘)
curl http://localhost:6060/debug/pprof/profile?seconds=30 > cpu.prof

# ๋ฉ”๋ชจ๋ฆฌ ํ”„๋กœํŒŒ์ผ
curl http://localhost:6060/debug/pprof/heap > mem.prof

# ๊ณ ๋ฃจํ‹ด ์ƒํƒœ
curl http://localhost:6060/debug/pprof/goroutine > goroutine.prof

# ๋ถ„์„
go tool pprof cpu.prof
# (pprof) top10  # ์ƒ์œ„ 10๊ฐœ ํ•จ์ˆ˜
# (pprof) web    # ๋ธŒ๋ผ์šฐ์ €์—์„œ ์‹œ๊ฐํ™”

์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ์–ด๋А ํ•จ์ˆ˜๊ฐ€ CPU๋ฅผ ๋งŽ์ด ์“ฐ๋Š”์ง€, ๋ฉ”๋ชจ๋ฆฌ ๋ˆ„์ˆ˜๋Š” ์—†๋Š”์ง€ ์ •ํ™•ํžˆ ์•Œ ์ˆ˜ ์žˆ์–ด! ๐ŸŽฏ

โš ๏ธ ๋ณด์•ˆ ์ฃผ์˜: ํ”„๋กœํŒŒ์ผ๋ง ์—”๋“œํฌ์ธํŠธ๋Š” ๋ฏผ๊ฐํ•œ ์ •๋ณด๋ฅผ ๋…ธ์ถœํ•  ์ˆ˜ ์žˆ์–ด. ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” ๋ฐ˜๋“œ์‹œ ๋น„ํ™œ์„ฑํ™”ํ•˜๊ฑฐ๋‚˜ ์ธ์ฆ์„ ์ถ”๊ฐ€ํ•ด์•ผ ํ•ด!

๐Ÿš€ CI/CD ํŒŒ์ดํ”„๋ผ์ธ ๊ตฌ์ถ•

์ด์ œ ์ž๋™ํ™”๋œ ๋นŒ๋“œ์™€ ๋ฐฐํฌ ํŒŒ์ดํ”„๋ผ์ธ์„ ๋งŒ๋“ค์–ด๋ณด์ž! GitHub Actions๋ฅผ ์˜ˆ๋กœ ๋“ค์–ด๋ณผ๊ฒŒ. ๐Ÿ˜Ž

๐Ÿ”ง GitHub Actions ์›Œํฌํ”Œ๋กœ์šฐ

.github/workflows/docker-build.yml ํŒŒ์ผ์„ ๋งŒ๋“ค์–ด:

name: Docker Build and Push

on:
  push:
    branches: [ main, develop ]
    tags: [ 'v*' ]
  pull_request:
    branches: [ main ]

env:
  REGISTRY: ghcr.io
  IMAGE_NAME: ${{ github.repository }}

jobs:
  build:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      packages: write

    steps:
      - name: Checkout ์ฝ”๋“œ
        uses: actions/checkout@v3

      - name: Docker ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ์„ค์ •
        id: meta
        uses: docker/metadata-action@v4
        with:
          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
          tags: |
            type=ref,event=branch
            type=ref,event=pr
            type=semver,pattern={{version}}
            type=semver,pattern={{major}}.{{minor}}
            type=sha

      - name: Docker Buildx ์„ค์ •
        uses: docker/setup-buildx-action@v2

      - name: ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ ๋กœ๊ทธ์ธ
        uses: docker/login-action@v2
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: ๋นŒ๋“œ ๋ฐ ํ‘ธ์‹œ
        uses: docker/build-push-action@v4
        with:
          context: .
          push: ${{ github.event_name != 'pull_request' }}
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}
          build-args: |
            VERSION=${{ steps.meta.outputs.version }}
            BUILD_TIME=${{ github.event.head_commit.timestamp }}
            GIT_COMMIT=${{ github.sha }}
          cache-from: type=gha
          cache-to: type=gha,mode=max

      - name: ์ด๋ฏธ์ง€ ์Šค์บ”
        uses: aquasecurity/trivy-action@master
        with:
          image-ref: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ steps.meta.outputs.version }}
          format: 'sarif'
          output: 'trivy-results.sarif'

      - name: ์Šค์บ” ๊ฒฐ๊ณผ ์—…๋กœ๋“œ
        uses: github/codeql-action/upload-sarif@v2
        with:
          sarif_file: 'trivy-results.sarif'

์ด ์›Œํฌํ”Œ๋กœ์šฐ๋Š”:

๐ŸŽฏ ์ž๋™ํ™” ๊ธฐ๋Šฅ: 1. ์ฝ”๋“œ ํ‘ธ์‹œ ์‹œ ์ž๋™ ๋นŒ๋“œ: main์ด๋‚˜ develop ๋ธŒ๋žœ์น˜์— ํ‘ธ์‹œํ•˜๋ฉด ์ž๋™์œผ๋กœ ๋นŒ๋“œ
2. ํƒœ๊ทธ ๊ธฐ๋ฐ˜ ๋ฒ„์ „ ๊ด€๋ฆฌ: v1.0.0 ๊ฐ™์€ ํƒœ๊ทธ๋ฅผ ๋‹ฌ๋ฉด ํ•ด๋‹น ๋ฒ„์ „์œผ๋กœ ์ด๋ฏธ์ง€ ์ƒ์„ฑ
3. ์บ์‹œ ํ™œ์šฉ: GitHub Actions ์บ์‹œ๋กœ ๋นŒ๋“œ ์†๋„ ํ–ฅ์ƒ
4. ์ž๋™ ๋ณด์•ˆ ์Šค์บ”: Trivy๋กœ ์ทจ์•ฝ์  ์ž๋™ ๊ฒ€์‚ฌ
5. ๋ฉ€ํ‹ฐ ํ”Œ๋žซํผ ์ง€์›: AMD64, ARM64 ๋“ฑ ์—ฌ๋Ÿฌ ์•„ํ‚คํ…์ฒ˜ ๋™์‹œ ๋นŒ๋“œ ๊ฐ€๋Šฅ

๐ŸŒ ๋ฉ€ํ‹ฐ ํ”Œ๋žซํผ ๋นŒ๋“œ

์š”์ฆ˜์€ ARM ๊ธฐ๋ฐ˜ ์„œ๋ฒ„(AWS Graviton, Apple Silicon ๋“ฑ)๋„ ๋งŽ์ด ์“ฐ์ž–์•„? ๋ฉ€ํ‹ฐ ํ”Œ๋žซํผ ์ด๋ฏธ์ง€๋ฅผ ๋งŒ๋“ค๋ฉด ์–ด๋””์„œ๋“  ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ์–ด:

# ๋กœ์ปฌ์—์„œ ๋ฉ€ํ‹ฐ ํ”Œ๋žซํผ ๋นŒ๋“œ
docker buildx create --name multiplatform --use
docker buildx inspect --bootstrap

# AMD64์™€ ARM64 ๋™์‹œ ๋นŒ๋“œ
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t myapp:latest \
  --push \
  .

GitHub Actions์—์„œ๋Š”:

- name: ๋นŒ๋“œ ๋ฐ ํ‘ธ์‹œ (๋ฉ€ํ‹ฐ ํ”Œ๋žซํผ)
  uses: docker/build-push-action@v4
  with:
    context: .
    platforms: linux/amd64,linux/arm64
    push: true
    tags: ${{ steps.meta.outputs.tags }}

์ด๋ ‡๊ฒŒ ํ•˜๋ฉด Intel ์„œ๋ฒ„๋“  ARM ์„œ๋ฒ„๋“  ์ƒ๊ด€์—†์ด ๊ฐ™์€ ์ด๋ฏธ์ง€๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์–ด! ๐ŸŒ

๐ŸŽ“ ์‹ค์ „ ํŒ๊ณผ ๋ฒ ์ŠคํŠธ ํ”„๋ž™ํ‹ฐ์Šค

์ง€๊ธˆ๊นŒ์ง€ ๋ฐฐ์šด ๋‚ด์šฉ์„ ๋ฐ”ํƒ•์œผ๋กœ ์‹ค์ „์—์„œ ์œ ์šฉํ•œ ํŒ๋“ค์„ ์ •๋ฆฌํ•ด๋ณผ๊ฒŒ! ์ด๊ฑด ๋‚ด๊ฐ€ ์‹ค์ œ๋กœ ํ”„๋กœ์ ํŠธํ•˜๋ฉด์„œ ๋ฐฐ์šด ๊ฒƒ๋“ค์ด์•ผ. ๐Ÿ˜Š

โœ… ์ฒดํฌ๋ฆฌ์ŠคํŠธ

ํ•ญ๋ชฉ ์„ค๋ช… ์ค‘์š”๋„
๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ ๋นŒ๋“œ์™€ ๋Ÿฐํƒ€์ž„ ๋ถ„๋ฆฌ๋กœ ์ด๋ฏธ์ง€ ํฌ๊ธฐ ์ตœ์†Œํ™” โญโญโญโญโญ
.dockerignore ๋ถˆํ•„์š”ํ•œ ํŒŒ์ผ ์ œ์™ธ๋กœ ๋นŒ๋“œ ์†๋„ ํ–ฅ์ƒ โญโญโญโญโญ
๋ ˆ์ด์–ด ์บ์‹ฑ ์˜์กด์„ฑ ํŒŒ์ผ ๋จผ์ € ๋ณต์‚ฌํ•˜์—ฌ ์บ์‹œ ํ™œ์šฉ โญโญโญโญโญ
Non-root ์‚ฌ์šฉ์ž ๋ณด์•ˆ ๊ฐ•ํ™”๋ฅผ ์œ„ํ•œ ์ผ๋ฐ˜ ์‚ฌ์šฉ์ž ์‹คํ–‰ โญโญโญโญโญ
ํ—ฌ์Šค์ฒดํฌ ์ปจํ…Œ์ด๋„ˆ ์ƒํƒœ ์ž๋™ ๋ชจ๋‹ˆํ„ฐ๋ง โญโญโญโญ
๋ฒ„์ „ ํƒœ๊น… ๋ช…ํ™•ํ•œ ๋ฒ„์ „ ๊ด€๋ฆฌ์™€ ๋กค๋ฐฑ ๊ฐ€๋Šฅ โญโญโญโญ
๋ฆฌ์†Œ์Šค ์ œํ•œ CPU/๋ฉ”๋ชจ๋ฆฌ ์ œํ•œ์œผ๋กœ ์•ˆ์ •์„ฑ ํ™•๋ณด โญโญโญโญ
๋ณด์•ˆ ์Šค์บ” ์ •๊ธฐ์ ์ธ ์ทจ์•ฝ์  ๊ฒ€์‚ฌ โญโญโญโญ
๋กœ๊น… ์„ค์ • ๊ตฌ์กฐํ™”๋œ ๋กœ๊ทธ๋กœ ๋””๋ฒ„๊น… ์šฉ์ด โญโญโญ
ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ • ์™ธ๋ถ€ํ™”๋กœ ์œ ์—ฐ์„ฑ ํ™•๋ณด โญโญโญ

๐ŸŽฏ ์ด๋ฏธ์ง€ ํƒœ๊น… ์ „๋žต

์ด๋ฏธ์ง€ ํƒœ๊ทธ๋ฅผ ์–ด๋–ป๊ฒŒ ๊ด€๋ฆฌํ•˜๋А๋ƒ๊ฐ€ ์ •๋ง ์ค‘์š”ํ•ด! ๋‚ด๊ฐ€ ์ถ”์ฒœํ•˜๋Š” ์ „๋žต์€:

# ๊ฐœ๋ฐœ ํ™˜๊ฒฝ
myapp:dev
myapp:dev-20240115
myapp:dev-abc123  # Git ์ปค๋ฐ‹ ํ•ด์‹œ

# ์Šคํ…Œ์ด์ง• ํ™˜๊ฒฝ
myapp:staging
myapp:staging-1.2.3-rc1

# ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ
myapp:latest  # ์ตœ์‹  ์•ˆ์ • ๋ฒ„์ „
myapp:1.2.3   # ์ •ํ™•ํ•œ ๋ฒ„์ „
myapp:1.2     # ๋งˆ์ด๋„ˆ ๋ฒ„์ „
myapp:1       # ๋ฉ”์ด์ € ๋ฒ„์ „
myapp:stable  # ์•ˆ์ • ๋ฒ„์ „ ๋ณ„์นญ
๐Ÿ’ก ํƒœ๊น… ๊ทœ์น™: 1. latest๋Š” ์‹ ์ค‘ํ•˜๊ฒŒ: ํ”„๋กœ๋•์…˜์—์„œ๋Š” ์ •ํ™•ํ•œ ๋ฒ„์ „ ํƒœ๊ทธ ์‚ฌ์šฉ
2. ์‹œ๋งจํ‹ฑ ๋ฒ„์ €๋‹: major.minor.patch ํ˜•์‹ ์ค€์ˆ˜
3. Git ์ปค๋ฐ‹ ํ•ด์‹œ ํฌํ•จ: ์ถ”์ ์„ฑ ํ™•๋ณด
4. ํ™˜๊ฒฝ๋ณ„ ํƒœ๊ทธ: dev, staging, prod ๊ตฌ๋ถ„
5. ๋ถˆ๋ณ€์„ฑ: ๊ฐ™์€ ํƒœ๊ทธ๋ฅผ ๋ฎ์–ด์“ฐ์ง€ ๋ง๊ณ  ์ƒˆ ๋ฒ„์ „ ์ƒ์„ฑ

๐Ÿ” ๋””๋ฒ„๊น… ํŒ

์ปจํ…Œ์ด๋„ˆ ์•ˆ์—์„œ ๋ฌธ์ œ๊ฐ€ ์ƒ๊ฒผ์„ ๋•Œ ๋””๋ฒ„๊น…ํ•˜๋Š” ๋ฐฉ๋ฒ•๋“ค:

# ์ปจํ…Œ์ด๋„ˆ ๋กœ๊ทธ ํ™•์ธ
docker logs todo-api
docker logs -f todo-api  # ์‹ค์‹œ๊ฐ„ ๋กœ๊ทธ
docker logs --tail 100 todo-api  # ์ตœ๊ทผ 100์ค„

# ์ปจํ…Œ์ด๋„ˆ ์•ˆ์œผ๋กœ ๋“ค์–ด๊ฐ€๊ธฐ (alpine ๊ธฐ๋ฐ˜)
docker exec -it todo-api sh

# ์ปจํ…Œ์ด๋„ˆ ์•ˆ์œผ๋กœ ๋“ค์–ด๊ฐ€๊ธฐ (scratch ๊ธฐ๋ฐ˜์€ ๋ถˆ๊ฐ€๋Šฅ!)
# ๋Œ€์‹  ๋””๋ฒ„๊ทธ์šฉ ์ด๋ฏธ์ง€ ๋”ฐ๋กœ ๋นŒ๋“œ
FROM alpine:latest AS debug
COPY --from=builder /app/main .
RUN apk add --no-cache bash curl vim
CMD ["sh"]

# ์‹คํ–‰ ์ค‘์ธ ํ”„๋กœ์„ธ์Šค ํ™•์ธ
docker top todo-api

# ์ปจํ…Œ์ด๋„ˆ ์ƒ์„ธ ์ •๋ณด
docker inspect todo-api

# ํŒŒ์ผ ์‹œ์Šคํ…œ ๋ณ€๊ฒฝ ์‚ฌํ•ญ
docker diff todo-api

# ์ปจํ…Œ์ด๋„ˆ์—์„œ ํŒŒ์ผ ๋ณต์‚ฌ
docker cp todo-api:/var/log/app.log ./app.log

๐Ÿ“ ๋กœ๊น… ๋ฒ ์ŠคํŠธ ํ”„๋ž™ํ‹ฐ์Šค

Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์—์„œ ๊ตฌ์กฐํ™”๋œ ๋กœ๊น…์„ ์‚ฌ์šฉํ•˜๋ฉด ๋‚˜์ค‘์— ๋ถ„์„ํ•˜๊ธฐ ํ›จ์”ฌ ์‰ฌ์›Œ:

package main

import (
    "log/slog"
    "os"
)

func main() {
    // JSON ํ˜•์‹ ๋กœ๊ฑฐ ์„ค์ •
    logger := slog.New(slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
        Level: slog.LevelInfo,
    }))
    
    // ๊ธฐ๋ณธ ๋กœ๊ฑฐ๋กœ ์„ค์ •
    slog.SetDefault(logger)
    
    // ๊ตฌ์กฐํ™”๋œ ๋กœ๊น…
    slog.Info("์„œ๋ฒ„ ์‹œ์ž‘",
        "port", 8080,
        "version", "1.0.0",
        "environment", "production",
    )
    
    // ์—๋Ÿฌ ๋กœ๊น…
    if err := doSomething(); err != nil {
        slog.Error("์ž‘์—… ์‹คํŒจ",
            "error", err,
            "operation", "doSomething",
            "user_id", 12345,
        )
    }
}

์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ๋กœ๊ทธ๊ฐ€ JSON ํ˜•์‹์œผ๋กœ ์ถœ๋ ฅ๋˜์–ด์„œ Elasticsearch, Splunk ๊ฐ™์€ ๋กœ๊ทธ ๋ถ„์„ ๋„๊ตฌ๋กœ ์‰ฝ๊ฒŒ ์ˆ˜์ง‘ํ•˜๊ณ  ๋ถ„์„ํ•  ์ˆ˜ ์žˆ์–ด! ๐Ÿ“Š

๐ŸŒŸ ์žฌ๋Šฅ๋„ท์—์„œ Docker ์ „๋ฌธ๊ฐ€ ์ฐพ๊ธฐ

์—ฌ๊ธฐ๊นŒ์ง€ ์ฝ์—ˆ๋‹ค๋ฉด Go์™€ Docker์— ๋Œ€ํ•ด ๊ฝค ๋งŽ์ด ์•Œ๊ฒŒ ๋์„ ๊ฑฐ์•ผ! ํ•˜์ง€๋งŒ ์‹ค์ „ ํ”„๋กœ์ ํŠธ์—์„œ๋Š” ์˜ˆ์ƒ์น˜ ๋ชปํ•œ ๋ฌธ์ œ๋“ค์ด ์ƒ๊ธฐ๊ธฐ ๋งˆ๋ จ์ด์ง€. ๐Ÿค”

ํ˜น์‹œ Docker ์ปจํ…Œ์ด๋„ˆํ™”๋‚˜ Kubernetes ๋ฐฐํฌ, CI/CD ํŒŒ์ดํ”„๋ผ์ธ ๊ตฌ์ถ• ๊ฐ™์€ ๊ฑธ ๋„์™€์ค„ ์ „๋ฌธ๊ฐ€๊ฐ€ ํ•„์š”ํ•˜๋‹ค๋ฉด ์žฌ๋Šฅ๋„ท์„ ํ™œ์šฉํ•ด๋ด! ์žฌ๋Šฅ๋„ท์—๋Š” ์‹ค๋ฌด ๊ฒฝํ—˜์ด ํ’๋ถ€ํ•œ DevOps ์—”์ง€๋‹ˆ์–ด๋“ค์ด ๋งŽ๊ฑฐ๋“ . 1:1 ์ปจ์„คํŒ…๋ถ€ํ„ฐ ํ”„๋กœ์ ํŠธ ์ „์ฒด ๊ตฌ์ถ•๊นŒ์ง€ ๋‹ค์–‘ํ•œ ์„œ๋น„์Šค๋ฅผ ๋ฐ›์„ ์ˆ˜ ์žˆ์–ด. ๐Ÿ’ผ

ํŠนํžˆ ์ดˆ๊ธฐ ์Šคํƒ€ํŠธ์—…์ด๋‚˜ ๊ฐœ์ธ ๊ฐœ๋ฐœ์ž๋“ค์€ ์ธํ”„๋ผ ๊ตฌ์ถ•์— ์‹œ๊ฐ„์„ ๋งŽ์ด ์“ฐ๊ธฐ๋ณด๋‹ค๋Š” ํ•ต์‹ฌ ๋น„์ฆˆ๋‹ˆ์Šค ๋กœ์ง ๊ฐœ๋ฐœ์— ์ง‘์ค‘ํ•˜๋Š” ๊ฒŒ ์ข‹์ž–์•„? ๊ทธ๋Ÿด ๋•Œ ์žฌ๋Šฅ๋„ท์˜ ์ „๋ฌธ๊ฐ€๋“คํ•œํ…Œ ๋„์›€์„ ๋ฐ›์œผ๋ฉด ์‹œ๊ฐ„๊ณผ ๋น„์šฉ์„ ํฌ๊ฒŒ ์ ˆ์•ฝํ•  ์ˆ˜ ์žˆ์–ด! ๐Ÿš€

๐ŸŽฌ ๋งˆ๋ฌด๋ฆฌํ•˜๋ฉฐ

์ž, ์˜ค๋Š˜ ์šฐ๋ฆฌ๊ฐ€ ๋ญ˜ ๋ฐฐ์› ๋Š”์ง€ ์ •๋ฆฌํ•ด๋ณผ๊นŒ? ๐Ÿค“

๐Ÿ“š ํ•ต์‹ฌ ์š”์•ฝ: 1. Go + Docker = ์™„๋ฒฝํ•œ ์กฐํ•ฉ
- ์ •์  ์ปดํŒŒ์ผ๋กœ ์˜์กด์„ฑ ์—†๋Š” ๋‹จ์ผ ๋ฐ”์ด๋„ˆ๋ฆฌ
- ๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ๋กœ 98% ์ด์ƒ ํฌ๊ธฐ ๊ฐ์†Œ
- Alpine์ด๋‚˜ Scratch ๋ฒ ์ด์Šค๋กœ ์ดˆ๊ฒฝ๋Ÿ‰ ์ด๋ฏธ์ง€

2. ์ตœ์ ํ™” ์ „๋žต
- ๋ ˆ์ด์–ด ์บ์‹ฑ์œผ๋กœ ๋นŒ๋“œ ์†๋„ 10๋ฐฐ ํ–ฅ์ƒ
- .dockerignore๋กœ ๋ถˆํ•„์š”ํ•œ ํŒŒ์ผ ์ œ์™ธ
- CGO_ENABLED=0์œผ๋กœ ์ˆœ์ˆ˜ Go ๋ฐ”์ด๋„ˆ๋ฆฌ

3. ๋ณด์•ˆ ๊ฐ•ํ™”
- Non-root ์‚ฌ์šฉ์ž๋กœ ์‹คํ–‰
- ์ •๊ธฐ์ ์ธ ์ทจ์•ฝ์  ์Šค์บ”
- ๋ฏผ๊ฐ ์ •๋ณด๋Š” ํ™˜๊ฒฝ ๋ณ€์ˆ˜๋‚˜ Secrets ์‚ฌ์šฉ

4. ์šด์˜ ์ž๋™ํ™”
- Docker Compose๋กœ ๋กœ์ปฌ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ๊ตฌ์„ฑ
- CI/CD ํŒŒ์ดํ”„๋ผ์ธ์œผ๋กœ ์ž๋™ ๋นŒ๋“œ/๋ฐฐํฌ
- ํ—ฌ์Šค์ฒดํฌ์™€ ๋ชจ๋‹ˆํ„ฐ๋ง์œผ๋กœ ์•ˆ์ •์„ฑ ํ™•๋ณด

์ฒ˜์Œ์—๋Š” ๋ณต์žกํ•ด ๋ณด์ผ ์ˆ˜ ์žˆ์ง€๋งŒ, ํ•œ ๋ฒˆ ์ œ๋Œ€๋กœ ์„ค์ •ํ•ด๋‘๋ฉด ์ •๋ง ํŽธํ•ด! ์ฝ”๋“œ ํ‘ธ์‹œํ•˜๋ฉด ์ž๋™์œผ๋กœ ๋นŒ๋“œ๋˜๊ณ , ํ…Œ์ŠคํŠธ๋˜๊ณ , ๋ฐฐํฌ๋˜๋Š” ๊ฑธ ๋ณด๋ฉด ๋ฟŒ๋“ฏํ•˜๊ฑฐ๋“ . ๐Ÿ˜Š

Go ์–ธ์–ด์˜ ํšจ์œจ์„ฑ๊ณผ Docker์˜ ์ด์‹์„ฑ์„ ๊ฒฐํ•ฉํ•˜๋ฉด ์ •๋ง ๊ฐ•๋ ฅํ•œ ์‹œ์Šคํ…œ์„ ๋งŒ๋“ค ์ˆ˜ ์žˆ์–ด. ํŠนํžˆ ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ์•„ํ‚คํ…์ฒ˜๋‚˜ ํด๋ผ์šฐ๋“œ ๋„ค์ดํ‹ฐ๋ธŒ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๊ฐœ๋ฐœํ•  ๋•Œ๋Š” ํ•„์ˆ˜์ ์ธ ๊ธฐ์ˆ ์ด์ง€!

์ด ๊ธ€์ด ๋„์›€์ด ๋๊ธฐ๋ฅผ ๋ฐ”๋ผ! ๊ถ๊ธˆํ•œ ์ ์ด ์žˆ๊ฑฐ๋‚˜ ๋” ๊นŠ์ด ์žˆ๋Š” ๋‚ด์šฉ์ด ํ•„์š”ํ•˜๋ฉด ์žฌ๋Šฅ๋„ท์—์„œ ์ „๋ฌธ๊ฐ€๋“ค๊ณผ ์ƒ๋‹ดํ•ด๋ณด๋Š” ๊ฒƒ๋„ ์ข‹์€ ๋ฐฉ๋ฒ•์ด์•ผ. ์‹ค์ „ ๊ฒฝํ—˜์ด ํ’๋ถ€ํ•œ ์‚ฌ๋žŒ๋“คํ•œํ…Œ ๋ฐฐ์šฐ๋ฉด ํ›จ์”ฌ ๋น ๋ฅด๊ฒŒ ์„ฑ์žฅํ•  ์ˆ˜ ์žˆ๊ฑฐ๋“ ! ๐ŸŒฑ

์ž, ์ด์ œ ์ง์ ‘ ํ•ด๋ณด์ž! ๊ฐ„๋‹จํ•œ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๋งŒ๋“ค๊ณ  Docker๋กœ ์ปจํ…Œ์ด๋„ˆํ™”ํ•ด๋ด. ์ฒ˜์Œ์—๋Š” ๊ธฐ๋ณธ Dockerfile๋กœ ์‹œ์ž‘ํ•ด์„œ ์ ์  ์ตœ์ ํ™”ํ•ด๋‚˜๊ฐ€๋ฉด์„œ ์ด๋ฏธ์ง€ ํฌ๊ธฐ๊ฐ€ ์ค„์–ด๋“œ๋Š” ๊ฑธ ํ™•์ธํ•ด๋ด. ์ •๋ง ์žฌ๋ฏธ์žˆ์„ ๊ฑฐ์•ผ! ๐ŸŽ‰

Happy Coding! ๊ทธ๋ฆฌ๊ณ  Happy Dockerizing! ๐Ÿณโœจ

๋Œ“๊ธ€ ์ž‘์„ฑ

์ด ๊ธ€์— ๋Œ€ํ•œ ์—ฌ๋Ÿฌ๋ถ„์˜ ์ƒ๊ฐ์„ ๋“ค๋ ค์ฃผ์„ธ์š”

๋Œ“๊ธ€ 0
๋Œ“๊ธ€์„ ๋ถˆ๋Ÿฌ์˜ค๋Š” ์ค‘์ž…๋‹ˆ๋‹ค.

์•„์ง ๋Œ“๊ธ€์ด ์—†์Šต๋‹ˆ๋‹ค.