์ฝ˜ํ…์ธ  ๋Œ€ํ‘œ ์ด๋ฏธ์ง€ - ๐Ÿน Go ์–ธ์–ด ๊ฐœ๋ฐœ์„ ์œ„ํ•œ Docker ํ™˜๊ฒฝ ์„ค์ • ์™„๋ฒฝ ๊ฐ€์ด๋“œ: ์ดˆ๋ณด์ž๋„ ์‰ฝ๊ฒŒ ๋”ฐ๋ผํ•˜๋Š” ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ๊ตฌ์ถ•ํ•˜๊ธฐ

๐Ÿน Go ์–ธ์–ด ๊ฐœ๋ฐœ์„ ์œ„ํ•œ Docker ํ™˜๊ฒฝ ์„ค์ • ์™„๋ฒฝ ๊ฐ€์ด๋“œ: ์ดˆ๋ณด์ž๋„ ์‰ฝ๊ฒŒ ๋”ฐ๋ผํ•˜๋Š” ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ๊ตฌ์ถ•ํ•˜๊ธฐ

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

๐Ÿ“š ๋ชฉ์ฐจ

  1. Go ์–ธ์–ด์™€ Docker์˜ ๋งŒ๋‚จ: ์™œ ํ•จ๊ป˜ ์‚ฌ์šฉํ•ด์•ผ ํ• ๊นŒ?
  2. Docker ๊ธฐ์ดˆ ์ดํ•ดํ•˜๊ธฐ
  3. Go ๊ฐœ๋ฐœ์„ ์œ„ํ•œ Docker ํ™˜๊ฒฝ ์„ค์ •ํ•˜๊ธฐ
  4. Dockerfile ์ž‘์„ฑํ•˜๊ธฐ
  5. Docker Compose๋กœ ๋‹ค์ค‘ ์„œ๋น„์Šค ๊ตฌ์„ฑํ•˜๊ธฐ
  6. ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ ์ตœ์ ํ™”ํ•˜๊ธฐ
  7. ์‹ค์ „ ํ”„๋กœ์ ํŠธ: Go + Docker ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋งŒ๋“ค๊ธฐ
  8. ๋ฌธ์ œ ํ•ด๊ฒฐ๊ณผ ๋””๋ฒ„๊น… ํŒ
  9. ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์œผ๋กœ ๋ฐฐํฌํ•˜๊ธฐ
  10. ๋งˆ๋ฌด๋ฆฌ ๋ฐ ์ถ”๊ฐ€ ์ž๋ฃŒ

1. Go ์–ธ์–ด์™€ Docker์˜ ๋งŒ๋‚จ: ์™œ ํ•จ๊ป˜ ์‚ฌ์šฉํ•ด์•ผ ํ• ๊นŒ? ๐Ÿค

Go ์–ธ์–ด(๋˜๋Š” Golang)๋Š” 2009๋…„ Google์—์„œ ๊ฐœ๋ฐœํ•œ ํ”„๋กœ๊ทธ๋ž˜๋ฐ ์–ธ์–ด๋กœ, 2025๋…„ ํ˜„์žฌ ํด๋ผ์šฐ๋“œ ์ธํ”„๋ผ, ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค, ์›น ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๊ฐœ๋ฐœ์—์„œ ์—„์ฒญ๋‚œ ์ธ๊ธฐ๋ฅผ ๋Œ๊ณ  ์žˆ์–ด. Go์˜ ๊ฐ„๊ฒฐํ•จ, ๋™์‹œ์„ฑ ์ฒ˜๋ฆฌ ๋Šฅ๋ ฅ, ๋น ๋ฅธ ์ปดํŒŒ์ผ ์†๋„๋Š” ํ˜„๋Œ€ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๊ฐœ๋ฐœ์— ๋”ฑ ๋งž๋Š” ํŠน์„ฑ์ด์ง€!

ํ•œํŽธ, Docker๋Š” ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์ปจํ…Œ์ด๋„ˆํ™”ํ•˜์—ฌ ์–ด๋””์„œ๋“  ์ผ๊ด€๋˜๊ฒŒ ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ฃผ๋Š” ํ”Œ๋žซํผ์ด์•ผ. ์ด ๋‘ ๊ธฐ์ˆ ์˜ ์กฐํ•ฉ์ด ์™œ ๊ฐ•๋ ฅํ•œ์ง€ ์•Œ์•„๋ณผ๊นŒ?

๐ŸŒŸ Go + Docker์˜ ์ฃผ์š” ์ด์ 

  1. ํ™˜๊ฒฝ ์ผ๊ด€์„ฑ: "๋‚ด ์ปดํ“จํ„ฐ์—์„œ๋Š” ์ž˜ ๋Œ์•„๊ฐ€๋Š”๋ฐ..." ๋ผ๋Š” ๋ง์€ ์ด์ œ ์˜›๋ง! Docker๋กœ ๋ชจ๋“  ๊ฐœ๋ฐœ์ž๊ฐ€ ๋™์ผํ•œ ํ™˜๊ฒฝ์—์„œ ์ž‘์—…ํ•  ์ˆ˜ ์žˆ์–ด.
  2. ๋ฐฐํฌ ๊ฐ„์†Œํ™”: Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์ปจํ…Œ์ด๋„ˆํ™”ํ•˜๋ฉด ์–ด๋–ค ํ™˜๊ฒฝ์—์„œ๋“  ์‰ฝ๊ฒŒ ๋ฐฐํฌํ•  ์ˆ˜ ์žˆ์–ด.
  3. ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ์•„ํ‚คํ…์ฒ˜ ์ง€์›: Go์˜ ๊ฐ€๋ฒผ์›€๊ณผ Docker์˜ ์ปจํ…Œ์ด๋„ˆํ™”๋Š” ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ๊ตฌํ˜„์— ์™„๋ฒฝํ•œ ์กฐํ•ฉ์ด์•ผ.
  4. ๊ฐœ๋ฐœ-ํ…Œ์ŠคํŠธ-๋ฐฐํฌ ํŒŒ์ดํ”„๋ผ์ธ ๊ฐ„์†Œํ™”: CI/CD ํŒŒ์ดํ”„๋ผ์ธ์— ์‰ฝ๊ฒŒ ํ†ตํ•ฉํ•  ์ˆ˜ ์žˆ์–ด.
  5. ๋ฆฌ์†Œ์Šค ํšจ์œจ์„ฑ: Go์˜ ๋‚ฎ์€ ๋ฉ”๋ชจ๋ฆฌ ์‚ฌ์šฉ๋Ÿ‰๊ณผ Docker์˜ ๊ฒฝ๋Ÿ‰ ์ปจํ…Œ์ด๋„ˆ๋Š” ๋ฆฌ์†Œ์Šค๋ฅผ ํšจ์œจ์ ์œผ๋กœ ์‚ฌ์šฉํ•ด.
Go Docker ์ผ๊ด€์„ฑ ํ™•์žฅ์„ฑ ํšจ์œจ์„ฑ Go + Docker: ์™„๋ฒฝํ•œ ์กฐํ•ฉ

์žฌ๋Šฅ๋„ท์—์„œ Go ์–ธ์–ด ๊ฐœ๋ฐœ ์žฌ๋Šฅ์„ ๊ณต์œ ํ•˜๊ณ  ์žˆ๋‹ค๋ฉด, Docker ํ™˜๊ฒฝ ์„ค์ • ๋ฐฉ๋ฒ•์„ ์•Œ์•„๋‘๋Š” ๊ฑด ์ •๋ง ์ค‘์š”ํ•ด. ํด๋ผ์ด์–ธํŠธ์—๊ฒŒ ๋” ์ „๋ฌธ์ ์ธ ์„œ๋น„์Šค๋ฅผ ์ œ๊ณตํ•  ์ˆ˜ ์žˆ๊ณ , ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์„ค์ •์— ๋Œ€ํ•œ ๊ณ ๋ฏผ ์—†์ด ํ•ต์‹ฌ ์ฝ”๋”ฉ์— ์ง‘์ค‘ํ•  ์ˆ˜ ์žˆ๊ฑฐ๋“ !

2. Docker ๊ธฐ์ดˆ ์ดํ•ดํ•˜๊ธฐ ๐Ÿณ

Docker๋ฅผ ์ฒ˜์Œ ์ ‘ํ•˜๋Š” ์นœ๊ตฌ๋“ค์„ ์œ„ํ•ด ๊ฐ„๋‹จํžˆ ์„ค๋ช…ํ•ด๋ณผ๊ฒŒ. Docker๋Š” ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜๊ณผ ๊ทธ ์˜์กด์„ฑ์„ ํ•จ๊ป˜ ํŒจํ‚ค์ง•ํ•˜์—ฌ ์–ด๋””์„œ๋“  ์ผ๊ด€๋˜๊ฒŒ ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ฃผ๋Š” ํ”Œ๋žซํผ์ด์•ผ. 2025๋…„ ํ˜„์žฌ, Docker๋Š” ๋ฒ„์ „ 27.x๊นŒ์ง€ ์ถœ์‹œ๋˜์—ˆ๊ณ  ๋”์šฑ ๊ฐ•๋ ฅํ•œ ๊ธฐ๋Šฅ๋“ค์ด ์ถ”๊ฐ€๋˜์—ˆ์–ด!

๐Ÿ” Docker์˜ ํ•ต์‹ฌ ๊ฐœ๋…

1. ์ปจํ…Œ์ด๋„ˆ (Container)

์ปจํ…Œ์ด๋„ˆ๋Š” ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜๊ณผ ๊ทธ ์˜์กด์„ฑ์„ ํฌํ•จํ•˜๋Š” ๋…๋ฆฝ์ ์ธ ์‹คํ–‰ ํ™˜๊ฒฝ์ด์•ผ. ๊ฐ€์ƒ ๋จธ์‹ ๊ณผ ๋‹ฌ๋ฆฌ ํ˜ธ์ŠคํŠธ OS์˜ ์ปค๋„์„ ๊ณต์œ ํ•˜๋ฉด์„œ๋„ ๊ฒฉ๋ฆฌ๋œ ํ™˜๊ฒฝ์„ ์ œ๊ณตํ•ด. ๊ทธ๋ž˜์„œ ๊ฐ€๋ณ๊ณ  ๋น ๋ฅด๊ฒŒ ์‹œ์ž‘ํ•  ์ˆ˜ ์žˆ์ง€!

2. ์ด๋ฏธ์ง€ (Image)

์ด๋ฏธ์ง€๋Š” ์ปจํ…Œ์ด๋„ˆ๋ฅผ ์ƒ์„ฑํ•˜๊ธฐ ์œ„ํ•œ ํ…œํ”Œ๋ฆฟ์ด์•ผ. ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ฝ”๋“œ, ๋Ÿฐํƒ€์ž„, ์‹œ์Šคํ…œ ๋„๊ตฌ, ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๋“ฑ์„ ํฌํ•จํ•˜๊ณ  ์žˆ์–ด. Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์œ„ํ•œ ์ด๋ฏธ์ง€๋Š” Go ๋Ÿฐํƒ€์ž„๊ณผ ์šฐ๋ฆฌ์˜ ์ฝ”๋“œ๋ฅผ ํฌํ•จํ•˜๊ฒŒ ๋  ๊ฑฐ์•ผ.

3. Dockerfile

Dockerfile์€ Docker ์ด๋ฏธ์ง€๋ฅผ ๋งŒ๋“ค๊ธฐ ์œ„ํ•œ ์Šคํฌ๋ฆฝํŠธ์•ผ. ์–ด๋–ค ๋ฒ ์ด์Šค ์ด๋ฏธ์ง€๋ฅผ ์‚ฌ์šฉํ• ์ง€, ์–ด๋–ค ๋ช…๋ น์„ ์‹คํ–‰ํ• ์ง€, ์–ด๋–ค ํŒŒ์ผ์„ ๋ณต์‚ฌํ• ์ง€ ๋“ฑ์„ ์ •์˜ํ•ด.

4. Docker Compose

์—ฌ๋Ÿฌ ์ปจํ…Œ์ด๋„ˆ๋กœ ๊ตฌ์„ฑ๋œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์ •์˜ํ•˜๊ณ  ์‹คํ–‰ํ•˜๊ธฐ ์œ„ํ•œ ๋„๊ตฌ์•ผ. ์˜ˆ๋ฅผ ๋“ค์–ด, Go ์›น ์„œ๋ฒ„์™€ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค๋ฅผ ํ•จ๊ป˜ ์‹คํ–‰ํ•  ๋•Œ ์œ ์šฉํ•˜์ง€!

โŒจ๏ธ ์•Œ์•„๋‘๋ฉด ์œ ์šฉํ•œ Docker ๋ช…๋ น์–ด

// ์ด๋ฏธ์ง€ ๋นŒ๋“œํ•˜๊ธฐ
docker build -t my-go-app .

// ์ปจํ…Œ์ด๋„ˆ ์‹คํ–‰ํ•˜๊ธฐ
docker run -p 8080:8080 my-go-app

// ์‹คํ–‰ ์ค‘์ธ ์ปจํ…Œ์ด๋„ˆ ๋ชฉ๋ก ๋ณด๊ธฐ
docker ps

// ์ปจํ…Œ์ด๋„ˆ ์ค‘์ง€ํ•˜๊ธฐ
docker stop [container_id]

// ์ปจํ…Œ์ด๋„ˆ ๋กœ๊ทธ ๋ณด๊ธฐ
docker logs [container_id]

// Docker Compose๋กœ ์—ฌ๋Ÿฌ ์„œ๋น„์Šค ์‹คํ–‰ํ•˜๊ธฐ
docker-compose up

