02. 데이터베이스 설치

Docker란?

Docker는 소프트웨어를 컨테이너라는 격리된 환경에서 실행하는 도구입니다. 컴퓨터에 MySQL이나 PostgreSQL을 직접 설치하는 대신, Docker가 알아서 필요한 환경을 만들어주고, 필요 없으면 깔끔하게 삭제할 수 있습니다.

1단계: WSL 2 설치 (Windows만 해당)

WSL (Windows Subsystem for Linux)은 Windows 안에서 Linux를 실행하는 기능입니다. Docker Desktop이 내부적으로 WSL 2를 사용하므로, Docker를 쓰려면 WSL 2가 먼저 설치되어 있어야 합니다.

WSL 2 설치

PowerShell을 관리자 권한으로 실행하고 다음 명령을 입력합니다:

wsl --install

이 한 줄로 WSL 2 + Ubuntu (기본 배포판)가 자동 설치됩니다. 완료 후 재부팅합니다.

wsl --list --online              # 설치 가능한 배포판 목록
wsl --install -d Debian          # Debian 설치
wsl --install -d Ubuntu-24.04    # 특정 Ubuntu 버전

재부팅 후 초기 설정

재부팅하면 Ubuntu 터미널이 자동으로 열리며, Linux 사용자 이름과 비밀번호를 설정하라고 합니다. 이 계정은 Linux 내부에서만 사용되며, Windows 계정과 별개입니다.

Enter new UNIX username: tutorial
New password: ********

WSL 2 설치 확인

PowerShell에서:

wsl --list --verbose

다음과 비슷한 출력이 나오면 성공입니다:

  NAME      STATE    VERSION
* Ubuntu    Running  2

VERSION이 2인지 확인하세요. 만약 1이라면:

wsl --set-version Ubuntu 2

Ubuntu 설치 후 필수 작업

Ubuntu 터미널을 열고 (시작 메뉴에서 "Ubuntu" 검색) 다음을 순서대로 실행합니다.

1. 시스템 업데이트

설치 직후의 패키지는 오래된 버전일 수 있습니다. 반드시 업데이트하세요:

sudo apt update && sudo apt upgrade -y

2. 기본 도구 설치

자주 쓰이는 도구를 미리 설치합니다:

sudo apt install -y curl wget git unzip

3. Windows Terminal 사용 (강력 추천)

Windows 기본 콘솔 대신 Windows Terminal을 사용하면 Ubuntu, PowerShell, 명령 프롬프트를 탭으로 전환할 수 있습니다. Windows 11에는 기본 설치되어 있고, Windows 10은 Microsoft Store에서 무료로 받을 수 있습니다.

설치 후 Windows Terminal을 열면 드롭다운에 Ubuntu가 자동으로 나타납니다.

4. 파일 시스템 접근 방법

# 예: Windows 바탕화면의 파일 확인
ls /mnt/c/Users/$USER/Desktop/

2단계: Docker Desktop 설치

다운로드

Docker Desktop 공식 사이트에서 운영체제에 맞는 버전을 다운로드합니다.

# 이전 버전 제거
sudo apt remove docker docker-engine docker.io containerd runc 2>/dev/null

# 저장소 설정
sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Docker 설치
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 현재 사용자를 docker 그룹에 추가 (sudo 없이 docker 명령 사용)
sudo usermod -aG docker $USER

설치 확인

터미널(명령 프롬프트, PowerShell, 또는 macOS/Linux 터미널)을 열고:

docker --version

Docker version 27.x.x 같은 출력이 나오면 성공입니다.

docker run hello-world

Hello from Docker! 메시지가 나오면 정상 동작합니다.

3단계: 알아두면 좋은 Docker 기본 명령

이 튜토리얼에서 사용하는 명령만 정리했습니다.

4단계: 데이터베이스 컨테이너 실행

선택한 DB의 명령만 실행하세요. 여러 DB를 동시에 실행해도 됩니다.

MySQL

docker run -d \
  --name mysql \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=tutorial \
  -v mysql-data:/var/lib/mysql \
  mysql:8.0

