🐋 Docker 네트워킹 & 볼륨 이해 (1-5)

hyun_w·2025년 8월 20일

Docker 네트워킹과 볼륨 정의

Docker 네트워킹 🌐

Docker 네트워킹은 컨테이너가 서로, 그리고 호스트 머신이나 외부 네트워크와 통신할 수 있게 해주는 기능입니다. Docker는 여러 종류의 내장(built-in) 네트워크 드라이버를 제공하며, 가장 흔하게 사용되는 드라이버는 다음과 같습니다.

Docker 볼륨 💾

Docker 볼륨은 컨테이너의 데이터를 영구적으로 저장하는 데 사용되는 메커니즘입니다. 컨테이너는 휘발성(ephemeral)이기 때문에 컨테이너가 삭제되면 그 안에 있던 데이터도 함께 사라집니다. 볼륨을 사용하면 데이터를 컨테이너의 수명주기와 분리하여 관리할 수 있습니다.

🛠 실습 예제: MySQL + Node.js API 연동

오류 발생

오류 해결

🏁 프로젝트 구조

docker-basic-demo/
├── api/
│   ├── package.json
│   ├── server.js
│   └── Dockerfile
└── database/
    └── init.sql

1️⃣ MySQL 데이터베이스 설정

# database/init.sql

SET NAMES utf8mb4;
SET CHARACTER SET utf8mb4;

-- Character set configuration
CREATE DATABASE IF NOT EXISTS simple_blog 
  DEFAULT CHARACTER SET utf8mb4 
  DEFAULT COLLATE utf8mb4_unicode_ci;
USE simple_blog;