2025๋…„ ๊ธฐ์ค€์œผ๋กœ Docker Desktop์€ ๋”์šฑ ์‚ฌ์šฉ์ž ์นœํ™”์ ์ธ ์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ์ œ๊ณตํ•˜๊ณ  ์žˆ์–ด. ๋ช…๋ น์–ด๋ฅผ ์™ธ์šฐ๊ธฐ ์–ด๋ ต๋‹ค๋ฉด GUI๋กœ ์‰ฝ๊ฒŒ ๊ด€๋ฆฌํ•  ์ˆ˜๋„ ์žˆ์ง€! ํ•˜์ง€๋งŒ ํ„ฐ๋ฏธ๋„ ๋ช…๋ น์–ด์— ์ต์ˆ™ํ•ด์ง€๋ฉด ๋” ํšจ์œจ์ ์œผ๋กœ ์ž‘์—…ํ•  ์ˆ˜ ์žˆ์œผ๋‹ˆ ์กฐ๊ธˆ์”ฉ ๋ฐฐ์›Œ๋ณด๋Š” ๊ฑธ ์ถ”์ฒœํ•ด.

Docker ์•„ํ‚คํ…์ฒ˜ ์ดํ•ดํ•˜๊ธฐ ํ˜ธ์ŠคํŠธ ์šด์˜์ฒด์ œ (Linux, Windows, macOS) Docker ์—”์ง„ Go ์›น ์„œ๋ฒ„ ์ปจํ…Œ์ด๋„ˆ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ปจํ…Œ์ด๋„ˆ ์บ์‹œ ์„œ๋ฒ„ ์ปจํ…Œ์ด๋„ˆ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ Docker ์—”์ง„

์ด์ œ Docker์˜ ๊ธฐ๋ณธ ๊ฐœ๋…์„ ์ดํ•ดํ–ˆ์œผ๋‹ˆ, Go ์–ธ์–ด ๊ฐœ๋ฐœ์„ ์œ„ํ•œ Docker ํ™˜๊ฒฝ์„ ์–ด๋–ป๊ฒŒ ์„ค์ •ํ•˜๋Š”์ง€ ์•Œ์•„๋ณผ๊นŒ?

3. Go ๊ฐœ๋ฐœ์„ ์œ„ํ•œ Docker ํ™˜๊ฒฝ ์„ค์ •ํ•˜๊ธฐ ๐Ÿ› ๏ธ

์ž, ์ด์ œ ๋ณธ๊ฒฉ์ ์œผ๋กœ Go ๊ฐœ๋ฐœ์„ ์œ„ํ•œ Docker ํ™˜๊ฒฝ์„ ์„ค์ •ํ•ด๋ณด์ž! 2025๋…„ ํ˜„์žฌ Go 1.22.x ๋ฒ„์ „์ด ์•ˆ์ •์ ์œผ๋กœ ์‚ฌ์šฉ๋˜๊ณ  ์žˆ์–ด. ์šฐ๋ฆฌ๋Š” ์ด ์ตœ์‹  ๋ฒ„์ „์„ Docker ํ™˜๊ฒฝ์—์„œ ์‚ฌ์šฉํ•  ๊ฑฐ์•ผ.

๐Ÿ”ง ์ค€๋น„๋ฌผ

  1. Docker Desktop ์„ค์น˜ (Windows, macOS) ๋˜๋Š” Docker Engine (Linux)
  2. ์ฝ”๋“œ ์—๋””ํ„ฐ (VS Code ์ถ”์ฒœ)
  3. ํ„ฐ๋ฏธ๋„ ํ”„๋กœ๊ทธ๋žจ
  4. ์ธํ„ฐ๋„ท ์—ฐ๊ฒฐ

Docker ์„ค์น˜ํ•˜๊ธฐ

๋จผ์ € Docker๋ฅผ ์„ค์น˜ํ•ด์•ผ ํ•ด. ์šด์˜์ฒด์ œ๋ณ„ ์„ค์น˜ ๋ฐฉ๋ฒ•์„ ๊ฐ„๋‹จํžˆ ์•Œ์•„๋ณด์ž:

Windows์— Docker ์„ค์น˜ํ•˜๊ธฐ

  1. Docker Desktop for Windows๋ฅผ ๋‹ค์šด๋กœ๋“œํ•ด.
  2. ์„ค์น˜ ํŒŒ์ผ์„ ์‹คํ–‰ํ•˜๊ณ  ์ง€์‹œ์— ๋”ฐ๋ผ ์„ค์น˜๋ฅผ ์™„๋ฃŒํ•ด.
  3. WSL 2 ๋ฐฑ์—”๋“œ๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์„ ์ถ”์ฒœํ•ด (2025๋…„์—๋Š” WSL 3๋„ ๋‚˜์™”์„์ง€๋„!)
  4. ์„ค์น˜ ํ›„ Docker Desktop์„ ์‹คํ–‰ํ•˜๊ณ  ์ƒํƒœ๊ฐ€ "Running"์ธ์ง€ ํ™•์ธํ•ด.

macOS์— Docker ์„ค์น˜ํ•˜๊ธฐ

  1. Docker Desktop for Mac์„ ๋‹ค์šด๋กœ๋“œํ•ด.
  2. Apple Silicon(M1/M2/M3/M4) ๋˜๋Š” Intel ์นฉ์…‹์— ๋งž๋Š” ๋ฒ„์ „์„ ์„ ํƒํ•ด.
  3. ์„ค์น˜ ํŒŒ์ผ์„ ์‹คํ–‰ํ•˜๊ณ  Applications ํด๋”๋กœ ๋“œ๋ž˜๊ทธํ•ด.
  4. Docker Desktop์„ ์‹คํ–‰ํ•˜๊ณ  ์ƒํƒœ๊ฐ€ "Running"์ธ์ง€ ํ™•์ธํ•ด.

Linux์— Docker ์„ค์น˜ํ•˜๊ธฐ

  1. ํ„ฐ๋ฏธ๋„์„ ์—ด๊ณ  ๋‹ค์Œ ๋ช…๋ น์–ด๋กœ Docker ์ €์žฅ์†Œ๋ฅผ ์„ค์ •ํ•ด:
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  1. Docker Engine์„ ์„ค์น˜ํ•ด:
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
  1. Docker๊ฐ€ ์ •์ƒ์ ์œผ๋กœ ์„ค์น˜๋˜์—ˆ๋Š”์ง€ ํ™•์ธํ•ด:
sudo docker run hello-world

โœ… Docker ์„ค์น˜ ํ™•์ธํ•˜๊ธฐ

ํ„ฐ๋ฏธ๋„ ๋˜๋Š” ๋ช…๋ น ํ”„๋กฌํ”„ํŠธ๋ฅผ ์—ด๊ณ  ๋‹ค์Œ ๋ช…๋ น์–ด๋ฅผ ์‹คํ–‰ํ•ด๋ด:

docker --version
docker-compose --version

๋ฒ„์ „ ์ •๋ณด๊ฐ€ ํ‘œ์‹œ๋˜๋ฉด ์„ค์น˜๊ฐ€ ์™„๋ฃŒ๋œ ๊ฑฐ์•ผ! 2025๋…„ ๊ธฐ์ค€์œผ๋กœ๋Š” Docker 27.x ๋ฒ„์ „๊ณผ Docker Compose 3.x ๋ฒ„์ „์ด ํ‘œ์‹œ๋  ๊ฑฐ์•ผ.

Go ๊ฐœ๋ฐœ์„ ์œ„ํ•œ ๊ธฐ๋ณธ Docker ์ด๋ฏธ์ง€ ์„ ํƒํ•˜๊ธฐ

Docker Hub์—๋Š” ๊ณต์‹ Go ์ด๋ฏธ์ง€๊ฐ€ ์žˆ์–ด์„œ ์‰ฝ๊ฒŒ ์‹œ์ž‘ํ•  ์ˆ˜ ์žˆ์–ด. 2025๋…„ ํ˜„์žฌ ๋‹ค์–‘ํ•œ ํƒœ๊ทธ๊ฐ€ ์žˆ์ง€๋งŒ, ์ฃผ๋กœ ์‚ฌ์šฉ๋˜๋Š” ๋ช‡ ๊ฐ€์ง€๋ฅผ ์†Œ๊ฐœํ• ๊ฒŒ:

  1. golang:latest - ์ตœ์‹  Go ๋ฒ„์ „์„ ํฌํ•จํ•œ ์ด๋ฏธ์ง€
  2. golang:1.22 - Go 1.22.x ๋ฒ„์ „์„ ํฌํ•จํ•œ ์ด๋ฏธ์ง€ (2025๋…„ ๊ธฐ์ค€ ์•ˆ์ • ๋ฒ„์ „)
  3. golang:1.22-alpine - Alpine Linux ๊ธฐ๋ฐ˜์˜ ๊ฒฝ๋Ÿ‰ํ™”๋œ Go 1.22.x ์ด๋ฏธ์ง€
  4. golang:1.22-bullseye - Debian Bullseye ๊ธฐ๋ฐ˜์˜ Go 1.22.x ์ด๋ฏธ์ง€

๊ฐœ๋ฐœ ํ™˜๊ฒฝ์—์„œ๋Š” golang:1.22์™€ ๊ฐ™์€ ์ „์ฒด ์ด๋ฏธ์ง€๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์ด ํŽธ๋ฆฌํ•ด. ํ•„์š”ํ•œ ๊ฐœ๋ฐœ ๋„๊ตฌ๋“ค์ด ๋ชจ๋‘ ํฌํ•จ๋˜์–ด ์žˆ๊ฑฐ๋“ . ํ•˜์ง€๋งŒ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” golang:1.22-alpine๊ณผ ๊ฐ™์€ ๊ฒฝ๋Ÿ‰ ์ด๋ฏธ์ง€๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์ด ์ข‹์•„. ์ด๋ฏธ์ง€ ํฌ๊ธฐ๊ฐ€ ์ž‘์•„์„œ ๋ฐฐํฌ๊ฐ€ ๋น ๋ฅด๊ณ  ๋ณด์•ˆ ์ทจ์•ฝ์ ๋„ ์ค„์ผ ์ˆ˜ ์žˆ์–ด!

์ด์ œ Docker๊ฐ€ ์„ค์น˜๋˜์—ˆ๊ณ  ์–ด๋–ค Go ์ด๋ฏธ์ง€๋ฅผ ์‚ฌ์šฉํ• ์ง€ ๊ฒฐ์ •ํ–ˆ์œผ๋‹ˆ, ์‹ค์ œ๋กœ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์„ ๊ตฌ์„ฑํ•ด๋ณด์ž!

4. Dockerfile ์ž‘์„ฑํ•˜๊ธฐ ๐Ÿ“

Dockerfile์€ Docker ์ด๋ฏธ์ง€๋ฅผ ๋งŒ๋“ค๊ธฐ ์œ„ํ•œ ์„ค๊ณ„๋„์™€ ๊ฐ™์•„. Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์œ„ํ•œ Dockerfile์„ ์ž‘์„ฑํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ์•„๋ณด์ž!

๐Ÿ”Ž ๊ธฐ๋ณธ Dockerfile ๊ตฌ์กฐ

# ๋ฒ ์ด์Šค ์ด๋ฏธ์ง€ ์ง€์ •
FROM golang:1.22

# ์ž‘์—… ๋””๋ ‰ํ† ๋ฆฌ ์„ค์ •
WORKDIR /app

# ๋ชจ๋“ˆ ํŒŒ์ผ ๋ณต์‚ฌ ๋ฐ ์˜์กด์„ฑ ๋‹ค์šด๋กœ๋“œ
COPY go.mod go.sum ./
RUN go mod download

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

# ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋นŒ๋“œ
RUN go build -o main .

# ์ปจํ…Œ์ด๋„ˆ ์‹คํ–‰ ์‹œ ์‹คํ–‰ํ•  ๋ช…๋ น์–ด
CMD ["./main"]

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

๐Ÿš€ ๋ฉ€ํ‹ฐ ์Šคํ…Œ์ด์ง€ Dockerfile

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

WORKDIR /app

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

COPY . .

# ์ •์  ๋ฐ”์ด๋„ˆ๋ฆฌ๋กœ ๋นŒ๋“œ (CGO ๋น„ํ™œ์„ฑํ™”)
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main .

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

RUN apk --no-cache add ca-certificates

WORKDIR /root/

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

# ํฌํŠธ ๋…ธ์ถœ (์›น ์„œ๋ฒ„์˜ ๊ฒฝ์šฐ)
EXPOSE 8080

CMD ["./main"]

์ด ๋ฉ€ํ‹ฐ ์Šคํ…Œ์ด์ง€ Dockerfile์˜ ์žฅ์ ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์•„:

  1. ์ž‘์€ ์ด๋ฏธ์ง€ ํฌ๊ธฐ: ์ตœ์ข… ์ด๋ฏธ์ง€์—๋Š” Go ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์ด ํฌํ•จ๋˜์ง€ ์•Š๊ณ  ์‹คํ–‰ ํŒŒ์ผ๋งŒ ํฌํ•จ๋ผ.
  2. ๋ณด์•ˆ ๊ฐ•ํ™”: ๋ถˆํ•„์š”ํ•œ ๋„๊ตฌ์™€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๊ฐ€ ์—†์–ด ๊ณต๊ฒฉ ํ‘œ๋ฉด์ด ์ค„์–ด๋“ค์–ด.
  3. ๋ฐฐํฌ ํšจ์œจ์„ฑ: ์ž‘์€ ์ด๋ฏธ์ง€๋Š” ๋” ๋น ๋ฅด๊ฒŒ ๋‹ค์šด๋กœ๋“œ๋˜๊ณ  ๋ฐฐํฌ๋  ์ˆ˜ ์žˆ์–ด.

๊ฐœ๋ฐœ์šฉ Dockerfile๊ณผ ํ”„๋กœ๋•์…˜์šฉ Dockerfile ๋ถ„๋ฆฌํ•˜๊ธฐ