접속 확인:

docker exec -it mysql mysql -u root -ptutorial -e "SELECT VERSION();"

MariaDB

MySQL 대신 MariaDB를 사용하려면 아래 명령을 사용합니다. MySQL과 호환되며, 이 튜토리얼의 MySQL SQL이 그대로 동작합니다.

docker run -d \
  --name mariadb \
  -p 3306:3306 \
  -e MARIADB_ROOT_PASSWORD=tutorial \
  -v mariadb-data:/var/lib/mysql \
  mariadb:11

접속 확인:

docker exec -it mariadb mariadb -u root -ptutorial -e "SELECT VERSION();"

PostgreSQL

docker run -d \
  --name postgres \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=tutorial \
  -v postgres-data:/var/lib/postgresql/data \
  postgres:16

접속 확인:

docker exec -it postgres psql -U postgres -c "SELECT version();"

SQL Server

docker run -d \
  --name mssql \
  -p 1433:1433 \
  -e ACCEPT_EULA=Y \
  -e MSSQL_SA_PASSWORD=Tutorial1! \
  -v mssql-data:/var/opt/mssql \
  mcr.microsoft.com/mssql/server:2022-latest

접속 확인:

docker exec -it mssql /opt/mssql-tools18/bin/sqlcmd \
  -S localhost -U sa -P "Tutorial1!" -C -Q "SELECT @@VERSION;"

Oracle

docker run -d \
  --name oracle \
  -p 1521:1521 \
  -e ORACLE_PASSWORD=tutorial \
  -v oracle-data:/opt/oracle/oradata \
  container-registry.oracle.com/database/express:latest

접속 확인:

docker exec -it oracle sqlplus system/tutorial@//localhost:1521/XEPDB1

SQL> 프롬프트가 나타나면 EXIT로 나옵니다.

5단계: 컨테이너 관리

시작 / 중지

컴퓨터를 끄거나 Docker Desktop을 종료하면 컨테이너도 중지됩니다. 다시 시작하려면:

docker start mysql postgres mssql oracle   # 필요한 것만 선택

학습이 끝나면 중지:

docker stop mysql postgres mssql oracle

데이터는 유지됩니다

위 docker run 명령에 -v 옵션(볼륨)을 넣었기 때문에, 컨테이너를 삭제(docker rm)해도 데이터는 보존됩니다. 같은 이름으로 다시 만들면 이전 데이터가 그대로 남아있습니다.

전체 정리

튜토리얼을 완전히 끝내고 Docker 환경을 깨끗이 지우려면:

# 컨테이너 중지 + 삭제
docker stop mysql postgres mssql oracle
docker rm mysql postgres mssql oracle

# 데이터 볼륨도 삭제 (되돌릴 수 없음)
docker volume rm mysql-data postgres-data mssql-data oracle-data

데이터 생성 시 접속 정보

03. 데이터 생성에서 --apply 옵션을 사용할 때 위 표의 접속 정보를 입력합니다. 대화형 모드를 사용하면 단계별로 안내됩니다:

python -m src.cli.generate

DB 서버를 시스템에 직접 설치하는 방법입니다. Docker보다 설정이 복잡하지만, 이미 설치된 환경이 있거나 Docker를 사용할 수 없는 경우에 사용합니다.

MySQL / MariaDB

mysql --version

mysql -u root -p

C:\Program Files\MySQL\MySQL Server 8.0\bin

brew install mysql
brew services start mysql
mysql_secure_installation    # root 비밀번호 설정
mysql -u root -p             # 접속 확인

sudo apt update && sudo apt install mysql-server
sudo systemctl start mysql && sudo systemctl enable mysql
sudo mysql_secure_installation
sudo mysql -u root -p

PostgreSQL

psql -U postgres    # 접속 확인

brew install postgresql@16
brew services start postgresql@16
psql postgres        # 접속 확인

sudo apt update && sudo apt install postgresql postgresql-contrib
sudo systemctl start postgresql && sudo systemctl enable postgresql
sudo -u postgres psql    # 접속 확인

SQL Server

Oracle