Ver2.0 ๐น Go ์ธ์ด ๊ฐ๋ฐ์ ์ํ Docker ํ๊ฒฝ ์ค์ ์๋ฒฝ ๊ฐ์ด๋: ์ด๋ณด์๋ ์ฝ๊ฒ ๋ฐ๋ผํ๋ ๊ฐ๋ฐ ํ๊ฒฝ ๊ตฌ์ถํ๊ธฐ

๐น Go ์ธ์ด ๊ฐ๋ฐ์ ์ํ Docker ํ๊ฒฝ ์ค์ ์๋ฒฝ ๊ฐ์ด๋: ์ด๋ณด์๋ ์ฝ๊ฒ ๋ฐ๋ผํ๋ ๊ฐ๋ฐ ํ๊ฒฝ ๊ตฌ์ถํ๊ธฐ
์๋ , ๊ฐ๋ฐ์ ์น๊ตฌ๋ค! ๐๏ธ ์ค๋์ Go ์ธ์ด์ Docker์ ํ์์ ์ธ ์กฐํฉ์ ๋ํด ํจ๊ป ์์๋ณผ ๊ฑฐ์ผ. 2025๋ ํ์ฌ, Go ์ธ์ด๋ ํด๋ผ์ฐ๋ ๋ค์ดํฐ๋ธ ์ ํ๋ฆฌ์ผ์ด์ ๊ฐ๋ฐ์์ ๋์ฑ ์ค์ํ ์์น๋ฅผ ์ฐจ์งํ๊ณ ์์ด. Docker์ ํจ๊ป๋ผ๋ฉด ๊ฐ๋ฐ ํ๊ฒฝ์ ๋ ์ฝ๊ณ ์ผ๊ด๋๊ฒ ๊ด๋ฆฌํ ์ ์์ง! ์ด ๊ธ์ ํตํด Go ๊ฐ๋ฐ ํ๊ฒฝ์ Docker๋ก ๊ตฌ์ถํ๋ ๋ฐฉ๋ฒ์ ์ฒ์๋ถํฐ ๋๊น์ง ์น์ ํ๊ฒ ์๋ ค์ค๊ฒ. ์ฌ๋ฅ๋ท์์ ํ๋ก๊ทธ๋๋ฐ ์ฌ๋ฅ์ ๋๋๊ณ ์ถ์ ์ฌ๋๋ค์๊ฒ๋ ์ ์ฉํ ์ ๋ณด๊ฐ ๋ ๊ฑฐ์ผ!
๐ ๋ชฉ์ฐจ
- Go ์ธ์ด์ Docker์ ๋ง๋จ: ์ ํจ๊ป ์ฌ์ฉํด์ผ ํ ๊น?
- Docker ๊ธฐ์ด ์ดํดํ๊ธฐ
- Go ๊ฐ๋ฐ์ ์ํ Docker ํ๊ฒฝ ์ค์ ํ๊ธฐ
- Dockerfile ์์ฑํ๊ธฐ
- Docker Compose๋ก ๋ค์ค ์๋น์ค ๊ตฌ์ฑํ๊ธฐ
- ๊ฐ๋ฐ ์ํฌํ๋ก์ฐ ์ต์ ํํ๊ธฐ
- ์ค์ ํ๋ก์ ํธ: Go + Docker ์ ํ๋ฆฌ์ผ์ด์ ๋ง๋ค๊ธฐ
- ๋ฌธ์ ํด๊ฒฐ๊ณผ ๋๋ฒ๊น ํ
- ํ๋ก๋์ ํ๊ฒฝ์ผ๋ก ๋ฐฐํฌํ๊ธฐ
- ๋ง๋ฌด๋ฆฌ ๋ฐ ์ถ๊ฐ ์๋ฃ
1. Go ์ธ์ด์ Docker์ ๋ง๋จ: ์ ํจ๊ป ์ฌ์ฉํด์ผ ํ ๊น? ๐ค
Go ์ธ์ด(๋๋ Golang)๋ 2009๋ Google์์ ๊ฐ๋ฐํ ํ๋ก๊ทธ๋๋ฐ ์ธ์ด๋ก, 2025๋ ํ์ฌ ํด๋ผ์ฐ๋ ์ธํ๋ผ, ๋ง์ดํฌ๋ก์๋น์ค, ์น ์ ํ๋ฆฌ์ผ์ด์ ๊ฐ๋ฐ์์ ์์ฒญ๋ ์ธ๊ธฐ๋ฅผ ๋๊ณ ์์ด. Go์ ๊ฐ๊ฒฐํจ, ๋์์ฑ ์ฒ๋ฆฌ ๋ฅ๋ ฅ, ๋น ๋ฅธ ์ปดํ์ผ ์๋๋ ํ๋ ์ ํ๋ฆฌ์ผ์ด์ ๊ฐ๋ฐ์ ๋ฑ ๋ง๋ ํน์ฑ์ด์ง!
ํํธ, Docker๋ ์ ํ๋ฆฌ์ผ์ด์ ์ ์ปจํ ์ด๋ํํ์ฌ ์ด๋์๋ ์ผ๊ด๋๊ฒ ์คํํ ์ ์๊ฒ ํด์ฃผ๋ ํ๋ซํผ์ด์ผ. ์ด ๋ ๊ธฐ์ ์ ์กฐํฉ์ด ์ ๊ฐ๋ ฅํ์ง ์์๋ณผ๊น?
๐ Go + Docker์ ์ฃผ์ ์ด์
- ํ๊ฒฝ ์ผ๊ด์ฑ: "๋ด ์ปดํจํฐ์์๋ ์ ๋์๊ฐ๋๋ฐ..." ๋ผ๋ ๋ง์ ์ด์ ์๋ง! Docker๋ก ๋ชจ๋ ๊ฐ๋ฐ์๊ฐ ๋์ผํ ํ๊ฒฝ์์ ์์ ํ ์ ์์ด.
- ๋ฐฐํฌ ๊ฐ์ํ: Go ์ ํ๋ฆฌ์ผ์ด์ ์ ์ปจํ ์ด๋ํํ๋ฉด ์ด๋ค ํ๊ฒฝ์์๋ ์ฝ๊ฒ ๋ฐฐํฌํ ์ ์์ด.
- ๋ง์ดํฌ๋ก์๋น์ค ์ํคํ ์ฒ ์ง์: Go์ ๊ฐ๋ฒผ์๊ณผ Docker์ ์ปจํ ์ด๋ํ๋ ๋ง์ดํฌ๋ก์๋น์ค ๊ตฌํ์ ์๋ฒฝํ ์กฐํฉ์ด์ผ.
- ๊ฐ๋ฐ-ํ ์คํธ-๋ฐฐํฌ ํ์ดํ๋ผ์ธ ๊ฐ์ํ: CI/CD ํ์ดํ๋ผ์ธ์ ์ฝ๊ฒ ํตํฉํ ์ ์์ด.
- ๋ฆฌ์์ค ํจ์จ์ฑ: 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์ ๊ธฐ๋ณธ ๊ฐ๋ ์ ์ดํดํ์ผ๋, Go ์ธ์ด ๊ฐ๋ฐ์ ์ํ Docker ํ๊ฒฝ์ ์ด๋ป๊ฒ ์ค์ ํ๋์ง ์์๋ณผ๊น?
3. Go ๊ฐ๋ฐ์ ์ํ Docker ํ๊ฒฝ ์ค์ ํ๊ธฐ ๐ ๏ธ
์, ์ด์ ๋ณธ๊ฒฉ์ ์ผ๋ก Go ๊ฐ๋ฐ์ ์ํ Docker ํ๊ฒฝ์ ์ค์ ํด๋ณด์! 2025๋ ํ์ฌ Go 1.22.x ๋ฒ์ ์ด ์์ ์ ์ผ๋ก ์ฌ์ฉ๋๊ณ ์์ด. ์ฐ๋ฆฌ๋ ์ด ์ต์ ๋ฒ์ ์ Docker ํ๊ฒฝ์์ ์ฌ์ฉํ ๊ฑฐ์ผ.
๐ง ์ค๋น๋ฌผ
- Docker Desktop ์ค์น (Windows, macOS) ๋๋ Docker Engine (Linux)
- ์ฝ๋ ์๋ํฐ (VS Code ์ถ์ฒ)
- ํฐ๋ฏธ๋ ํ๋ก๊ทธ๋จ
- ์ธํฐ๋ท ์ฐ๊ฒฐ
Docker ์ค์นํ๊ธฐ
๋จผ์ Docker๋ฅผ ์ค์นํด์ผ ํด. ์ด์์ฒด์ ๋ณ ์ค์น ๋ฐฉ๋ฒ์ ๊ฐ๋จํ ์์๋ณด์:
Windows์ Docker ์ค์นํ๊ธฐ
- Docker Desktop for Windows๋ฅผ ๋ค์ด๋ก๋ํด.
- ์ค์น ํ์ผ์ ์คํํ๊ณ ์ง์์ ๋ฐ๋ผ ์ค์น๋ฅผ ์๋ฃํด.
- WSL 2 ๋ฐฑ์๋๋ฅผ ์ฌ์ฉํ๋ ๊ฒ์ ์ถ์ฒํด (2025๋ ์๋ WSL 3๋ ๋์์์ง๋!)
- ์ค์น ํ Docker Desktop์ ์คํํ๊ณ ์ํ๊ฐ "Running"์ธ์ง ํ์ธํด.
macOS์ Docker ์ค์นํ๊ธฐ
- Docker Desktop for Mac์ ๋ค์ด๋ก๋ํด.
- Apple Silicon(M1/M2/M3/M4) ๋๋ Intel ์นฉ์ ์ ๋ง๋ ๋ฒ์ ์ ์ ํํด.
- ์ค์น ํ์ผ์ ์คํํ๊ณ Applications ํด๋๋ก ๋๋๊ทธํด.
- Docker Desktop์ ์คํํ๊ณ ์ํ๊ฐ "Running"์ธ์ง ํ์ธํด.
Linux์ Docker ์ค์นํ๊ธฐ
- ํฐ๋ฏธ๋์ ์ด๊ณ ๋ค์ ๋ช ๋ น์ด๋ก 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
- Docker Engine์ ์ค์นํด:
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
- 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๋ ํ์ฌ ๋ค์ํ ํ๊ทธ๊ฐ ์์ง๋ง, ์ฃผ๋ก ์ฌ์ฉ๋๋ ๋ช ๊ฐ์ง๋ฅผ ์๊ฐํ ๊ฒ:
- golang:latest - ์ต์ Go ๋ฒ์ ์ ํฌํจํ ์ด๋ฏธ์ง
- golang:1.22 - Go 1.22.x ๋ฒ์ ์ ํฌํจํ ์ด๋ฏธ์ง (2025๋ ๊ธฐ์ค ์์ ๋ฒ์ )
- golang:1.22-alpine - Alpine Linux ๊ธฐ๋ฐ์ ๊ฒฝ๋ํ๋ Go 1.22.x ์ด๋ฏธ์ง
- 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์ ์ฅ์ ์ ๋ค์๊ณผ ๊ฐ์:
- ์์ ์ด๋ฏธ์ง ํฌ๊ธฐ: ์ต์ข ์ด๋ฏธ์ง์๋ Go ๊ฐ๋ฐ ํ๊ฒฝ์ด ํฌํจ๋์ง ์๊ณ ์คํ ํ์ผ๋ง ํฌํจ๋ผ.
- ๋ณด์ ๊ฐํ: ๋ถํ์ํ ๋๊ตฌ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๊ฐ ์์ด ๊ณต๊ฒฉ ํ๋ฉด์ด ์ค์ด๋ค์ด.
- ๋ฐฐํฌ ํจ์จ์ฑ: ์์ ์ด๋ฏธ์ง๋ ๋ ๋น ๋ฅด๊ฒ ๋ค์ด๋ก๋๋๊ณ ๋ฐฐํฌ๋ ์ ์์ด.
๊ฐ๋ฐ์ฉ 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"
์ด์ ๊ฐ๋ฐ ํ๊ฒฝ๊ณผ ํ๋ก๋์ ํ๊ฒฝ ๋ชจ๋๋ฅผ ์ํ 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 ํ์ผ์ ์ธ ๊ฐ์ง ์๋น์ค๋ฅผ ์ ์ํ๊ณ ์์ด:
- app: ์ฐ๋ฆฌ์ Go ์ ํ๋ฆฌ์ผ์ด์
- db: PostgreSQL ๋ฐ์ดํฐ๋ฒ ์ด์ค
- 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๋ฅผ ์ฌ์ฉํ๋ฉด ๋ณต์กํ ์ ํ๋ฆฌ์ผ์ด์ ์คํ๋ ์ฝ๊ฒ ๊ด๋ฆฌํ ์ ์์ด. ์ด์ ๊ฐ๋ฐ ์ํฌํ๋ก์ฐ๋ฅผ ์ต์ ํํ๋ ๋ฐฉ๋ฒ์ ์์๋ณด์!
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 ์ํฌํ๋ก์ฐ๋ ๋ค์๊ณผ ๊ฐ์ ์์ ์ ์ํํด:
- ์ฝ๋ ๋ณ๊ฒฝ์ด ๋ฐ์ํ๋ฉด ์๋์ผ๋ก Docker ์ด๋ฏธ์ง๋ฅผ ๋น๋ํด.
- Docker Compose๋ฅผ ์ฌ์ฉํด ์ ํ๋ฆฌ์ผ์ด์ ์ ์คํํ๊ณ ํ ์คํธ๋ฅผ ์ํํด.
- ๋ฉ์ธ ๋ธ๋์น์ ๋ณํฉ๋ ๊ฒฝ์ฐ, ํ๋ก๋์ ์ฉ ์ด๋ฏธ์ง๋ฅผ ๋น๋ํ๊ณ Docker Hub์ ํธ์ํด.
CI/CD ํ์ดํ๋ผ์ธ์ ๊ตฌ์ฑํ๋ฉด ์ฝ๋ ํ์ง์ ์ ์งํ๊ณ ๋ฐฐํฌ ๊ณผ์ ์ ์๋ํํ ์ ์์ด. ์ด๋ ํนํ ํ ํ๋ก์ ํธ์์ ์ค์ํ ์ญํ ์ ํด!
์ด์ ๊ฐ๋ฐ ์ํฌํ๋ก์ฐ๋ฅผ ์ต์ ํํ๋ ๋ฐฉ๋ฒ์ ์๊ฒ ๋์์ด! ๋ค์์ผ๋ก๋ ์ค์ ํ๋ก์ ํธ๋ฅผ ํตํด Go์ Docker๋ฅผ ํจ๊ป ์ฌ์ฉํ๋ ๋ฐฉ๋ฒ์ ์์๋ณด์.
7. ์ค์ ํ๋ก์ ํธ: Go + Docker ์ ํ๋ฆฌ์ผ์ด์ ๋ง๋ค๊ธฐ ๐๏ธ
์ด๋ก ์ ์ถฉ๋ถํ ๋ฐฐ์ ์ผ๋, ์ด์ ์ค์ ๋ก Go์ Docker๋ฅผ ์ฌ์ฉํ ๊ฐ๋จํ ์น ์ ํ๋ฆฌ์ผ์ด์ ์ ๋ง๋ค์ด๋ณด์! ์ด ์์ ๋ฅผ ํตํด ์ง๊ธ๊น์ง ๋ฐฐ์ด ๋ด์ฉ์ ์ค์ ๋ก ์ ์ฉํด๋ณผ ์ ์์ด.
๐ ํ๋ก์ ํธ ๊ฐ์
๊ฐ๋จํ ํ ์ผ ๊ด๋ฆฌ(Todo) API๋ฅผ ๋ง๋ค์ด๋ณผ ๊ฑฐ์ผ. ์ด API๋ ๋ค์๊ณผ ๊ฐ์ ๊ธฐ๋ฅ์ ์ ๊ณตํ ๊ฑฐ์ผ:
- ํ ์ผ ๋ชฉ๋ก ์กฐํ
- ์๋ก์ด ํ ์ผ ์ถ๊ฐ
- ํ ์ผ ์๋ฃ ์ํ ๋ณ๊ฒฝ
- ํ ์ผ ์ญ์
์ด ์ ํ๋ฆฌ์ผ์ด์ ์ 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 ์ ํ๋ฆฌ์ผ์ด์ ์ ์ฑ๋ฅ์ ์ต์ ํํ๋ ๋ฐฉ๋ฒ๋ ์์๋ณด์:
- ๋ฉํฐ ์คํ ์ด์ง ๋น๋ ์ฌ์ฉํ๊ธฐ: ์ต์ข ์ด๋ฏธ์ง ํฌ๊ธฐ๋ฅผ ์ค์ฌ ๋ฐฐํฌ ์๋๋ฅผ ๋์ด๊ณ ๋ฆฌ์์ค ์ฌ์ฉ๋์ ์ค์ผ ์ ์์ด.
- ์ ์ ํ ๋ฒ ์ด์ค ์ด๋ฏธ์ง ์ ํํ๊ธฐ: Alpine ๊ธฐ๋ฐ ์ด๋ฏธ์ง๋ ํฌ๊ธฐ๊ฐ ์์ง๋ง, ์ผ๋ถ C ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์์กด์ฑ์ด ์๋ ๊ฒฝ์ฐ ๋ฌธ์ ๊ฐ ๋ฐ์ํ ์ ์์ด. ํ์์ ๋ฐ๋ผ ์ ์ ํ ์ด๋ฏธ์ง๋ฅผ ์ ํํ์.
- ๋ถํ์ํ ํ์ผ ์ ์ธํ๊ธฐ: .dockerignore ํ์ผ์ ์ฌ์ฉํด ๋น๋ ์ปจํ ์คํธ์์ ๋ถํ์ํ ํ์ผ์ ์ ์ธํ๋ฉด ๋น๋ ์๋๊ฐ ํฅ์๋ผ.
- ์ปจํ ์ด๋ ๋ฆฌ์์ค ์ ํํ๊ธฐ: docker-compose.yml ํ์ผ์์ CPU์ ๋ฉ๋ชจ๋ฆฌ ์ ํ์ ์ค์ ํด ๋ฆฌ์์ค ์ฌ์ฉ๋์ ๊ด๋ฆฌํ ์ ์์ด.
- ํจ์จ์ ์ธ ๋ ์ด์ด ์บ์ฑ: ์์ฃผ ๋ณ๊ฒฝ๋๋ ํ์ผ์ Dockerfile์ ๋ง์ง๋ง ๋ถ๋ถ์ ๋ณต์ฌํด ๋น๋ ์บ์๋ฅผ ํจ์จ์ ์ผ๋ก ํ์ฉํ์.
Docker ํ๊ฒฝ์์ Go ์ ํ๋ฆฌ์ผ์ด์ ์ ๋๋ฒ๊น ํ๋ ๋ฐฉ๋ฒ์ ์๊ฒ ๋์์ด! ์ด์ ํ๋ก๋์ ํ๊ฒฝ์ผ๋ก ๋ฐฐํฌํ๋ ๋ฐฉ๋ฒ์ ์์๋ณด์.
9. ํ๋ก๋์ ํ๊ฒฝ์ผ๋ก ๋ฐฐํฌํ๊ธฐ ๐
๊ฐ๋ฐ์ด ์๋ฃ๋๋ฉด ์ ํ๋ฆฌ์ผ์ด์ ์ ํ๋ก๋์ ํ๊ฒฝ์ ๋ฐฐํฌํด์ผ ํด. Docker๋ฅผ ์ฌ์ฉํ๋ฉด ๊ฐ๋ฐ ํ๊ฒฝ๊ณผ ํ๋ก๋์ ํ๊ฒฝ์ ์ฐจ์ด๋ฅผ ์ต์ํํ ์ ์์ด. ์ฌ๊ธฐ์๋ Go ์ ํ๋ฆฌ์ผ์ด์ ์ ํ๋ก๋์ ํ๊ฒฝ์ ๋ฐฐํฌํ๋ ๋ฐฉ๋ฒ์ ์์๋ณด์!
๐ ํ๋ก๋์ ๋ฐฐํฌ ์ ๊ณ ๋ ค์ฌํญ
1. ๋ณด์
ํ๋ก๋์ ํ๊ฒฝ์์๋ ๋ณด์์ด ์ต์ฐ์ ์ด์ผ. ๋ค์๊ณผ ๊ฐ์ ์ฌํญ์ ๊ณ ๋ คํด์ผ ํด:
- ๋น๋ฐ๋ฒํธ, API ํค ๋ฑ์ ๋ฏผ๊ฐํ ์ ๋ณด๋ ํ๊ฒฝ ๋ณ์๋ Docker Secrets๋ฅผ ์ฌ์ฉํด ๊ด๋ฆฌํ์.
- ๋ฃจํธ๊ฐ ์๋ ์ผ๋ฐ ์ฌ์ฉ์๋ก ์ ํ๋ฆฌ์ผ์ด์ ์ ์คํํ์.
- ํ์ํ ํฌํธ๋ง ๋ ธ์ถํ๊ณ , ๋ด๋ถ ์๋น์ค๋ ์ธ๋ถ์ ๋ ธ์ถํ์ง ๋ง์.
- ์ด๋ฏธ์ง๋ฅผ ์ ๊ธฐ์ ์ผ๋ก ์ค์บํ์ฌ ์ทจ์ฝ์ ์ ํ์ธํ์.
2. ์ฑ๋ฅ ์ต์ ํ
ํ๋ก๋์ ํ๊ฒฝ์์๋ ์ฑ๋ฅ์ด ์ค์ํด. ๋ค์๊ณผ ๊ฐ์ ๋ฐฉ๋ฒ์ผ๋ก ์ฑ๋ฅ์ ์ต์ ํํ ์ ์์ด:
- ๋ฉํฐ ์คํ ์ด์ง ๋น๋๋ฅผ ์ฌ์ฉํด ์ด๋ฏธ์ง ํฌ๊ธฐ๋ฅผ ์ต์ํํ์.
- Alpine ๊ธฐ๋ฐ ์ด๋ฏธ์ง๋ฅผ ์ฌ์ฉํด ์ปจํ ์ด๋ ํฌ๊ธฐ๋ฅผ ์ค์ด์.
- Go ์ ํ๋ฆฌ์ผ์ด์ ์ ์ ์ ๋งํฌ๋ก ๋น๋ํด ์์กด์ฑ ๋ฌธ์ ๋ฅผ ๋ฐฉ์งํ์.
- ์ปจํ ์ด๋ ๋ฆฌ์์ค ์ ํ์ ์ค์ ํด ๋ฆฌ์์ค ์ฌ์ฉ๋์ ๊ด๋ฆฌํ์.
3. ๊ฐ์ฉ์ฑ
ํ๋ก๋์ ํ๊ฒฝ์์๋ ๋์ ๊ฐ์ฉ์ฑ์ด ํ์ํด. ๋ค์๊ณผ ๊ฐ์ ๋ฐฉ๋ฒ์ผ๋ก ๊ฐ์ฉ์ฑ์ ๋์ผ ์ ์์ด:
- ์ฌ๋ฌ ์ธ์คํด์ค๋ฅผ ์คํํ์ฌ ๋ก๋ ๋ฐธ๋ฐ์ฑ์ ๊ตฌํํ์.
- ํฌ์ค ์ฒดํฌ๋ฅผ ๊ตฌํํ์ฌ ์ฅ์ ๊ฐ ๋ฐ์ํ ์ปจํ ์ด๋๋ฅผ ์๋์ผ๋ก ์ฌ์์ํ์.
- ๋กค๋ง ์ ๋ฐ์ดํธ๋ฅผ ์ฌ์ฉํด ๋ค์ดํ์ ์์ด ์ ๋ฐ์ดํธํ์.
- ๋ฐ์ดํฐ๋ฒ ์ด์ค์ ๊ฐ์ ์ํ ์ ์ฅ ์๋น์ค๋ ์ ์ ํ ๋ฐฑ์ ์ ๋ต์ ์๋ฆฝํ์.
4. ๋ชจ๋ํฐ๋ง
ํ๋ก๋์ ํ๊ฒฝ์์๋ ๋ชจ๋ํฐ๋ง์ด ํ์์ผ. ๋ค์๊ณผ ๊ฐ์ ๋๊ตฌ๋ฅผ ์ฌ์ฉํ ์ ์์ด:
- Prometheus: ๋ฉํธ๋ฆญ ์์ง ๋ฐ ์๋ฆผ
- Grafana: ๋ฉํธ๋ฆญ ์๊ฐํ
- ELK Stack ๋๋ Loki: ๋ก๊ทธ ์์ง ๋ฐ ๋ถ์
- Jaeger ๋๋ Zipkin: ๋ถ์ฐ ํธ๋ ์ด์ฑ
๋ฐฐํฌ ์ต์
Go ์ ํ๋ฆฌ์ผ์ด์ ์ Docker๋ก ๋ฐฐํฌํ๋ ๋ฐฉ๋ฒ์ ์ฌ๋ฌ ๊ฐ์ง๊ฐ ์์ด. 2025๋ ํ์ฌ ๊ฐ์ฅ ๋ง์ด ์ฌ์ฉ๋๋ ๋ฐฉ๋ฒ์ ์์๋ณด์!
๐ 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
์ด ํ์ดํ๋ผ์ธ์ ๋ค์๊ณผ ๊ฐ์ ๋จ๊ณ๋ก ๊ตฌ์ฑ๋ผ:
- ํ ์คํธ: Go ํ ์คํธ๋ฅผ ์คํํด ์ฝ๋ ํ์ง์ ํ์ธํด.
- ๋น๋ ๋ฐ ํธ์: Docker ์ด๋ฏธ์ง๋ฅผ ๋น๋ํ๊ณ Docker Hub์ ํธ์ํด.
- ๋ฐฐํฌ: SSH๋ฅผ ํตํด ํ๋ก๋์ ์๋ฒ์ ์ ์ํ์ฌ ์ต์ ์ด๋ฏธ์ง๋ก ์ ๋ฐ์ดํธํด.
ํ๋ก๋์ ํ๊ฒฝ์ ์ํ Go ์ ํ๋ฆฌ์ผ์ด์ ์ต์ ํ
ํ๋ก๋์ ํ๊ฒฝ์์ Go ์ ํ๋ฆฌ์ผ์ด์ ์ ์ต์ ํํ๋ ๋ฐฉ๋ฒ์ ์์๋ณด์:
- ์ ์ ๋งํฌ: CGO_ENABLED=0 ์ต์ ์ ์ฌ์ฉํด ์ ์ ๋ฐ์ด๋๋ฆฌ๋ฅผ ๋น๋ํ๋ฉด ์์กด์ฑ ๋ฌธ์ ๋ฅผ ๋ฐฉ์งํ ์ ์์ด.
- ์ต์ ํ ํ๋๊ทธ: -ldflags="-s -w" ์ต์ ์ ์ฌ์ฉํด ๋๋ฒ๊น ์ ๋ณด๋ฅผ ์ ๊ฑฐํ๊ณ ๋ฐ์ด๋๋ฆฌ ํฌ๊ธฐ๋ฅผ ์ค์ผ ์ ์์ด.
- ๋ฉํฐ์คํ ์ด์ง ๋น๋: ๋น๋ ํ๊ฒฝ๊ณผ ์คํ ํ๊ฒฝ์ ๋ถ๋ฆฌํด ์ต์ข ์ด๋ฏธ์ง ํฌ๊ธฐ๋ฅผ ์ค์ผ ์ ์์ด.
- ์ ์ ํ Go ๋ฒ์ ์ ํ: ์ต์ Go ๋ฒ์ ์ ์ฑ๋ฅ ๊ฐ์ ๊ณผ ๋ณด์ ํจ์น๊ฐ ํฌํจ๋์ด ์์ด.
- ํ๋กํ์ผ๋ง ๋๊ตฌ ํ์ฉ: pprof๋ฅผ ์ฌ์ฉํด CPU, ๋ฉ๋ชจ๋ฆฌ ์ฌ์ฉ๋์ ๋ถ์ํ๊ณ ์ต์ ํํ ์ ์์ด.
ํ๋ก๋์ ํ๊ฒฝ์ Go ์ ํ๋ฆฌ์ผ์ด์ ์ ๋ฐฐํฌํ๋ ๋ฐฉ๋ฒ์ ์๊ฒ ๋์์ด! ์ด์ ๋ง์ง๋ง์ผ๋ก ์ด ๊ธ์ ๋ง๋ฌด๋ฆฌํ๊ณ ์ถ๊ฐ ์๋ฃ๋ฅผ ์๊ฐํ ๊ฒ.
10. ๋ง๋ฌด๋ฆฌ ๋ฐ ์ถ๊ฐ ์๋ฃ ๐
์ง๊ธ๊น์ง Go ์ธ์ด ๊ฐ๋ฐ์ ์ํ Docker ํ๊ฒฝ ์ค์ ์ ๋ํด ์์๋ดค์ด. ๊ฐ๋ฐ ํ๊ฒฝ ์ค์ ๋ถํฐ ํ๋ก๋์ ๋ฐฐํฌ๊น์ง ์ ์ฒด ๊ณผ์ ์ ๋ค๋ค์ง! ์ด์ ์ด ์ง์์ ๋ฐํ์ผ๋ก Go์ Docker๋ฅผ ํ์ฉํ ํ๋ก์ ํธ๋ฅผ ์์ํ ์ ์์ ๊ฑฐ์ผ.
๐ ์์ฝ
- Go์ Docker์ ์กฐํฉ: Go์ ๊ฐ๊ฒฐํจ๊ณผ Docker์ ์ผ๊ด๋ ํ๊ฒฝ์ ํ๋ ์ ํ๋ฆฌ์ผ์ด์ ๊ฐ๋ฐ์ ์๋ฒฝํ ์กฐํฉ์ด์ผ.
- Docker ๊ธฐ์ด: ์ปจํ ์ด๋, ์ด๋ฏธ์ง, Dockerfile, Docker Compose ๋ฑ Docker์ ํต์ฌ ๊ฐ๋ ์ ์ดํดํ์ด.
- ๊ฐ๋ฐ ํ๊ฒฝ ์ค์ : Go ๊ฐ๋ฐ์ ์ํ Docker ํ๊ฒฝ์ ์ค์ ํ๊ณ , ๊ฐ๋ฐ๊ณผ ํ๋ก๋์ ํ๊ฒฝ์ ๋ถ๋ฆฌํ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์ ์ด.
- Dockerfile ์์ฑ: ๊ธฐ๋ณธ Dockerfile๊ณผ ๋ฉํฐ ์คํ ์ด์ง ๋น๋๋ฅผ ํ์ฉํ ์ต์ ํ๋ Dockerfile์ ์์ฑํ๋ ๋ฐฉ๋ฒ์ ์๊ฒ ๋์์ด.
- Docker Compose: ์ฌ๋ฌ ์๋น์ค๋ฅผ ํจ๊ป ์คํํ๊ธฐ ์ํ Docker Compose ์ค์ ๋ฐฉ๋ฒ์ ๋ฐฐ์ ์ด.
- ๊ฐ๋ฐ ์ํฌํ๋ก์ฐ: VS Code์ Docker ํตํฉ, ๋๋ฒ๊น , ํซ ๋ฆฌ๋ก๋ฉ ๋ฑ์ ํตํด ๊ฐ๋ฐ ์ํฌํ๋ก์ฐ๋ฅผ ์ต์ ํํ๋ ๋ฐฉ๋ฒ์ ์๊ฒ ๋์์ด.
- ์ค์ ํ๋ก์ ํธ: Go์ Docker๋ฅผ ์ฌ์ฉํ ์ค์ ์น ์ ํ๋ฆฌ์ผ์ด์ ์ ๊ฐ๋ฐํด๋ดค์ด.
- ๋ฌธ์ ํด๊ฒฐ๊ณผ ๋๋ฒ๊น : Docker ํ๊ฒฝ์์ ๋ฐ์ํ ์ ์๋ ๋ฌธ์ ์ ํด๊ฒฐ ๋ฐฉ๋ฒ, ๋๋ฒ๊น ํ์ ๋ฐฐ์ ์ด.
- ํ๋ก๋์ ๋ฐฐํฌ: Go ์ ํ๋ฆฌ์ผ์ด์ ์ ํ๋ก๋์ ํ๊ฒฝ์ ๋ฐฐํฌํ๋ ๋ค์ํ ๋ฐฉ๋ฒ๊ณผ ๊ณ ๋ ค์ฌํญ์ ์๊ฒ ๋์์ด.
๐ ์ถ๊ฐ ์๋ฃ
Go ์ธ์ด ํ์ต ์๋ฃ
Docker ํ์ต ์๋ฃ
Go + Docker ๊ด๋ จ ์๋ฃ
๐ ๋ง๋ฌด๋ฆฌ
Go ์ธ์ด์ Docker๋ ํ๋ ์ ํ๋ฆฌ์ผ์ด์ ๊ฐ๋ฐ์ ์์ด ๊ฐ๋ ฅํ ๋๊ตฌ์ผ. ์ด ๋ ๊ธฐ์ ์ ํจ๊ป ์ฌ์ฉํ๋ฉด ๊ฐ๋ฐ๋ถํฐ ๋ฐฐํฌ๊น์ง ์ ์ฒด ๊ณผ์ ์ ๋ ํจ์จ์ ์ผ๋ก ๊ด๋ฆฌํ ์ ์์ด. ํนํ 2025๋ ํ์ฌ, ํด๋ผ์ฐ๋ ๋ค์ดํฐ๋ธ ํ๊ฒฝ์์ Go์ Docker์ ์กฐํฉ์ ๋์ฑ ์ค์ํด์ง๊ณ ์์ด!
์ฌ๋ฅ๋ท์์ ํ๋ก๊ทธ๋๋ฐ ์ฌ๋ฅ์ ๊ณต์ ํ๊ณ ์๋ค๋ฉด, Go์ Docker์ ๋ํ ์ง์์ ํฐ ๊ฒฝ์๋ ฅ์ด ๋ ๊ฑฐ์ผ. ํด๋ผ์ด์ธํธ์๊ฒ ๋ ์ ๋ฌธ์ ์ธ ์๋น์ค๋ฅผ ์ ๊ณตํ ์ ์๊ณ , ๊ฐ๋ฐ ํ๊ฒฝ ์ค์ ๋ถํฐ ๋ฐฐํฌ๊น์ง ์ ์ฒด ๊ณผ์ ์ ํจ์จ์ ์ผ๋ก ๊ด๋ฆฌํ ์ ์์ผ๋๊น!
์ด ๊ธ์ด Go ์ธ์ด ๊ฐ๋ฐ์ ์ํ Docker ํ๊ฒฝ ์ค์ ์ ๋์์ด ๋์๊ธธ ๋ฐ๋ผ! ๋ ๋ง์ ํ๋ก๊ทธ๋๋ฐ ๊ด๋ จ ์ ๋ณด๊ฐ ํ์ํ๋ค๋ฉด ์ฌ๋ฅ๋ท์ ๋ค๋ฅธ ๊ธ๋ค๋ ์ฐธ๊ณ ํด๋ณด๊ธธ ์ถ์ฒํด. ํจ๊ป ์ฑ์ฅํ๋ ๊ฐ๋ฐ์ ์ปค๋ฎค๋ํฐ์์ ๋ง๋์! ๐
๊ด๋ จ ํค์๋
๋๊ธ ์์ฑ
์ด ๊ธ์ ๋ํ ์ฌ๋ฌ๋ถ์ ์๊ฐ์ ๋ค๋ ค์ฃผ์ธ์
๋ก๊ทธ์ธ์ด ํ์ํฉ๋๋ค
๋๊ธ์ ์์ฑํ๋ ค๋ฉด ๋จผ์ ๋ก๊ทธ์ธํด์ฃผ์ธ์.
๋๊ธ 0
์ง์์ธ์ ์ฒ - ์ง์ ์ฌ์ฐ๊ถ ๋ณดํธ ๊ณ ์ง
์ง์ ์ฌ์ฐ๊ถ ๋ณดํธ ๊ณ ์ง
- ์ ์๊ถ ๋ฐ ์์ ๊ถ: ๋ณธ ์ปจํ ์ธ ๋ ์ฌ๋ฅ๋ท์ ๋ ์ AI ๊ธฐ์ ๋ก ์์ฑ๋์์ผ๋ฉฐ, ๋ํ๋ฏผ๊ตญ ์ ์๊ถ๋ฒ ๋ฐ ๊ตญ์ ์ ์๊ถ ํ์ฝ์ ์ํด ๋ณดํธ๋ฉ๋๋ค.
- AI ์์ฑ ์ปจํ ์ธ ์ ๋ฒ์ ์ง์: ๋ณธ AI ์์ฑ ์ปจํ ์ธ ๋ ์ฌ๋ฅ๋ท์ ์ง์ ์ฐฝ์๋ฌผ๋ก ์ธ์ ๋๋ฉฐ, ๊ด๋ จ ๋ฒ๊ท์ ๋ฐ๋ผ ์ ์๊ถ ๋ณดํธ๋ฅผ ๋ฐ์ต๋๋ค.
- ์ฌ์ฉ ์ ํ: ์ฌ๋ฅ๋ท์ ๋ช ์์ ์๋ฉด ๋์ ์์ด ๋ณธ ์ปจํ ์ธ ๋ฅผ ๋ณต์ , ์์ , ๋ฐฐํฌ, ๋๋ ์์ ์ ์ผ๋ก ํ์ฉํ๋ ํ์๋ ์๊ฒฉํ ๊ธ์ง๋ฉ๋๋ค.
- ๋ฐ์ดํฐ ์์ง ๊ธ์ง: ๋ณธ ์ปจํ ์ธ ์ ๋ํ ๋ฌด๋จ ์คํฌ๋ํ, ํฌ๋กค๋ง, ๋ฐ ์๋ํ๋ ๋ฐ์ดํฐ ์์ง์ ๋ฒ์ ์ ์ฌ์ ๋์์ด ๋ฉ๋๋ค.
- AI ํ์ต ์ ํ: ์ฌ๋ฅ๋ท์ AI ์์ฑ ์ปจํ ์ธ ๋ฅผ ํ AI ๋ชจ๋ธ ํ์ต์ ๋ฌด๋จ ์ฌ์ฉํ๋ ํ์๋ ๊ธ์ง๋๋ฉฐ, ์ด๋ ์ง์ ์ฌ์ฐ๊ถ ์นจํด๋ก ๊ฐ์ฃผ๋ฉ๋๋ค.
์์ง ๋๊ธ์ด ์์ต๋๋ค.