๊ฐœ๋ฐœ ์ค‘์—๋Š” ์ฝ”๋“œ๋ฅผ ์ž์ฃผ ๋ณ€๊ฒฝํ•˜๊ธฐ ๋•Œ๋ฌธ์— ๋งค๋ฒˆ ์ด๋ฏธ์ง€๋ฅผ ๋‹ค์‹œ ๋นŒ๋“œํ•˜๋Š” ๊ฒƒ์€ ๋น„ํšจ์œจ์ ์ด์•ผ. ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์—์„œ๋Š” ๋ผ์ด๋ธŒ ๋ฆฌ๋กœ๋”ฉ์„ ์ง€์›ํ•˜๋Š” ์„ค์ •์ด ์œ ์šฉํ•ด!

๐Ÿ”ง ๊ฐœ๋ฐœ์šฉ Dockerfile (Dockerfile.dev)

FROM golang:1.22

WORKDIR /app

# ๋ผ์ด๋ธŒ ๋ฆฌ๋กœ๋”ฉ์„ ์œ„ํ•œ Air ์„ค์น˜
RUN go install github.com/cosmtrek/air@latest

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

# ์†Œ์Šค ์ฝ”๋“œ๋Š” ๋ณผ๋ฅจ ๋งˆ์šดํŠธ๋กœ ์ œ๊ณตํ•  ์˜ˆ์ •
CMD ["air", "-c", ".air.toml"]

๊ฐœ๋ฐœ ํ™˜๊ฒฝ์—์„œ๋Š” ์ด Dockerfile.dev์™€ ํ•จ๊ป˜ ๋ณผ๋ฅจ ๋งˆ์šดํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ๋กœ์ปฌ ์ฝ”๋“œ ๋ณ€๊ฒฝ์ด ์ปจํ…Œ์ด๋„ˆ์— ์ฆ‰์‹œ ๋ฐ˜์˜๋ผ. ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ์–ด:

docker build -t go-dev -f Dockerfile.dev .
docker run -p 8080:8080 -v $(pwd):/app go-dev

2025๋…„ ํ˜„์žฌ, Go ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์—์„œ๋Š” Air, Realize, Reflex ๊ฐ™์€ ๋„๊ตฌ๋“ค์ด ๋ผ์ด๋ธŒ ๋ฆฌ๋กœ๋”ฉ์„ ์ง€์›ํ•ด. ํŠนํžˆ Air๋Š” ์„ค์ •์ด ๊ฐ„๋‹จํ•˜๊ณ  ์‚ฌ์šฉํ•˜๊ธฐ ์‰ฌ์›Œ์„œ ๋งŽ์€ ๊ฐœ๋ฐœ์ž๋“ค์ด ์„ ํ˜ธํ•˜๊ณ  ์žˆ์–ด!

๐ŸŒฌ๏ธ Air ์„ค์ • ํŒŒ์ผ (.air.toml)

root = "."
tmp_dir = "tmp"

[build]
  cmd = "go build -o ./tmp/main ."
  bin = "./tmp/main"
  delay = 1000
  exclude_dir = ["assets", "tmp", "vendor"]
  include_ext = ["go", "tpl", "tmpl", "html"]
  exclude_regex = ["_test\\.go"]

[log]
  time = true

[color]
  main = "magenta"
  watcher = "cyan"
  build = "yellow"
  runner = "green"
Go + Docker ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ ๋กœ์ปฌ ์ฝ”๋“œ ์ž‘์„ฑ ์ €์žฅ ๋ณผ๋ฅจ ๋งˆ์šดํŠธ ๋ณ€๊ฒฝ ๊ฐ์ง€ Air ์ž๋™ ์žฌ๋นŒ๋“œ ์‹คํ–‰ ์•ฑ ์žฌ์‹œ์ž‘ ๊ฐœ๋ฐœ ์‚ฌ์ดํด ๋ฐ˜๋ณต ๊ฐœ๋ฐœ ํ™˜๊ฒฝ - ๋ผ์ด๋ธŒ ๋ฆฌ๋กœ๋”ฉ - ๋ณผ๋ฅจ ๋งˆ์šดํŠธ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ - ๋ฉ€ํ‹ฐ ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ - ์ตœ์†Œ ์ด๋ฏธ์ง€ ํฌ๊ธฐ

์ด์ œ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ๊ณผ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ ๋ชจ๋‘๋ฅผ ์œ„ํ•œ Dockerfile์„ ์ž‘์„ฑํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ๊ฒŒ ๋˜์—ˆ์–ด! ๋‹ค์Œ์œผ๋กœ๋Š” ์—ฌ๋Ÿฌ ์„œ๋น„์Šค๋ฅผ ํ•จ๊ป˜ ์‹คํ–‰ํ•˜๊ธฐ ์œ„ํ•œ Docker Compose ์„ค์ • ๋ฐฉ๋ฒ•์„ ์•Œ์•„๋ณด์ž.

5. Docker Compose๋กœ ๋‹ค์ค‘ ์„œ๋น„์Šค ๊ตฌ์„ฑํ•˜๊ธฐ ๐Ÿงฉ

์‹ค์ œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ ๋Œ€๋ถ€๋ถ„ ์—ฌ๋Ÿฌ ์„œ๋น„์Šค๋กœ ๊ตฌ์„ฑ๋ผ. Go ์›น ์„œ๋ฒ„, ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค, ์บ์‹œ ์„œ๋ฒ„ ๋“ฑ์„ ํ•จ๊ป˜ ์‹คํ–‰ํ•ด์•ผ ํ•  ๋•Œ Docker Compose๊ฐ€ ์ •๋ง ์œ ์šฉํ•ด!

๐Ÿ”„ Docker Compose๋ž€?

Docker Compose๋Š” ์—ฌ๋Ÿฌ ์ปจํ…Œ์ด๋„ˆ๋กœ ๊ตฌ์„ฑ๋œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์ •์˜ํ•˜๊ณ  ์‹คํ–‰ํ•˜๊ธฐ ์œ„ํ•œ ๋„๊ตฌ์•ผ. YAML ํŒŒ์ผ์„ ์‚ฌ์šฉํ•ด ์„œ๋น„์Šค, ๋„คํŠธ์›Œํฌ, ๋ณผ๋ฅจ ๋“ฑ์„ ์„ค์ •ํ•  ์ˆ˜ ์žˆ์–ด. 2025๋…„ ํ˜„์žฌ Docker Compose V3 ๋ฌธ๋ฒ•์ด ํ‘œ์ค€์œผ๋กœ ์‚ฌ์šฉ๋˜๊ณ  ์žˆ์–ด!

๐Ÿ“‹ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์œ„ํ•œ docker-compose.yml

version: '3.9'

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile.dev
    ports:
      - "8080:8080"
    volumes:
      - .:/app
    depends_on:
      - db
      - redis
    environment:
      - DB_HOST=db
      - DB_USER=postgres
      - DB_PASSWORD=postgres
      - DB_NAME=goapp
      - REDIS_HOST=redis
      - REDIS_PORT=6379

  db:
    image: postgres:16-alpine
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=goapp
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data

volumes:
  postgres_data:
  redis_data:

์ด Docker Compose ํŒŒ์ผ์€ ์„ธ ๊ฐ€์ง€ ์„œ๋น„์Šค๋ฅผ ์ •์˜ํ•˜๊ณ  ์žˆ์–ด:

  1. app: ์šฐ๋ฆฌ์˜ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜
  2. db: PostgreSQL ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค
  3. redis: Redis ์บ์‹œ ์„œ๋ฒ„

๊ฐ ์„œ๋น„์Šค๋Š” ๋…๋ฆฝ์ ์ธ ์ปจํ…Œ์ด๋„ˆ๋กœ ์‹คํ–‰๋˜์ง€๋งŒ, ๊ฐ™์€ ๋„คํŠธ์›Œํฌ์— ์—ฐ๊ฒฐ๋˜์–ด ์„œ๋กœ ํ†ต์‹ ํ•  ์ˆ˜ ์žˆ์–ด. ์˜ˆ๋ฅผ ๋“ค์–ด, Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ "db"์™€ "redis"๋ผ๋Š” ํ˜ธ์ŠคํŠธ ์ด๋ฆ„์œผ๋กœ ๋‹ค๋ฅธ ์„œ๋น„์Šค์— ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ์ง€!

โŒจ๏ธ Docker Compose ๋ช…๋ น์–ด

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

# ๋ฐฑ๊ทธ๋ผ์šด๋“œ์—์„œ ์‹คํ–‰
docker-compose up -d

# ์„œ๋น„์Šค ์ค‘์ง€
docker-compose down

# ๋ณผ๋ฅจ๊นŒ์ง€ ๋ชจ๋‘ ์‚ญ์ œํ•˜๋ฉฐ ์ค‘์ง€
docker-compose down -v

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

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

๊ฐœ๋ฐœ ํ™˜๊ฒฝ๊ณผ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์„ ์œ„ํ•œ ๋ณ„๋„์˜ Compose ํŒŒ์ผ

๊ฐœ๋ฐœ ํ™˜๊ฒฝ๊ณผ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์€ ์š”๊ตฌ์‚ฌํ•ญ์ด ๋‹ค๋ฅด๊ธฐ ๋•Œ๋ฌธ์— ๋ณ„๋„์˜ Compose ํŒŒ์ผ์„ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์ด ์ข‹์•„. ์˜ˆ๋ฅผ ๋“ค์–ด, ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์—์„œ๋Š” ๋ณผ๋ฅจ ๋งˆ์šดํŠธ์™€ ํฌํŠธ ํฌ์›Œ๋”ฉ์ด ํ•„์š”ํ•˜์ง€๋งŒ, ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” ๋ณด์•ˆ์„ ์œ„ํ•ด ์ตœ์†Œํ•œ์˜ ํฌํŠธ๋งŒ ๋…ธ์ถœํ•˜๋Š” ๊ฒƒ์ด ์ข‹์•„.

๐Ÿš€ ํ”„๋กœ๋•์…˜์šฉ docker-compose.prod.yml

version: '3.9'

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile  # ํ”„๋กœ๋•์…˜์šฉ ๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ Dockerfile
    ports:
      - "8080:8080"
    depends_on:
      - db
      - redis
    environment:
      - DB_HOST=db
      - DB_USER=postgres
      - DB_PASSWORD=${DB_PASSWORD}  # ํ™˜๊ฒฝ ๋ณ€์ˆ˜์—์„œ ๊ฐ€์ ธ์˜ด
      - DB_NAME=goapp
      - REDIS_HOST=redis
      - REDIS_PORT=6379
    restart: always  # ์ปจํ…Œ์ด๋„ˆ ์ž๋™ ์žฌ์‹œ์ž‘

  db:
    image: postgres:16-alpine
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=${DB_PASSWORD}
      - POSTGRES_DB=goapp
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: always
    # ํ”„๋กœ๋•์…˜์—์„œ๋Š” DB ํฌํŠธ๋ฅผ ์™ธ๋ถ€์— ๋…ธ์ถœํ•˜์ง€ ์•Š์Œ

  redis:
    image: redis:7-alpine
    volumes:
      - redis_data:/data
    restart: always
    # ํ”„๋กœ๋•์…˜์—์„œ๋Š” Redis ํฌํŠธ๋ฅผ ์™ธ๋ถ€์— ๋…ธ์ถœํ•˜์ง€ ์•Š์Œ

volumes:
  postgres_data:
  redis_data:

ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ์–ด:

DB_PASSWORD=secure_password docker-compose -f docker-compose.prod.yml up -d

2025๋…„์—๋Š” Docker Compose์™€ Kubernetes์˜ ํ†ตํ•ฉ์ด ๋”์šฑ ๊ฐ•ํ™”๋˜์–ด, Compose ํŒŒ์ผ์„ Kubernetes ๋ฆฌ์†Œ์Šค๋กœ ์‰ฝ๊ฒŒ ๋ณ€ํ™˜ํ•  ์ˆ˜ ์žˆ๊ฒŒ ๋˜์—ˆ์–ด. ์ด๋ฅผ ํ†ตํ•ด ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์—์„œ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์œผ๋กœ์˜ ์ „ํ™˜์ด ๋”์šฑ ์›ํ™œํ•ด์กŒ์ง€!

Docker Compose ์„œ๋น„์Šค ๊ตฌ์„ฑ Docker Network Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ - 8080 ํฌํŠธ ๋…ธ์ถœ - ๋ณผ๋ฅจ ๋งˆ์šดํŠธ - ํ™˜๊ฒฝ ๋ณ€์ˆ˜ - ์ž๋™ ์žฌ์‹œ์ž‘ - ์˜์กด์„ฑ ๊ด€๋ฆฌ PostgreSQL - ๋ฐ์ดํ„ฐ ์˜์†์„ฑ - ํ™˜๊ฒฝ ๋ณ€์ˆ˜ - ๋ณผ๋ฅจ ๋งˆ์šดํŠธ - ๋‚ด๋ถ€ ๋„คํŠธ์›Œํฌ ํ†ต์‹  - ์ž๋™ ์žฌ์‹œ์ž‘ Redis - ์บ์‹ฑ ์„œ๋น„์Šค - ๋ฐ์ดํ„ฐ ์˜์†์„ฑ - ๋ณผ๋ฅจ ๋งˆ์šดํŠธ - ๋‚ด๋ถ€ ๋„คํŠธ์›Œํฌ ํ†ต์‹  - ์ž๋™ ์žฌ์‹œ์ž‘ DB ์—ฐ๊ฒฐ ์บ์‹œ ์—ฐ๊ฒฐ

Docker Compose๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ๋ณต์žกํ•œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์Šคํƒ๋„ ์‰ฝ๊ฒŒ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด. ์ด์ œ ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ์ตœ์ ํ™”ํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ์•„๋ณด์ž!

6. ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ ์ตœ์ ํ™”ํ•˜๊ธฐ โšก