-- Table creation with utf8mb4
CREATE TABLE IF NOT EXISTS posts (
    id INT AUTO_INCREMENT PRIMARY KEY,
    title VARCHAR(200) NOT NULL,
    content TEXT NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

-- Sample data with Korean content
INSERT INTO posts (title, content) VALUES
('Docker 네트워킹 기초', 'Docker 컨테이너 간 통신 방법을 배워봅시다.'),
('볼륨으로 데이터 유지하기', 'Docker 볼륨을 사용하면 데이터가 영구적으로 보존됩니다.'),
('첫 번째 실습', '간단한 MySQL + Node.js 연동 실습입니다.');

SELECT 'Database initialization completed' AS status;

2️⃣ Node.js API 서버 구성

Node.js 프로젝트 생성

# api

npm init -y

api/package.json

{
  "name": "simple-blog-api",
  "version": "1.0.0",
  "description": "간단한 블로그 API",
  "main": "server.js",
  "scripts": {
    "start": "node server.js",
    "dev": "nodemon server.js"
  },
  "dependencies": {
    "express": "^4.18.2",
    "mysql2": "^3.6.0",
    "cors": "^2.8.5"
  }
}

api/server.js

const express = require('express');
const mysql = require('mysql2/promise');
const cors = require('cors');

const app = express();
const PORT = process.env.PORT || 3000;

// 미들웨어 설정
app.use(cors());
app.use(express.json());

// MySQL 연결 설정
const dbConfig = {
  host: process.env.DB_HOST || 'localhost',
  port: process.env.DB_PORT || 3306,
  user: process.env.DB_USER || 'root',
  password: process.env.DB_PASSWORD || 'secret',
  database: process.env.DB_NAME || 'simple_blog',
  timezone: '+09:00',
  charset: 'utf8mb4',
  supportBigNumbers: true,
  bigNumberStrings: true
};

let connection;

// 데이터베이스 연결 함수
async function connectDatabase() {
  try {
    connection = await mysql.createConnection(dbConfig);
    console.log('✅ MySQL 데이터베이스 연결 성공');
    console.log(`📍 연결 정보: ${dbConfig.host}:${dbConfig.port}/${dbConfig.database}`);
  } catch (error) {
    console.error('❌ 데이터베이스 연결 실패:', error.message);
    console.log('🔄 5초 후 재시도...');
    setTimeout(connectDatabase, 5000);
  }
}

// 라우트 정의
// 1. API 상태 확인
app.get('/health', async (req, res) => {
  try {
    const [rows] = await connection.execute('SELECT COUNT(*) as count FROM posts');
    res.json({
      status: 'OK',
      message: 'API 서버가 정상 동작합니다',
      timestamp: new Date().toISOString(),
      database: 'connected',
      posts_count: rows[0].count
    });
  } catch (error) {
    res.status(500).json({
      status: 'ERROR',
      message: 'Database connection failed',
      error: error.message
    });
  }
});

// 2. 모든 게시글 조회
app.get('/posts', async (req, res) => {
  try {
    const [rows] = await connection.execute(
      'SELECT id, title, content, created_at FROM posts ORDER BY created_at DESC'
    );
    res.json({
      success: true,
      data: rows,
      count: rows.length
    });
  } catch (error) {
    console.error('게시글 조회 오류:', error);
    res.status(500).json({
      success: false,
      message: '게시글 조회에 실패했습니다',
      error: error.message
    });
  }
});

// 3. 새 게시글 작성
app.post('/posts', async (req, res) => {
  const { title, content } = req.body;

  if (!title || !content) {
    return res.status(400).json({
      success: false,
      message: '제목과 내용은 필수입니다'
    });
  }

  try {
    const [result] = await connection.execute(
      'INSERT INTO posts (title, content) VALUES (?, ?)',
      [title, content]
    );

    const [newPost] = await connection.execute(
      'SELECT id, title, content, created_at FROM posts WHERE id = ?',
      [result.insertId]
    );

    res.status(201).json({
      success: true,
      message: '게시글이 작성되었습니다',
      data: newPost[0]
    });
  } catch (error) {
    console.error('게시글 작성 오류:', error);
    res.status(500).json({
      success: false,
      message: '게시글 작성에 실패했습니다',
      error: error.message
    });
  }
});

// 4. 특정 게시글 조회
app.get('/posts/:id', async (req, res) => {
  const postId = req.params.id;

  try {
    const [rows] = await connection.execute(
      'SELECT id, title, content, created_at FROM posts WHERE id = ?',
      [postId]
    );

    if (rows.length === 0) {
      return res.status(404).json({
        success: false,
        message: '게시글을 찾을 수 없습니다'
      });
    }

    res.json({
      success: true,
      data: rows[0]
    });
  } catch (error) {
    console.error('게시글 조회 오류:', error);
    res.status(500).json({
      success: false,
      message: '게시글 조회에 실패했습니다',
      error: error.message
    });
  }
});

// 5. 게시글 삭제
app.delete('/posts/:id', async (req, res) => {
  const postId = req.params.id;

  try {
    const [result] = await connection.execute(
      'DELETE FROM posts WHERE id = ?',
      [postId]
    );

    if (result.affectedRows === 0) {
      return res.status(404).json({
        success: false,
        message: '게시글을 찾을 수 없습니다'
      });
    }

    res.json({
      success: true,
      message: '게시글이 삭제되었습니다'
    });
  } catch (error) {
    console.error('게시글 삭제 오류:', error);
    res.status(500).json({
      success: false,
      message: '게시글 삭제에 실패했습니다',
      error: error.message
    });
  }
});

// 서버 시작
app.listen(PORT, async () => {
  console.log(`🚀 API 서버가 포트 ${PORT}에서 실행중입니다`);
  console.log(`📋 API 문서: http://localhost:${PORT}/health`);

  // 데이터베이스 연결 시작
  await connectDatabase();
});

// 정상적인 종료 처리
process.on('SIGINT', async () => {
  console.log('\n🛑 서버를 종료합니다...');
  if (connection) {
    await connection.end();
    console.log('✅ 데이터베이스 연결 종료');
  }
  process.exit(0);
});

api/Dockerfile

FROM node:18-alpine

# 작업 디렉토리 설정
WORKDIR /app

# package.json 복사 및 의존성 설치
COPY package*.json ./
RUN npm install

# 소스 코드 복사
COPY . .

# 포트 노출
EXPOSE 3000

# 애플리케이션 실행
CMD ["npm", "start"]

3️⃣ 실습 실행

단계 1: MySQL 컨테이너 실행

# 1. MySQL 볼륨 생성
docker volume create mysql-data

# 2. MySQL 컨테이너 실행 (볼륨 연결)
docker run -d \
  --name blog-mysql \
  -e MYSQL_ROOT_PASSWORD=secret \
  -e MYSQL_DATABASE=simple_blog \
  -p 3306:3306 \
  -v mysql-data:/var/lib/mysql \
  -v $(PWD)/database/init.sql:/docker-entrypoint-initdb.d/init.sql:ro \
  mysql:8.0 \
  --character-set-server=utf8mb4 \
  --collation-server=utf8mb4_unicode_ci \
  --default-time-zone='+09:00'

# 3. MySQL 컨테이너 로그 확인
docker logs blog-mysql

# 2. MySQL 컨테이너 실행 (볼륨 연결) code
docker run -d --name blog-mysql -e MYSQL_ROOT_PASSWORD=secret -e MYSQL_DATABASE=simple_blog -p 3306:3306 -v mysql-data:/var/lib/mysql -v ${PWD}/database/init.sql:/docker-entrypoint-initdb.d/init.sql:ro mysql:8.0 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --default-time-zone='+09:00'

단계 2: API 서버 빌드 및 실행

# 1. API 서버 이미지 빌드
cd api
docker build -t simple-blog-api .

# 2. API 서버 컨테이너 실행 (MySQL과 연결)
docker run -d \
  --name blog-api \
  -e DB_HOST=blog-mysql \
  -e DB_PASSWORD=secret \
  -e DB_NAME=simple_blog \
  -p 3000:3000 \
  --link blog-mysql \
  simple-blog-api

cd ..

단계 3: 동작 확인

# 1. 컨테이너 상태 확인
docker ps

# 2. API 상태 확인
curl http://localhost:3000/health

# 3. 게시글 목록 조회
curl http://localhost:3000/posts

# 4. 새 게시글 작성
curl -X POST http://localhost:3000/posts \
  -H "Content-Type: application/json" \
  -d '{"title":"Docker 실습", "content":"포트 바인딩과 볼륨을 배웠습니다!"}'

# 5. 다시 게시글 목록 확인
curl http://localhost:3000/posts

hyun_w

이전 포스트

🐋 Docker 멀티 플랫폼 이미지 빌드 (1-4)

다음 포스트