Docker๋ฅผ ์‚ฌ์šฉํ•œ Go ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์„ ์„ค์ •ํ–ˆ๋‹ค๋ฉด, ์ด์ œ ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ์ตœ์ ํ™”ํ•ด์„œ ์ƒ์‚ฐ์„ฑ์„ ๋†’์—ฌ๋ณด์ž! 2025๋…„ ํ˜„์žฌ ๋งŽ์€ ๊ฐœ๋ฐœ์ž๋“ค์ด ์‚ฌ์šฉํ•˜๋Š” ๋ช‡ ๊ฐ€์ง€ ๋ฒ ์ŠคํŠธ ํ”„๋ž™ํ‹ฐ์Šค๋ฅผ ์†Œ๊ฐœํ• ๊ฒŒ.

๐Ÿš€ ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ ์ตœ์ ํ™” ํŒ

1. VS Code์™€ Docker ํ†ตํ•ฉํ•˜๊ธฐ

VS Code์˜ Docker ํ™•์žฅ ํ”„๋กœ๊ทธ๋žจ๊ณผ Remote - Containers ํ™•์žฅ์„ ์‚ฌ์šฉํ•˜๋ฉด ์ปจํ…Œ์ด๋„ˆ ๋‚ด๋ถ€์—์„œ ์ง์ ‘ ๊ฐœ๋ฐœํ•  ์ˆ˜ ์žˆ์–ด. ์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ๋กœ์ปฌ ํ™˜๊ฒฝ๊ณผ Docker ํ™˜๊ฒฝ์˜ ์ฐจ์ด๋กœ ์ธํ•œ ๋ฌธ์ œ๋ฅผ ์™„์ „ํžˆ ํ•ด๊ฒฐํ•  ์ˆ˜ ์žˆ์ง€!

2. ๋””๋ฒ„๊น… ์„ค์ •ํ•˜๊ธฐ

Go์˜ ๋””๋ฒ„๊ฑฐ์ธ Delve๋ฅผ Docker ํ™˜๊ฒฝ์—์„œ ์‚ฌ์šฉํ•˜๋„๋ก ์„ค์ •ํ•˜๋ฉด ์ปจํ…Œ์ด๋„ˆ ๋‚ด๋ถ€์—์„œ ์‹คํ–‰ ์ค‘์ธ ์ฝ”๋“œ๋ฅผ ๋””๋ฒ„๊น…ํ•  ์ˆ˜ ์žˆ์–ด. VS Code์˜ launch.json ํŒŒ์ผ์„ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์„ค์ •ํ•ด๋ด:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Docker: Go",
      "type": "go",
      "request": "attach",
      "mode": "remote",
      "remotePath": "/app",
      "port": 2345,
      "host": "127.0.0.1",
      "showLog": true
    }
  ]
}

3. ํ•ซ ๋ฆฌ๋กœ๋”ฉ ์„ค์ •ํ•˜๊ธฐ

์•ž์„œ ์†Œ๊ฐœํ•œ Air ์™ธ์—๋„ CompileDaemon, Reflex ๊ฐ™์€ ๋„๊ตฌ๋“ค์„ ์‚ฌ์šฉํ•ด ์ฝ”๋“œ ๋ณ€๊ฒฝ ์‹œ ์ž๋™์œผ๋กœ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์žฌ์‹œ์ž‘ํ•  ์ˆ˜ ์žˆ์–ด. ์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ๊ฐœ๋ฐœ ์‚ฌ์ดํด์ด ํฌ๊ฒŒ ๋‹จ์ถ•๋ผ!

4. ํ…Œ์ŠคํŠธ ์ž๋™ํ™”ํ•˜๊ธฐ

Docker ํ™˜๊ฒฝ์—์„œ Go ํ…Œ์ŠคํŠธ๋ฅผ ์ž๋™์œผ๋กœ ์‹คํ–‰ํ•˜๋„๋ก ์„ค์ •ํ•˜๋ฉด ์ฝ”๋“œ ํ’ˆ์งˆ์„ ์œ ์ง€ํ•˜๋Š” ๋ฐ ๋„์›€์ด ๋ผ. ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๋ช…๋ น์–ด๋กœ ํ…Œ์ŠคํŠธ๋ฅผ ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ์–ด:

docker-compose exec app go test ./...

5. Makefile ์‚ฌ์šฉํ•˜๊ธฐ

์ž์ฃผ ์‚ฌ์šฉํ•˜๋Š” Docker ๋ช…๋ น์–ด๋ฅผ Makefile๋กœ ์ •์˜ํ•˜๋ฉด ๋” ์‰ฝ๊ฒŒ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์–ด. ์˜ˆ๋ฅผ ๋“ค๋ฉด:

up:
	docker-compose up -d

down:
	docker-compose down

logs:
	docker-compose logs -f app

test:
	docker-compose exec app go test ./...

build:
	docker-compose build

restart:
	docker-compose restart app

๐Ÿ”ง VS Code DevContainer ์„ค์ •ํ•˜๊ธฐ

VS Code์˜ DevContainer ๊ธฐ๋Šฅ์„ ์‚ฌ์šฉํ•˜๋ฉด ์ปจํ…Œ์ด๋„ˆ ๋‚ด๋ถ€์—์„œ ์ง์ ‘ ๊ฐœ๋ฐœํ•  ์ˆ˜ ์žˆ์–ด. ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ์— .devcontainer/devcontainer.json ํŒŒ์ผ์„ ๋งŒ๋“ค์–ด๋ณด์ž:

{
  "name": "Go Development",
  "dockerComposeFile": "../docker-compose.yml",
  "service": "app",
  "workspaceFolder": "/app",
  "extensions": [
    "golang.go",
    "ms-azuretools.vscode-docker",
    "eamodio.gitlens",
    "streetsidesoftware.code-spell-checker"
  ],
  "settings": {
    "go.toolsManagement.checkForUpdates": "local",
    "go.useLanguageServer": true,
    "go.gopath": "/go",
    "go.goroot": "/usr/local/go",
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
      "source.organizeImports": true
    }
  }
}

์ด ์„ค์ •์„ ์‚ฌ์šฉํ•˜๋ฉด VS Code๊ฐ€ Docker ์ปจํ…Œ์ด๋„ˆ ๋‚ด๋ถ€์—์„œ ์‹คํ–‰๋˜๊ณ , Go ์–ธ์–ด ์„œ๋ฒ„์™€ ํ•„์š”ํ•œ ํ™•์žฅ ํ”„๋กœ๊ทธ๋žจ์ด ์ž๋™์œผ๋กœ ์„ค์น˜๋ผ. ๋กœ์ปฌ ํ™˜๊ฒฝ๊ณผ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์˜ ์ฐจ์ด๋กœ ์ธํ•œ ๋ฌธ์ œ๋ฅผ ์™„์ „ํžˆ ํ•ด๊ฒฐํ•  ์ˆ˜ ์žˆ์–ด!

CI/CD ํŒŒ์ดํ”„๋ผ์ธ ๊ตฌ์„ฑํ•˜๊ธฐ

2025๋…„ ํ˜„์žฌ, GitHub Actions, GitLab CI, Jenkins ๋“ฑ ๋‹ค์–‘ํ•œ CI/CD ๋„๊ตฌ๋“ค์ด Docker์™€ ํ†ตํ•ฉ๋˜์–ด ์žˆ์–ด. ์ด๋ฅผ ํ™œ์šฉํ•ด ์ž๋™ํ™”๋œ ๋นŒ๋“œ, ํ…Œ์ŠคํŠธ, ๋ฐฐํฌ ํŒŒ์ดํ”„๋ผ์ธ์„ ๊ตฌ์„ฑํ•  ์ˆ˜ ์žˆ์–ด!

๐Ÿ”„ GitHub Actions ์›Œํฌํ”Œ๋กœ์šฐ ์˜ˆ์‹œ

name: Go Docker CI/CD

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    
    - name: Set up Docker Buildx
      uses: docker/setup-buildx-action@v3
    
    - name: Build and test
      run: |
        docker-compose build
        docker-compose up -d
        docker-compose exec -T app go test ./...
    
    - name: Build production image
      if: github.event_name != 'pull_request'
      run: |
        docker build -t myapp:latest .
    
    - name: Login to Docker Hub
      if: github.event_name != 'pull_request'
      uses: docker/login-action@v3
      with:
        username: ${{ secrets.DOCKER_HUB_USERNAME }}
        password: ${{ secrets.DOCKER_HUB_TOKEN }}
    
    - name: Push to Docker Hub
      if: github.event_name != 'pull_request'
      run: |
        docker tag myapp:latest username/myapp:latest
        docker push username/myapp:latest

์ด GitHub Actions ์›Œํฌํ”Œ๋กœ์šฐ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์€ ์ž‘์—…์„ ์ˆ˜ํ–‰ํ•ด:

  1. ์ฝ”๋“œ ๋ณ€๊ฒฝ์ด ๋ฐœ์ƒํ•˜๋ฉด ์ž๋™์œผ๋กœ Docker ์ด๋ฏธ์ง€๋ฅผ ๋นŒ๋“œํ•ด.
  2. Docker Compose๋ฅผ ์‚ฌ์šฉํ•ด ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์‹คํ–‰ํ•˜๊ณ  ํ…Œ์ŠคํŠธ๋ฅผ ์ˆ˜ํ–‰ํ•ด.
  3. ๋ฉ”์ธ ๋ธŒ๋žœ์น˜์— ๋ณ‘ํ•ฉ๋œ ๊ฒฝ์šฐ, ํ”„๋กœ๋•์…˜์šฉ ์ด๋ฏธ์ง€๋ฅผ ๋นŒ๋“œํ•˜๊ณ  Docker Hub์— ํ‘ธ์‹œํ•ด.

CI/CD ํŒŒ์ดํ”„๋ผ์ธ์„ ๊ตฌ์„ฑํ•˜๋ฉด ์ฝ”๋“œ ํ’ˆ์งˆ์„ ์œ ์ง€ํ•˜๊ณ  ๋ฐฐํฌ ๊ณผ์ •์„ ์ž๋™ํ™”ํ•  ์ˆ˜ ์žˆ์–ด. ์ด๋Š” ํŠนํžˆ ํŒ€ ํ”„๋กœ์ ํŠธ์—์„œ ์ค‘์š”ํ•œ ์—ญํ• ์„ ํ•ด!

Go + Docker CI/CD ํŒŒ์ดํ”„๋ผ์ธ ์ฝ”๋“œ ์ปค๋ฐ‹ ์ž๋™ ๋นŒ๋“œ ์ž๋™ ํ…Œ์ŠคํŠธ ์ž๋™ ๋ฐฐํฌ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ - VS Code DevContainer - ํ•ซ ๋ฆฌ๋กœ๋”ฉ (Air) - ๋””๋ฒ„๊น… (Delve) - ํ…Œ์ŠคํŠธ ์ž๋™ํ™” ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ - ๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ - ๋ณด์•ˆ ๊ฐ•ํ™” - ์ž๋™ ์Šค์ผ€์ผ๋ง - ๋ชจ๋‹ˆํ„ฐ๋ง ๋ฐ ๋กœ๊น…

์ด์ œ ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ์ตœ์ ํ™”ํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ๊ฒŒ ๋˜์—ˆ์–ด! ๋‹ค์Œ์œผ๋กœ๋Š” ์‹ค์ „ ํ”„๋กœ์ ํŠธ๋ฅผ ํ†ตํ•ด Go์™€ Docker๋ฅผ ํ•จ๊ป˜ ์‚ฌ์šฉํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ์•„๋ณด์ž.

7. ์‹ค์ „ ํ”„๋กœ์ ํŠธ: Go + Docker ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋งŒ๋“ค๊ธฐ ๐Ÿ—๏ธ

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

๐Ÿ” ํ”„๋กœ์ ํŠธ ๊ฐœ์š”

๊ฐ„๋‹จํ•œ ํ•  ์ผ ๊ด€๋ฆฌ(Todo) API๋ฅผ ๋งŒ๋“ค์–ด๋ณผ ๊ฑฐ์•ผ. ์ด API๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•  ๊ฑฐ์•ผ:

  1. ํ•  ์ผ ๋ชฉ๋ก ์กฐํšŒ
  2. ์ƒˆ๋กœ์šด ํ•  ์ผ ์ถ”๊ฐ€
  3. ํ•  ์ผ ์™„๋ฃŒ ์ƒํƒœ ๋ณ€๊ฒฝ
  4. ํ•  ์ผ ์‚ญ์ œ

์ด ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ Go๋กœ ์ž‘์„ฑ๋˜๊ณ , PostgreSQL์— ๋ฐ์ดํ„ฐ๋ฅผ ์ €์žฅํ•˜๋ฉฐ, Redis๋ฅผ ์บ์‹ฑ์— ์‚ฌ์šฉํ•  ๊ฑฐ์•ผ. ๋ชจ๋“  ์„œ๋น„์Šค๋Š” Docker Compose๋กœ ๊ด€๋ฆฌ๋  ๊ฑฐ์•ผ!

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

todo-app/
โ”œโ”€โ”€ .devcontainer/
โ”‚   โ””โ”€โ”€ devcontainer.json
โ”œโ”€โ”€ api/
โ”‚   โ”œโ”€โ”€ handlers.go
โ”‚   โ””โ”€โ”€ routes.go
โ”œโ”€โ”€ config/
โ”‚   โ””โ”€โ”€ config.go
โ”œโ”€โ”€ db/
โ”‚   โ”œโ”€โ”€ postgres.go
โ”‚   โ””โ”€โ”€ redis.go
โ”œโ”€โ”€ models/
โ”‚   โ””โ”€โ”€ todo.go
โ”œโ”€โ”€ .air.toml
โ”œโ”€โ”€ .dockerignore
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ docker-compose.yml
โ”œโ”€โ”€ Dockerfile
โ”œโ”€โ”€ Dockerfile.dev
โ”œโ”€โ”€ go.mod
โ”œโ”€โ”€ go.sum
โ”œโ”€โ”€ main.go
โ””โ”€โ”€ Makefile

1. Go ๋ชจ๋“ˆ ์ดˆ๊ธฐํ™” ๋ฐ ์˜์กด์„ฑ ์„ค์ •

๋จผ์ € Go ๋ชจ๋“ˆ์„ ์ดˆ๊ธฐํ™”ํ•˜๊ณ  ํ•„์š”ํ•œ ์˜์กด์„ฑ์„ ์ถ”๊ฐ€ํ•ด๋ณด์ž:

mkdir todo-app
cd todo-app
go mod init github.com/yourusername/todo-app
go get -u github.com/gin-gonic/gin
go get -u github.com/lib/pq
go get -u github.com/go-redis/redis/v9
go get -u github.com/spf13/viper

2. ๋ฉ”์ธ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ฝ”๋“œ ์ž‘์„ฑ

๊ฐ„๋‹จํ•œ ๋ฉ”์ธ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ฝ”๋“œ๋ฅผ ์ž‘์„ฑํ•ด๋ณด์ž:

main.go

package main

import (
	"log"
	"github.com/yourusername/todo-app/api"
	"github.com/yourusername/todo-app/config"
	"github.com/yourusername/todo-app/db"
)

func main() {
	// ์„ค์ • ๋กœ๋“œ
	cfg, err := config.Load()
	if err != nil {
		log.Fatalf("์„ค์ •์„ ๋กœ๋“œํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค: %v", err)
	}

	// ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ
	postgres, err := db.NewPostgresDB(cfg.Database)
	if err != nil {
		log.Fatalf("PostgreSQL์— ์—ฐ๊ฒฐํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค: %v", err)
	}
	defer postgres.Close()

	// Redis ์—ฐ๊ฒฐ
	redis, err := db.NewRedisClient(cfg.Redis)
	if err != nil {
		log.Fatalf("Redis์— ์—ฐ๊ฒฐํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค: %v", err)
	}
	defer redis.Close()

	// API ๋ผ์šฐํ„ฐ ์„ค์ •
	router := api.SetupRouter(postgres, redis)

	// ์„œ๋ฒ„ ์‹œ์ž‘
	log.Printf("์„œ๋ฒ„๊ฐ€ %s ํฌํŠธ์—์„œ ์‹œ์ž‘๋ฉ๋‹ˆ๋‹ค...", cfg.Server.Port)
	if err := router.Run(":" + cfg.Server.Port); err != nil {
		log.Fatalf("์„œ๋ฒ„๋ฅผ ์‹œ์ž‘ํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค: %v", err)
	}
}

3. ๋ชจ๋ธ ์ •์˜

models/todo.go

package models

import (
	"time"
)

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

type TodoRepository interface {
	GetAll() ([]Todo, error)
	GetByID(id int) (*Todo, error)
	Create(todo *Todo) error
	Update(todo *Todo) error
	Delete(id int) error
}

4. ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ์„ค์ •

db/postgres.go

package db

import (
	"database/sql"
	"fmt"
	_ "github.com/lib/pq"
)

type PostgresConfig struct {
	Host     string
	Port     string
	User     string
	Password string
	DBName   string
	SSLMode  string
}

func NewPostgresDB(cfg PostgresConfig) (*sql.DB, error) {
	connStr := fmt.Sprintf(
		"host=%s port=%s user=%s password=%s dbname=%s sslmode=%s",
		cfg.Host, cfg.Port, cfg.User, cfg.Password, cfg.DBName, cfg.SSLMode,
	)
	
	db, err := sql.Open("postgres", connStr)
	if err != nil {
		return nil, err
	}
	
	if err := db.Ping(); err != nil {
		return nil, err
	}
	
	// ํ…Œ์ด๋ธ” ์ƒ์„ฑ
	_, err = db.Exec(`
		CREATE TABLE IF NOT EXISTS todos (
			id SERIAL PRIMARY KEY,
			title TEXT NOT NULL,
			completed BOOLEAN DEFAULT FALSE,
			created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
			updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
		)
	`)
	if err != nil {
		return nil, err
	}
	
	return db, nil
}

db/redis.go

package db

import (
	"context"
	"github.com/go-redis/redis/v9"
)

type RedisConfig struct {
	Host     string
	Port     string
	Password string
	DB       int
}

func NewRedisClient(cfg RedisConfig) (*redis.Client, error) {
	client := redis.NewClient(&redis.Options{
		Addr:     cfg.Host + ":" + cfg.Port,
		Password: cfg.Password,
		DB:       cfg.DB,
	})
	
	// ์—ฐ๊ฒฐ ํ™•์ธ
	ctx := context.Background()
	if err := client.Ping(ctx).Err(); err != nil {
		return nil, err
	}
	
	return client, nil
}

5. API ํ•ธ๋“ค๋Ÿฌ ์ž‘์„ฑ

api/routes.go

package api

import (
	"database/sql"
	"github.com/gin-gonic/gin"
	"github.com/go-redis/redis/v9"
)

func SetupRouter(db *sql.DB, redisClient *redis.Client) *gin.Engine {
	router := gin.Default()
	
	// ๋ฏธ๋“ค์›จ์–ด ์„ค์ •
	router.Use(gin.Logger())
	router.Use(gin.Recovery())
	
	// ํ•ธ๋“ค๋Ÿฌ ์ดˆ๊ธฐํ™”
	handler := NewTodoHandler(db, redisClient)
	
	// ๋ผ์šฐํŠธ ์„ค์ •
	v1 := router.Group("/api/v1")
	{
		todos := v1.Group("/todos")
		{
			todos.GET("", handler.GetAllTodos)
			todos.GET("/:id", handler.GetTodo)
			todos.POST("", handler.CreateTodo)
			todos.PUT("/:id", handler.UpdateTodo)
			todos.DELETE("/:id", handler.DeleteTodo)
		}
	}
	
	return router
}

api/handlers.go

package api

import (
	"context"
	"database/sql"
	"encoding/json"
	"net/http"
	"strconv"
	"time"

	"github.com/gin-gonic/gin"
	"github.com/go-redis/redis/v9"
	"github.com/yourusername/todo-app/models"
)

type TodoHandler struct {
	db    *sql.DB
	redis *redis.Client
}

func NewTodoHandler(db *sql.DB, redis *redis.Client) *TodoHandler {
	return &TodoHandler{
		db:    db,
		redis: redis,
	}
}

// GetAllTodos ๋ชจ๋“  ํ•  ์ผ ๋ชฉ๋ก์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค
func (h *TodoHandler) GetAllTodos(c *gin.Context) {
	ctx := context.Background()
	
	// ์บ์‹œ์—์„œ ๋จผ์ € ํ™•์ธ
	cachedTodos, err := h.redis.Get(ctx, "todos:all").Result()
	if err == nil {
		var todos []models.Todo
		if err := json.Unmarshal([]byte(cachedTodos), &todos); err == nil {
			c.JSON(http.StatusOK, todos)
			return
		}
	}
	
	// DB์—์„œ ์กฐํšŒ
	rows, err := h.db.Query("SELECT id, title, completed, created_at, updated_at FROM todos")
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
		return
	}
	defer rows.Close()
	
	var todos []models.Todo
	for rows.Next() {
		var todo models.Todo
		if err := rows.Scan(&todo.ID, &todo.Title, &todo.Completed, &todo.CreatedAt, &todo.UpdatedAt); err != nil {
			c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
			return
		}
		todos = append(todos, todo)
	}
	
	// ์บ์‹œ์— ์ €์žฅ
	if todosJSON, err := json.Marshal(todos); err == nil {
		h.redis.Set(ctx, "todos:all", todosJSON, 5*time.Minute)
	}
	
	c.JSON(http.StatusOK, todos)
}

// GetTodo ํŠน์ • ID์˜ ํ•  ์ผ์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค
func (h *TodoHandler) GetTodo(c *gin.Context) {
	id, err := strconv.Atoi(c.Param("id"))
	if err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": "์œ ํšจํ•˜์ง€ ์•Š์€ ID"})
		return
	}
	
	ctx := context.Background()
	
	// ์บ์‹œ์—์„œ ๋จผ์ € ํ™•์ธ
	cacheKey := "todos:" + strconv.Itoa(id)
	cachedTodo, err := h.redis.Get(ctx, cacheKey).Result()
	if err == nil {
		var todo models.Todo
		if err := json.Unmarshal([]byte(cachedTodo), &todo); err == nil {
			c.JSON(http.StatusOK, todo)
			return
		}
	}
	
	// DB์—์„œ ์กฐํšŒ
	var todo models.Todo
	err = h.db.QueryRow(
		"SELECT id, title, completed, created_at, updated_at FROM todos WHERE id = $1",
		id,
	).Scan(&todo.ID, &todo.Title, &todo.Completed, &todo.CreatedAt, &todo.UpdatedAt)
	
	if err == sql.ErrNoRows {
		c.JSON(http.StatusNotFound, gin.H{"error": "ํ•  ์ผ์„ ์ฐพ์„ ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค"})
		return
	} else if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
		return
	}
	
	// ์บ์‹œ์— ์ €์žฅ
	if todoJSON, err := json.Marshal(todo); err == nil {
		h.redis.Set(ctx, cacheKey, todoJSON, 5*time.Minute)
	}
	
	c.JSON(http.StatusOK, todo)
}

// CreateTodo ์ƒˆ๋กœ์šด ํ•  ์ผ์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค
func (h *TodoHandler) CreateTodo(c *gin.Context) {
	var input struct {
		Title string `json:"title" binding:"required"`
	}
	
	if err := c.ShouldBindJSON(&input); err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		return
	}
	
	now := time.Now()
	var id int
	err := h.db.QueryRow(
		"INSERT INTO todos (title, completed, created_at, updated_at) VALUES ($1, $2, $3, $4) RETURNING id",
		input.Title, false, now, now,
	).Scan(&id)
	
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
		return
	}
	
	todo := models.Todo{
		ID:        id,
		Title:     input.Title,
		Completed: false,
		CreatedAt: now,
		UpdatedAt: now,
	}
	
	// ์บ์‹œ ๋ฌดํšจํ™”
	ctx := context.Background()
	h.redis.Del(ctx, "todos:all")
	
	c.JSON(http.StatusCreated, todo)
}

// UpdateTodo ํ•  ์ผ์„ ์—…๋ฐ์ดํŠธํ•ฉ๋‹ˆ๋‹ค
func (h *TodoHandler) UpdateTodo(c *gin.Context) {
	id, err := strconv.Atoi(c.Param("id"))
	if err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": "์œ ํšจํ•˜์ง€ ์•Š์€ ID"})
		return
	}
	
	var input struct {
		Title     *string `json:"title"`
		Completed *bool   `json:"completed"`
	}
	
	if err := c.ShouldBindJSON(&input); err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		return
	}
	
	// ํ˜„์žฌ ํ•  ์ผ ์กฐํšŒ
	var todo models.Todo
	err = h.db.QueryRow(
		"SELECT id, title, completed, created_at, updated_at FROM todos WHERE id = $1",
		id,
	).Scan(&todo.ID, &todo.Title, &todo.Completed, &todo.CreatedAt, &todo.UpdatedAt)
	
	if err == sql.ErrNoRows {
		c.JSON(http.StatusNotFound, gin.H{"error": "ํ•  ์ผ์„ ์ฐพ์„ ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค"})
		return
	} else if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
		return
	}
	
	// ์—…๋ฐ์ดํŠธํ•  ํ•„๋“œ ์„ค์ •
	if input.Title != nil {
		todo.Title = *input.Title
	}
	if input.Completed != nil {
		todo.Completed = *input.Completed
	}
	
	// ์—…๋ฐ์ดํŠธ ์‹คํ–‰
	now := time.Now()
	_, err = h.db.Exec(
		"UPDATE todos SET title = $1, completed = $2, updated_at = $3 WHERE id = $4",
		todo.Title, todo.Completed, now, id,
	)
	
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
		return
	}
	
	todo.UpdatedAt = now
	
	// ์บ์‹œ ๋ฌดํšจํ™”
	ctx := context.Background()
	h.redis.Del(ctx, "todos:all", "todos:"+strconv.Itoa(id))
	
	c.JSON(http.StatusOK, todo)
}

// DeleteTodo ํ•  ์ผ์„ ์‚ญ์ œํ•ฉ๋‹ˆ๋‹ค
func (h *TodoHandler) DeleteTodo(c *gin.Context) {
	id, err := strconv.Atoi(c.Param("id"))
	if err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": "์œ ํšจํ•˜์ง€ ์•Š์€ ID"})
		return
	}
	
	result, err := h.db.Exec("DELETE FROM todos WHERE id = $1", id)
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
		return
	}
	
	rowsAffected, err := result.RowsAffected()
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
		return
	}
	
	if rowsAffected == 0 {
		c.JSON(http.StatusNotFound, gin.H{"error": "ํ•  ์ผ์„ ์ฐพ์„ ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค"})
		return
	}
	
	// ์บ์‹œ ๋ฌดํšจํ™”
	ctx := context.Background()
	h.redis.Del(ctx, "todos:all", "todos:"+strconv.Itoa(id))
	
	c.JSON(http.StatusOK, gin.H{"message": "ํ•  ์ผ์ด ์‚ญ์ œ๋˜์—ˆ์Šต๋‹ˆ๋‹ค"})
}

6. ์„ค์ • ๊ด€๋ฆฌ

config/config.go

package config

import (
	"github.com/spf13/viper"
	"github.com/yourusername/todo-app/db"
)

type Config struct {
	Server struct {
		Port string
	}
	Database db.PostgresConfig
	Redis    db.RedisConfig
}

func Load() (*Config, error) {
	viper.SetDefault("server.port", "8080")
	
	viper.SetDefault("database.host", "db")
	viper.SetDefault("database.port", "5432")
	viper.SetDefault("database.user", "postgres")
	viper.SetDefault("database.password", "postgres")
	viper.SetDefault("database.dbname", "goapp")
	viper.SetDefault("database.sslmode", "disable")
	
	viper.SetDefault("redis.host", "redis")
	viper.SetDefault("redis.port", "6379")
	viper.SetDefault("redis.password", "")
	viper.SetDefault("redis.db", 0)
	
	viper.AutomaticEnv()
	
	var config Config
	
	config.Server.Port = viper.GetString("server.port")
	
	config.Database.Host = viper.GetString("database.host")
	config.Database.Port = viper.GetString("database.port")
	config.Database.User = viper.GetString("database.user")
	config.Database.Password = viper.GetString("database.password")
	config.Database.DBName = viper.GetString("database.dbname")
	config.Database.SSLMode = viper.GetString("database.sslmode")
	
	config.Redis.Host = viper.GetString("redis.host")
	config.Redis.Port = viper.GetString("redis.port")
	config.Redis.Password = viper.GetString("redis.password")
	config.Redis.DB = viper.GetInt("redis.db")
	
	return &config, nil
}

7. Docker ์„ค์ • ํŒŒ์ผ ์ž‘์„ฑ

Dockerfile

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

WORKDIR /app

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

COPY . .

RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main .

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

RUN apk --no-cache add ca-certificates

WORKDIR /root/

COPY --from=builder /app/main .

EXPOSE 8080

CMD ["./main"]

Dockerfile.dev

FROM golang:1.22

WORKDIR /app

# ๋ผ์ด๋ธŒ ๋ฆฌ๋กœ๋”ฉ์„ ์œ„ํ•œ Air ์„ค์น˜
RUN go install github.com/cosmtrek/air@latest

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

# ์†Œ์Šค ์ฝ”๋“œ๋Š” ๋ณผ๋ฅจ ๋งˆ์šดํŠธ๋กœ ์ œ๊ณตํ•  ์˜ˆ์ •
CMD ["air", "-c", ".air.toml"]

docker-compose.yml

version: '3.9'

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile.dev
    ports:
      - "8080:8080"
    volumes:
      - .:/app
    depends_on:
      - db
      - redis
    environment:
      - DATABASE_HOST=db
      - DATABASE_PORT=5432
      - DATABASE_USER=postgres
      - DATABASE_PASSWORD=postgres
      - DATABASE_DBNAME=goapp
      - DATABASE_SSLMODE=disable
      - REDIS_HOST=redis
      - REDIS_PORT=6379

  db:
    image: postgres:16-alpine
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=goapp
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data

volumes:
  postgres_data:
  redis_data:

8. ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์‹คํ–‰ํ•˜๊ธฐ

์ด์ œ ๋ชจ๋“  ํŒŒ์ผ์„ ์ž‘์„ฑํ–ˆ์œผ๋‹ˆ Docker Compose๋ฅผ ์‚ฌ์šฉํ•ด ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์‹คํ–‰ํ•ด๋ณด์ž:

docker-compose up -d

์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ด ์‹คํ–‰๋˜๋ฉด http://localhost:8080/api/v1/todos ์ฃผ์†Œ๋กœ API์— ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ์–ด!

๐Ÿงช API ํ…Œ์ŠคํŠธํ•˜๊ธฐ

1. ํ•  ์ผ ์ถ”๊ฐ€ํ•˜๊ธฐ

curl -X POST http://localhost:8080/api/v1/todos \
  -H "Content-Type: application/json" \
  -d '{"title": "Docker๋กœ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋ฐฐํฌํ•˜๊ธฐ"}'

2. ํ•  ์ผ ๋ชฉ๋ก ์กฐํšŒํ•˜๊ธฐ

curl http://localhost:8080/api/v1/todos

3. ํ•  ์ผ ์™„๋ฃŒ ์ƒํƒœ ๋ณ€๊ฒฝํ•˜๊ธฐ

curl -X PUT http://localhost:8080/api/v1/todos/1 \
  -H "Content-Type: application/json" \
  -d '{"completed": true}'

4. ํ•  ์ผ ์‚ญ์ œํ•˜๊ธฐ

curl -X DELETE http://localhost:8080/api/v1/todos/1

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

8. ๋ฌธ์ œ ํ•ด๊ฒฐ๊ณผ ๋””๋ฒ„๊น… ํŒ ๐Ÿ”

Docker์™€ Go๋ฅผ ํ•จ๊ป˜ ์‚ฌ์šฉํ•˜๋‹ค ๋ณด๋ฉด ๋‹ค์–‘ํ•œ ๋ฌธ์ œ๊ฐ€ ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ์–ด. ์—ฌ๊ธฐ์„œ๋Š” ์ž์ฃผ ๋ฐœ์ƒํ•˜๋Š” ๋ฌธ์ œ์™€ ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•์„ ์•Œ์•„๋ณด์ž!

๐Ÿž ์ž์ฃผ ๋ฐœ์ƒํ•˜๋Š” ๋ฌธ์ œ์™€ ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•

1. ์ปจํ…Œ์ด๋„ˆ๊ฐ€ ์‹œ์ž‘๋˜์ง€ ์•Š๋Š” ๋ฌธ์ œ

์ปจํ…Œ์ด๋„ˆ๊ฐ€ ์‹œ์ž‘๋˜์—ˆ๋‹ค๊ฐ€ ๋ฐ”๋กœ ์ข…๋ฃŒ๋˜๋Š” ๊ฒฝ์šฐ๊ฐ€ ๋งŽ์•„. ์ด๋Ÿฐ ๊ฒฝ์šฐ ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๋ช…๋ น์–ด๋กœ ๋กœ๊ทธ๋ฅผ ํ™•์ธํ•ด๋ณด์ž:

docker logs [container_id]

๋Œ€๋ถ€๋ถ„ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋‚ด๋ถ€ ์˜ค๋ฅ˜๋‚˜ ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ • ๋ฌธ์ œ์ผ ๊ฐ€๋Šฅ์„ฑ์ด ๋†’์•„.

2. ๋ณผ๋ฅจ ๋งˆ์šดํŠธ ๋ฌธ์ œ

๋ณผ๋ฅจ์ด ์ œ๋Œ€๋กœ ๋งˆ์šดํŠธ๋˜์ง€ ์•Š์•„ ์ฝ”๋“œ ๋ณ€๊ฒฝ์ด ๋ฐ˜์˜๋˜์ง€ ์•Š๋Š” ๊ฒฝ์šฐ๊ฐ€ ์žˆ์–ด. ๋‹ค์Œ ๋ช…๋ น์–ด๋กœ ๋ณผ๋ฅจ ์ƒํƒœ๋ฅผ ํ™•์ธํ•ด๋ณด์ž:

docker-compose exec app ls -la

Windows์—์„œ๋Š” ๊ฒฝ๋กœ ํ˜•์‹์ด ๋‹ค๋ฅด๊ธฐ ๋•Œ๋ฌธ์— ๋ฌธ์ œ๊ฐ€ ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ์–ด. Docker Desktop ์„ค์ •์—์„œ ๊ณต์œ  ๋“œ๋ผ์ด๋ธŒ๋ฅผ ํ™•์ธํ•ด๋ณด์ž.

3. ๋„คํŠธ์›Œํฌ ์—ฐ๊ฒฐ ๋ฌธ์ œ

์„œ๋น„์Šค ๊ฐ„ ์—ฐ๊ฒฐ์ด ์•ˆ ๋˜๋Š” ๊ฒฝ์šฐ, ์„œ๋น„์Šค ์ด๋ฆ„์œผ๋กœ ์ ‘๊ทผํ•˜๊ณ  ์žˆ๋Š”์ง€ ํ™•์ธํ•ด๋ณด์ž. Docker Compose ๋„คํŠธ์›Œํฌ์—์„œ๋Š” ์„œ๋น„์Šค ์ด๋ฆ„์ด ํ˜ธ์ŠคํŠธ ์ด๋ฆ„์œผ๋กœ ์‚ฌ์šฉ๋ผ.

docker-compose exec app ping db
docker-compose exec app ping redis

4. ํฌํŠธ ์ถฉ๋Œ ๋ฌธ์ œ

์ด๋ฏธ ์‚ฌ์šฉ ์ค‘์ธ ํฌํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๋ ค๊ณ  ํ•˜๋ฉด ์ปจํ…Œ์ด๋„ˆ๊ฐ€ ์‹œ์ž‘๋˜์ง€ ์•Š์•„. ๋‹ค์Œ ๋ช…๋ น์–ด๋กœ ํฌํŠธ ์‚ฌ์šฉ ์ƒํƒœ๋ฅผ ํ™•์ธํ•ด๋ณด์ž:

# Linux/macOS
lsof -i :8080

# Windows
netstat -ano | findstr :8080

์ถฉ๋Œ์ด ๋ฐœ์ƒํ•˜๋ฉด docker-compose.yml ํŒŒ์ผ์—์„œ ํฌํŠธ ๋งคํ•‘์„ ๋ณ€๊ฒฝํ•˜๋ฉด ๋ผ.

5. ๋นŒ๋“œ ์บ์‹œ ๋ฌธ์ œ

์ฝ”๋“œ๋ฅผ ๋ณ€๊ฒฝํ–ˆ๋Š”๋ฐ๋„ ๋ณ€๊ฒฝ์‚ฌํ•ญ์ด ๋ฐ˜์˜๋˜์ง€ ์•Š๋Š” ๊ฒฝ์šฐ, ๋นŒ๋“œ ์บ์‹œ ๋•Œ๋ฌธ์ผ ์ˆ˜ ์žˆ์–ด. ๋‹ค์Œ ๋ช…๋ น์–ด๋กœ ์บ์‹œ ์—†์ด ๋‹ค์‹œ ๋นŒ๋“œํ•ด๋ณด์ž:

docker-compose build --no-cache
docker-compose up -d

๐Ÿ”ง Docker ํ™˜๊ฒฝ์—์„œ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋””๋ฒ„๊น…ํ•˜๊ธฐ

1. ๋กœ๊ทธ ํ™•์ธํ•˜๊ธฐ

๊ฐ€์žฅ ๊ธฐ๋ณธ์ ์ธ ๋””๋ฒ„๊น… ๋ฐฉ๋ฒ•์€ ๋กœ๊ทธ๋ฅผ ํ™•์ธํ•˜๋Š” ๊ฑฐ์•ผ:

docker-compose logs -f app

2. ์ปจํ…Œ์ด๋„ˆ ๋‚ด๋ถ€ ์ ‘์†ํ•˜๊ธฐ

์ปจํ…Œ์ด๋„ˆ ๋‚ด๋ถ€์— ์ ‘์†ํ•ด์„œ ์ง์ ‘ ํ™•์ธํ•  ์ˆ˜ ์žˆ์–ด:

docker-compose exec app sh

3. Delve๋ฅผ ์‚ฌ์šฉํ•œ ์›๊ฒฉ ๋””๋ฒ„๊น…

Go์˜ ๋””๋ฒ„๊ฑฐ์ธ Delve๋ฅผ ์‚ฌ์šฉํ•ด ์›๊ฒฉ ๋””๋ฒ„๊น…์„ ์„ค์ •ํ•  ์ˆ˜ ์žˆ์–ด. Dockerfile.dev๋ฅผ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์ˆ˜์ •ํ•ด๋ณด์ž:

FROM golang:1.22

WORKDIR /app

# Delve ์„ค์น˜
RUN go install github.com/go-delve/delve/cmd/dlv@latest

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

EXPOSE 8080 2345

# ๋””๋ฒ„๊น… ๋ชจ๋“œ๋กœ ์‹คํ–‰
CMD ["dlv", "debug", "--headless", "--listen=:2345", "--api-version=2", "--accept-multiclient", "--continue", "--log"]

๊ทธ๋ฆฌ๊ณ  docker-compose.yml ํŒŒ์ผ์— ๋””๋ฒ„๊น… ํฌํŠธ๋ฅผ ์ถ”๊ฐ€ํ•ด:

ports:
  - "8080:8080"
  - "2345:2345"  # ๋””๋ฒ„๊น… ํฌํŠธ

VS Code์—์„œ launch.json ํŒŒ์ผ์„ ์„ค์ •ํ•˜๋ฉด ๋ธŒ๋ ˆ์ดํฌํฌ์ธํŠธ๋ฅผ ์„ค์ •ํ•˜๊ณ  ๋ณ€์ˆ˜๋ฅผ ๊ฒ€์‚ฌํ•  ์ˆ˜ ์žˆ์–ด!

์„ฑ๋Šฅ ์ตœ์ ํ™” ํŒ

Docker ํ™˜๊ฒฝ์—์„œ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์˜ ์„ฑ๋Šฅ์„ ์ตœ์ ํ™”ํ•˜๋Š” ๋ฐฉ๋ฒ•๋„ ์•Œ์•„๋ณด์ž:

  1. ๋ฉ€ํ‹ฐ ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ ์‚ฌ์šฉํ•˜๊ธฐ: ์ตœ์ข… ์ด๋ฏธ์ง€ ํฌ๊ธฐ๋ฅผ ์ค„์—ฌ ๋ฐฐํฌ ์†๋„๋ฅผ ๋†’์ด๊ณ  ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉ๋Ÿ‰์„ ์ค„์ผ ์ˆ˜ ์žˆ์–ด.
  2. ์ ์ ˆํ•œ ๋ฒ ์ด์Šค ์ด๋ฏธ์ง€ ์„ ํƒํ•˜๊ธฐ: Alpine ๊ธฐ๋ฐ˜ ์ด๋ฏธ์ง€๋Š” ํฌ๊ธฐ๊ฐ€ ์ž‘์ง€๋งŒ, ์ผ๋ถ€ C ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์˜์กด์„ฑ์ด ์žˆ๋Š” ๊ฒฝ์šฐ ๋ฌธ์ œ๊ฐ€ ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ์–ด. ํ•„์š”์— ๋”ฐ๋ผ ์ ์ ˆํ•œ ์ด๋ฏธ์ง€๋ฅผ ์„ ํƒํ•˜์ž.
  3. ๋ถˆํ•„์š”ํ•œ ํŒŒ์ผ ์ œ์™ธํ•˜๊ธฐ: .dockerignore ํŒŒ์ผ์„ ์‚ฌ์šฉํ•ด ๋นŒ๋“œ ์ปจํ…์ŠคํŠธ์—์„œ ๋ถˆํ•„์š”ํ•œ ํŒŒ์ผ์„ ์ œ์™ธํ•˜๋ฉด ๋นŒ๋“œ ์†๋„๊ฐ€ ํ–ฅ์ƒ๋ผ.
  4. ์ปจํ…Œ์ด๋„ˆ ๋ฆฌ์†Œ์Šค ์ œํ•œํ•˜๊ธฐ: docker-compose.yml ํŒŒ์ผ์—์„œ CPU์™€ ๋ฉ”๋ชจ๋ฆฌ ์ œํ•œ์„ ์„ค์ •ํ•ด ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉ๋Ÿ‰์„ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด.
  5. ํšจ์œจ์ ์ธ ๋ ˆ์ด์–ด ์บ์‹ฑ: ์ž์ฃผ ๋ณ€๊ฒฝ๋˜๋Š” ํŒŒ์ผ์€ Dockerfile์˜ ๋งˆ์ง€๋ง‰ ๋ถ€๋ถ„์— ๋ณต์‚ฌํ•ด ๋นŒ๋“œ ์บ์‹œ๋ฅผ ํšจ์œจ์ ์œผ๋กœ ํ™œ์šฉํ•˜์ž.
Docker + Go ๋””๋ฒ„๊น… ์›Œํฌํ”Œ๋กœ์šฐ ๊ฐœ๋ฐœ์ž VS Code Delve Go ์•ฑ Docker ์ปจํ…Œ์ด๋„ˆ ๋กœ๊ทธ ์ฝ”๋“œ ํŽธ์ง‘ ๋””๋ฒ„๊น… ์‹คํ–‰ ๋กœ๊น… ๋กœ๊ทธ ํ™•์ธ ๋””๋ฒ„๊น… ๋‹จ๊ณ„ 1. ๋ธŒ๋ ˆ์ดํฌํฌ์ธํŠธ ์„ค์ • 2. ๋””๋ฒ„๊น… ์‹œ์ž‘ 3. ๋ณ€์ˆ˜ ๊ฒ€์‚ฌ 4. ์ฝ”๋“œ ๋‹จ๊ณ„ ์‹คํ–‰ 5. ์ฝœ ์Šคํƒ ํ™•์ธ 6. ๋กœ๊ทธ ๋ถ„์„ 7. ๋ฌธ์ œ ํ•ด๊ฒฐ

Docker ํ™˜๊ฒฝ์—์„œ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๋””๋ฒ„๊น…ํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ๊ฒŒ ๋˜์—ˆ์–ด! ์ด์ œ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์œผ๋กœ ๋ฐฐํฌํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ์•„๋ณด์ž.

9. ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์œผ๋กœ ๋ฐฐํฌํ•˜๊ธฐ ๐Ÿš€

๊ฐœ๋ฐœ์ด ์™„๋ฃŒ๋˜๋ฉด ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์— ๋ฐฐํฌํ•ด์•ผ ํ•ด. Docker๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ๊ฐœ๋ฐœ ํ™˜๊ฒฝ๊ณผ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์˜ ์ฐจ์ด๋ฅผ ์ตœ์†Œํ™”ํ•  ์ˆ˜ ์žˆ์–ด. ์—ฌ๊ธฐ์„œ๋Š” Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์— ๋ฐฐํฌํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ์•„๋ณด์ž!

๐Ÿ”’ ํ”„๋กœ๋•์…˜ ๋ฐฐํฌ ์‹œ ๊ณ ๋ ค์‚ฌํ•ญ

1. ๋ณด์•ˆ

ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” ๋ณด์•ˆ์ด ์ตœ์šฐ์„ ์ด์•ผ. ๋‹ค์Œ๊ณผ ๊ฐ™์€ ์‚ฌํ•ญ์„ ๊ณ ๋ คํ•ด์•ผ ํ•ด:

  1. ๋น„๋ฐ€๋ฒˆํ˜ธ, API ํ‚ค ๋“ฑ์˜ ๋ฏผ๊ฐํ•œ ์ •๋ณด๋Š” ํ™˜๊ฒฝ ๋ณ€์ˆ˜๋‚˜ Docker Secrets๋ฅผ ์‚ฌ์šฉํ•ด ๊ด€๋ฆฌํ•˜์ž.
  2. ๋ฃจํŠธ๊ฐ€ ์•„๋‹Œ ์ผ๋ฐ˜ ์‚ฌ์šฉ์ž๋กœ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์‹คํ–‰ํ•˜์ž.
  3. ํ•„์š”ํ•œ ํฌํŠธ๋งŒ ๋…ธ์ถœํ•˜๊ณ , ๋‚ด๋ถ€ ์„œ๋น„์Šค๋Š” ์™ธ๋ถ€์— ๋…ธ์ถœํ•˜์ง€ ๋ง์ž.
  4. ์ด๋ฏธ์ง€๋ฅผ ์ •๊ธฐ์ ์œผ๋กœ ์Šค์บ”ํ•˜์—ฌ ์ทจ์•ฝ์ ์„ ํ™•์ธํ•˜์ž.

2. ์„ฑ๋Šฅ ์ตœ์ ํ™”

ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” ์„ฑ๋Šฅ์ด ์ค‘์š”ํ•ด. ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๋ฐฉ๋ฒ•์œผ๋กœ ์„ฑ๋Šฅ์„ ์ตœ์ ํ™”ํ•  ์ˆ˜ ์žˆ์–ด:

  1. ๋ฉ€ํ‹ฐ ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ๋ฅผ ์‚ฌ์šฉํ•ด ์ด๋ฏธ์ง€ ํฌ๊ธฐ๋ฅผ ์ตœ์†Œํ™”ํ•˜์ž.
  2. Alpine ๊ธฐ๋ฐ˜ ์ด๋ฏธ์ง€๋ฅผ ์‚ฌ์šฉํ•ด ์ปจํ…Œ์ด๋„ˆ ํฌ๊ธฐ๋ฅผ ์ค„์ด์ž.
  3. Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ ์ •์  ๋งํฌ๋กœ ๋นŒ๋“œํ•ด ์˜์กด์„ฑ ๋ฌธ์ œ๋ฅผ ๋ฐฉ์ง€ํ•˜์ž.
  4. ์ปจํ…Œ์ด๋„ˆ ๋ฆฌ์†Œ์Šค ์ œํ•œ์„ ์„ค์ •ํ•ด ๋ฆฌ์†Œ์Šค ์‚ฌ์šฉ๋Ÿ‰์„ ๊ด€๋ฆฌํ•˜์ž.

3. ๊ฐ€์šฉ์„ฑ

ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” ๋†’์€ ๊ฐ€์šฉ์„ฑ์ด ํ•„์š”ํ•ด. ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๋ฐฉ๋ฒ•์œผ๋กœ ๊ฐ€์šฉ์„ฑ์„ ๋†’์ผ ์ˆ˜ ์žˆ์–ด:

  1. ์—ฌ๋Ÿฌ ์ธ์Šคํ„ด์Šค๋ฅผ ์‹คํ–‰ํ•˜์—ฌ ๋กœ๋“œ ๋ฐธ๋Ÿฐ์‹ฑ์„ ๊ตฌํ˜„ํ•˜์ž.
  2. ํ—ฌ์Šค ์ฒดํฌ๋ฅผ ๊ตฌํ˜„ํ•˜์—ฌ ์žฅ์• ๊ฐ€ ๋ฐœ์ƒํ•œ ์ปจํ…Œ์ด๋„ˆ๋ฅผ ์ž๋™์œผ๋กœ ์žฌ์‹œ์ž‘ํ•˜์ž.
  3. ๋กค๋ง ์—…๋ฐ์ดํŠธ๋ฅผ ์‚ฌ์šฉํ•ด ๋‹ค์šดํƒ€์ž„ ์—†์ด ์—…๋ฐ์ดํŠธํ•˜์ž.
  4. ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์™€ ๊ฐ™์€ ์ƒํƒœ ์ €์žฅ ์„œ๋น„์Šค๋Š” ์ ์ ˆํ•œ ๋ฐฑ์—… ์ „๋žต์„ ์ˆ˜๋ฆฝํ•˜์ž.

4. ๋ชจ๋‹ˆํ„ฐ๋ง

ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” ๋ชจ๋‹ˆํ„ฐ๋ง์ด ํ•„์ˆ˜์•ผ. ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๋„๊ตฌ๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์–ด:

  1. Prometheus: ๋ฉ”ํŠธ๋ฆญ ์ˆ˜์ง‘ ๋ฐ ์•Œ๋ฆผ
  2. Grafana: ๋ฉ”ํŠธ๋ฆญ ์‹œ๊ฐํ™”
  3. ELK Stack ๋˜๋Š” Loki: ๋กœ๊ทธ ์ˆ˜์ง‘ ๋ฐ ๋ถ„์„
  4. Jaeger ๋˜๋Š” Zipkin: ๋ถ„์‚ฐ ํŠธ๋ ˆ์ด์‹ฑ

๋ฐฐํฌ ์˜ต์…˜

Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ Docker๋กœ ๋ฐฐํฌํ•˜๋Š” ๋ฐฉ๋ฒ•์€ ์—ฌ๋Ÿฌ ๊ฐ€์ง€๊ฐ€ ์žˆ์–ด. 2025๋…„ ํ˜„์žฌ ๊ฐ€์žฅ ๋งŽ์ด ์‚ฌ์šฉ๋˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ์•„๋ณด์ž!

1. ๋‹จ์ผ ์„œ๋ฒ„ ๋ฐฐํฌ

๊ฐ€์žฅ ๊ฐ„๋‹จํ•œ ๋ฐฉ๋ฒ•์€ ๋‹จ์ผ ์„œ๋ฒ„์— Docker Compose๋ฅผ ์‚ฌ์šฉํ•ด ๋ฐฐํฌํ•˜๋Š” ๊ฑฐ์•ผ. ํ”„๋กœ๋•์…˜์šฉ docker-compose.yml ํŒŒ์ผ์„ ์‚ฌ์šฉํ•ด ๋‹ค์Œ๊ณผ ๊ฐ™์ด ๋ฐฐํฌํ•  ์ˆ˜ ์žˆ์–ด:

docker-compose -f docker-compose.prod.yml up -d

์ด ๋ฐฉ๋ฒ•์€ ์†Œ๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ๋‚˜ ๊ฐœ์ธ ํ”„๋กœ์ ํŠธ์— ์ ํ•ฉํ•ด.

2. Docker Swarm

Docker Swarm์€ Docker์˜ ๋‚ด์žฅ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ๋„๊ตฌ์•ผ. ์—ฌ๋Ÿฌ ์„œ๋ฒ„์— ๊ฑธ์ณ ์ปจํ…Œ์ด๋„ˆ๋ฅผ ๋ฐฐํฌํ•˜๊ณ  ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด:

# Swarm ์ดˆ๊ธฐํ™”
docker swarm init

# ์Šคํƒ ๋ฐฐํฌ
docker stack deploy -c docker-compose.prod.yml myapp

Docker Swarm์€ ์„ค์ •์ด ๊ฐ„๋‹จํ•˜๊ณ  Docker Compose ํŒŒ์ผ์„ ๊ทธ๋Œ€๋กœ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์–ด์„œ ์ข‹์•„.

3. Kubernetes

Kubernetes๋Š” ํ˜„์žฌ ๊ฐ€์žฅ ์ธ๊ธฐ ์žˆ๋Š” ์ปจํ…Œ์ด๋„ˆ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ํ”Œ๋žซํผ์ด์•ผ. 2025๋…„์—๋Š” ๋”์šฑ ๋ฐœ์ „ํ•˜์—ฌ ์‚ฌ์šฉํ•˜๊ธฐ ์‰ฌ์›Œ์กŒ์–ด! Docker Compose ํŒŒ์ผ์„ Kubernetes ๋งค๋‹ˆํŽ˜์ŠคํŠธ๋กœ ๋ณ€ํ™˜ํ•  ์ˆ˜๋„ ์žˆ์–ด:

kompose convert -f docker-compose.prod.yml

๊ทธ๋ฆฌ๊ณ  ๋‹ค์Œ๊ณผ ๊ฐ™์ด ๋ฐฐํฌํ•  ์ˆ˜ ์žˆ์–ด:

kubectl apply -f k8s/

Kubernetes๋Š” ๋Œ€๊ทœ๋ชจ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜๊ณผ ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ์•„ํ‚คํ…์ฒ˜์— ์ ํ•ฉํ•ด.

4. ํด๋ผ์šฐ๋“œ ์„œ๋น„์Šค

2025๋…„ ํ˜„์žฌ, ๋ชจ๋“  ์ฃผ์š” ํด๋ผ์šฐ๋“œ ์ œ๊ณต์—…์ฒด๋Š” ์ปจํ…Œ์ด๋„ˆ ๋ฐฐํฌ๋ฅผ ์œ„ํ•œ ์„œ๋น„์Šค๋ฅผ ์ œ๊ณตํ•˜๊ณ  ์žˆ์–ด:

  1. AWS: ECS, EKS, App Runner
  2. Google Cloud: GKE, Cloud Run
  3. Azure: AKS, Container Instances
  4. Digital Ocean: App Platform, Kubernetes

์ด๋Ÿฐ ์„œ๋น„์Šค๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ์ธํ”„๋ผ ๊ด€๋ฆฌ ๋ถ€๋‹ด์„ ์ค„์ด๊ณ  ํ™•์žฅ์„ฑ, ๊ฐ€์šฉ์„ฑ, ๋ณด์•ˆ ๋“ฑ์˜ ์ด์ ์„ ์–ป์„ ์ˆ˜ ์žˆ์–ด.

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

์ž๋™ํ™”๋œ CI/CD ํŒŒ์ดํ”„๋ผ์ธ์„ ๊ตฌ์ถ•ํ•˜๋ฉด ๊ฐœ๋ฐœ๊ณผ ๋ฐฐํฌ ๊ณผ์ •์„ ๋”์šฑ ํšจ์œจ์ ์œผ๋กœ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด. ๋‹ค์Œ์€ GitHub Actions๋ฅผ ์‚ฌ์šฉํ•œ CI/CD ํŒŒ์ดํ”„๋ผ์ธ์˜ ์˜ˆ์‹œ์•ผ:

name: Go Docker CI/CD Pipeline

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    
    - name: Set up Go
      uses: actions/setup-go@v5
      with:
        go-version: '1.22'
    
    - name: Run tests
      run: go test -v ./...
  
  build-and-push:
    needs: test
    runs-on: ubuntu-latest
    if: github.event_name != 'pull_request'
    steps:
    - uses: actions/checkout@v4
    
    - name: Set up Docker Buildx
      uses: docker/setup-buildx-action@v3
    
    - name: Login to Docker Hub
      uses: docker/login-action@v3
      with:
        username: ${{ secrets.DOCKER_HUB_USERNAME }}
        password: ${{ secrets.DOCKER_HUB_TOKEN }}
    
    - name: Build and push
      uses: docker/build-push-action@v5
      with:
        context: .
        push: true
        tags: username/myapp:latest,username/myapp:${{ github.sha }}
  
  deploy:
    needs: build-and-push
    runs-on: ubuntu-latest
    if: github.event_name != 'pull_request'
    steps:
    - name: Deploy to production
      uses: appleboy/ssh-action@master
      with:
        host: ${{ secrets.PROD_HOST }}
        username: ${{ secrets.PROD_USERNAME }}
        key: ${{ secrets.PROD_SSH_KEY }}
        script: |
          cd /opt/myapp
          docker-compose pull
          docker-compose up -d

์ด ํŒŒ์ดํ”„๋ผ์ธ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๋‹จ๊ณ„๋กœ ๊ตฌ์„ฑ๋ผ:

  1. ํ…Œ์ŠคํŠธ: Go ํ…Œ์ŠคํŠธ๋ฅผ ์‹คํ–‰ํ•ด ์ฝ”๋“œ ํ’ˆ์งˆ์„ ํ™•์ธํ•ด.
  2. ๋นŒ๋“œ ๋ฐ ํ‘ธ์‹œ: Docker ์ด๋ฏธ์ง€๋ฅผ ๋นŒ๋“œํ•˜๊ณ  Docker Hub์— ํ‘ธ์‹œํ•ด.
  3. ๋ฐฐํฌ: SSH๋ฅผ ํ†ตํ•ด ํ”„๋กœ๋•์…˜ ์„œ๋ฒ„์— ์ ‘์†ํ•˜์—ฌ ์ตœ์‹  ์ด๋ฏธ์ง€๋กœ ์—…๋ฐ์ดํŠธํ•ด.

ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์„ ์œ„ํ•œ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ตœ์ ํ™”

ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์ตœ์ ํ™”ํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ์•„๋ณด์ž:

  1. ์ •์  ๋งํฌ: CGO_ENABLED=0 ์˜ต์…˜์„ ์‚ฌ์šฉํ•ด ์ •์  ๋ฐ”์ด๋„ˆ๋ฆฌ๋ฅผ ๋นŒ๋“œํ•˜๋ฉด ์˜์กด์„ฑ ๋ฌธ์ œ๋ฅผ ๋ฐฉ์ง€ํ•  ์ˆ˜ ์žˆ์–ด.
  2. ์ตœ์ ํ™” ํ”Œ๋ž˜๊ทธ: -ldflags="-s -w" ์˜ต์…˜์„ ์‚ฌ์šฉํ•ด ๋””๋ฒ„๊น… ์ •๋ณด๋ฅผ ์ œ๊ฑฐํ•˜๊ณ  ๋ฐ”์ด๋„ˆ๋ฆฌ ํฌ๊ธฐ๋ฅผ ์ค„์ผ ์ˆ˜ ์žˆ์–ด.
  3. ๋ฉ€ํ‹ฐ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ: ๋นŒ๋“œ ํ™˜๊ฒฝ๊ณผ ์‹คํ–‰ ํ™˜๊ฒฝ์„ ๋ถ„๋ฆฌํ•ด ์ตœ์ข… ์ด๋ฏธ์ง€ ํฌ๊ธฐ๋ฅผ ์ค„์ผ ์ˆ˜ ์žˆ์–ด.
  4. ์ ์ ˆํ•œ Go ๋ฒ„์ „ ์„ ํƒ: ์ตœ์‹  Go ๋ฒ„์ „์€ ์„ฑ๋Šฅ ๊ฐœ์„ ๊ณผ ๋ณด์•ˆ ํŒจ์น˜๊ฐ€ ํฌํ•จ๋˜์–ด ์žˆ์–ด.
  5. ํ”„๋กœํŒŒ์ผ๋ง ๋„๊ตฌ ํ™œ์šฉ: pprof๋ฅผ ์‚ฌ์šฉํ•ด CPU, ๋ฉ”๋ชจ๋ฆฌ ์‚ฌ์šฉ๋Ÿ‰์„ ๋ถ„์„ํ•˜๊ณ  ์ตœ์ ํ™”ํ•  ์ˆ˜ ์žˆ์–ด.
Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋ฐฐํฌ ์•„ํ‚คํ…์ฒ˜ CI/CD ํŒŒ์ดํ”„๋ผ์ธ (GitHub Actions, GitLab CI, Jenkins) ๋‹จ์ผ ์„œ๋ฒ„ Docker Compose Traefik/Nginx Let's Encrypt ์†Œ๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ Docker Swarm ๋‹ค์ค‘ ๋…ธ๋“œ ์„œ๋น„์Šค ๋ณต์ œ ๋กœ๋“œ ๋ฐธ๋Ÿฐ์‹ฑ ์ค‘๊ฐ„ ๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ Kubernetes ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ์ž๋™ ์Šค์ผ€์ผ๋ง ์ž๊ฐ€ ๋ณต๊ตฌ ๋Œ€๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ ํด๋ผ์šฐ๋“œ ์„œ๋น„์Šค AWS, GCP, Azure ๊ด€๋ฆฌํ˜• ์„œ๋น„์Šค ์„œ๋ฒ„๋ฆฌ์Šค ์˜ต์…˜ ๋ชจ๋“  ๊ทœ๋ชจ

ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์— Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๋ฐฐํฌํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ๊ฒŒ ๋˜์—ˆ์–ด! ์ด์ œ ๋งˆ์ง€๋ง‰์œผ๋กœ ์ด ๊ธ€์„ ๋งˆ๋ฌด๋ฆฌํ•˜๊ณ  ์ถ”๊ฐ€ ์ž๋ฃŒ๋ฅผ ์†Œ๊ฐœํ• ๊ฒŒ.

10. ๋งˆ๋ฌด๋ฆฌ ๋ฐ ์ถ”๊ฐ€ ์ž๋ฃŒ ๐Ÿ“š

์ง€๊ธˆ๊นŒ์ง€ Go ์–ธ์–ด ๊ฐœ๋ฐœ์„ ์œ„ํ•œ Docker ํ™˜๊ฒฝ ์„ค์ •์— ๋Œ€ํ•ด ์•Œ์•„๋ดค์–ด. ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์„ค์ •๋ถ€ํ„ฐ ํ”„๋กœ๋•์…˜ ๋ฐฐํฌ๊นŒ์ง€ ์ „์ฒด ๊ณผ์ •์„ ๋‹ค๋ค˜์ง€! ์ด์ œ ์ด ์ง€์‹์„ ๋ฐ”ํƒ•์œผ๋กœ Go์™€ Docker๋ฅผ ํ™œ์šฉํ•œ ํ”„๋กœ์ ํŠธ๋ฅผ ์‹œ์ž‘ํ•  ์ˆ˜ ์žˆ์„ ๊ฑฐ์•ผ.

๐Ÿ“‹ ์š”์•ฝ

  1. Go์™€ Docker์˜ ์กฐํ•ฉ: Go์˜ ๊ฐ„๊ฒฐํ•จ๊ณผ Docker์˜ ์ผ๊ด€๋œ ํ™˜๊ฒฝ์€ ํ˜„๋Œ€ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๊ฐœ๋ฐœ์— ์™„๋ฒฝํ•œ ์กฐํ•ฉ์ด์•ผ.
  2. Docker ๊ธฐ์ดˆ: ์ปจํ…Œ์ด๋„ˆ, ์ด๋ฏธ์ง€, Dockerfile, Docker Compose ๋“ฑ Docker์˜ ํ•ต์‹ฌ ๊ฐœ๋…์„ ์ดํ•ดํ–ˆ์–ด.
  3. ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์„ค์ •: Go ๊ฐœ๋ฐœ์„ ์œ„ํ•œ Docker ํ™˜๊ฒฝ์„ ์„ค์ •ํ•˜๊ณ , ๊ฐœ๋ฐœ๊ณผ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์„ ๋ถ„๋ฆฌํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ๋ฐฐ์› ์–ด.
  4. Dockerfile ์ž‘์„ฑ: ๊ธฐ๋ณธ Dockerfile๊ณผ ๋ฉ€ํ‹ฐ ์Šคํ…Œ์ด์ง€ ๋นŒ๋“œ๋ฅผ ํ™œ์šฉํ•œ ์ตœ์ ํ™”๋œ Dockerfile์„ ์ž‘์„ฑํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ๊ฒŒ ๋˜์—ˆ์–ด.
  5. Docker Compose: ์—ฌ๋Ÿฌ ์„œ๋น„์Šค๋ฅผ ํ•จ๊ป˜ ์‹คํ–‰ํ•˜๊ธฐ ์œ„ํ•œ Docker Compose ์„ค์ • ๋ฐฉ๋ฒ•์„ ๋ฐฐ์› ์–ด.
  6. ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ: VS Code์™€ Docker ํ†ตํ•ฉ, ๋””๋ฒ„๊น…, ํ•ซ ๋ฆฌ๋กœ๋”ฉ ๋“ฑ์„ ํ†ตํ•ด ๊ฐœ๋ฐœ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ์ตœ์ ํ™”ํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์•Œ๊ฒŒ ๋˜์—ˆ์–ด.
  7. ์‹ค์ „ ํ”„๋กœ์ ํŠธ: Go์™€ Docker๋ฅผ ์‚ฌ์šฉํ•œ ์‹ค์ œ ์›น ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๊ฐœ๋ฐœํ•ด๋ดค์–ด.
  8. ๋ฌธ์ œ ํ•ด๊ฒฐ๊ณผ ๋””๋ฒ„๊น…: Docker ํ™˜๊ฒฝ์—์„œ ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ๋Š” ๋ฌธ์ œ์™€ ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•, ๋””๋ฒ„๊น… ํŒ์„ ๋ฐฐ์› ์–ด.
  9. ํ”„๋กœ๋•์…˜ ๋ฐฐํฌ: Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์— ๋ฐฐํฌํ•˜๋Š” ๋‹ค์–‘ํ•œ ๋ฐฉ๋ฒ•๊ณผ ๊ณ ๋ ค์‚ฌํ•ญ์„ ์•Œ๊ฒŒ ๋˜์—ˆ์–ด.

๐Ÿš€ ๋‹ค์Œ ๋‹จ๊ณ„

Go์™€ Docker์— ๋Œ€ํ•ด ๋” ๊นŠ์ด ํ•™์Šตํ•˜๊ณ  ์‹ถ๋‹ค๋ฉด ๋‹ค์Œ๊ณผ ๊ฐ™์€ ์ฃผ์ œ๋ฅผ ํƒ๊ตฌํ•ด๋ณด๋Š” ๊ฒƒ์„ ์ถ”์ฒœํ•ด:

  1. ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ์•„ํ‚คํ…์ฒ˜: Go์™€ Docker๋ฅผ ์‚ฌ์šฉํ•œ ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค ๊ฐœ๋ฐœ
  2. Kubernetes: Kubernetes๋ฅผ ์‚ฌ์šฉํ•œ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜
  3. ์„œ๋ฒ„๋ฆฌ์Šค: AWS Lambda, Google Cloud Functions ๋“ฑ์—์„œ Go ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์‹คํ–‰
  4. CI/CD: ์ž๋™ํ™”๋œ ํ…Œ์ŠคํŠธ, ๋นŒ๋“œ, ๋ฐฐํฌ ํŒŒ์ดํ”„๋ผ์ธ ๊ตฌ์ถ•
  5. ๋ชจ๋‹ˆํ„ฐ๋ง ๋ฐ ๋กœ๊น…: Prometheus, Grafana, ELK Stack ๋“ฑ์„ ์‚ฌ์šฉํ•œ ๋ชจ๋‹ˆํ„ฐ๋ง ์‹œ์Šคํ…œ ๊ตฌ์ถ•

๐ŸŽ‰ ๋งˆ๋ฌด๋ฆฌ

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

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

์ด ๊ธ€์ด Go ์–ธ์–ด ๊ฐœ๋ฐœ์„ ์œ„ํ•œ Docker ํ™˜๊ฒฝ ์„ค์ •์— ๋„์›€์ด ๋˜์—ˆ๊ธธ ๋ฐ”๋ผ! ๋” ๋งŽ์€ ํ”„๋กœ๊ทธ๋ž˜๋ฐ ๊ด€๋ จ ์ •๋ณด๊ฐ€ ํ•„์š”ํ•˜๋‹ค๋ฉด ์žฌ๋Šฅ๋„ท์˜ ๋‹ค๋ฅธ ๊ธ€๋“ค๋„ ์ฐธ๊ณ ํ•ด๋ณด๊ธธ ์ถ”์ฒœํ•ด. ํ•จ๊ป˜ ์„ฑ์žฅํ•˜๋Š” ๊ฐœ๋ฐœ์ž ์ปค๋ฎค๋‹ˆํ‹ฐ์—์„œ ๋งŒ๋‚˜์ž! ๐Ÿš€

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

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

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

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