Docker Engine (CLI 기반) 설치 및 사용 설명서

Docker Engine (CLI 기반) 설치 및 사용 설명서

설치 방법 (Ubuntu / WSL 2 기준)

Ubuntu(WSL) 터미널을 열고 순서대로 입력합니다.

1. 필수 패키지 및 GPG 키 설정

sudo apt update && sudo apt upgrade -y
sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg -y

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

2. 도커 공식 저장소 등록

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

3. 도커 엔진 설치

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

4. 권한 설정 (sudo 생략하기)

매번 sudo를 쓰지 않도록 현재 계정을 docker 그룹에 추가합니다.

sudo usermod -aG docker $USER
newgrp docker

---

핵심 사용 설명서 (주요 명령어)

1. 도커 서비스 시작 / 중지

Docker Desktop 앱이 없으므로 명령어로 백그라운드 데몬을 관리합니다.

• 도커 시작: sudo service docker start (또는 sudo systemctl start docker)
• 도커 중지: sudo service docker stop

2. 이미지 관리 (다운로드 및 조회)

• 이미지 검색 및 다운로드: docker pull 이미지이름:태그 (예: docker pull mariadb:latest)
• 내 PC에 다운로드된 이미지 목록 보기:
• docker images

3. 컨테이너 실행 (MariaDB 예시 & 로컬 데이터 저장)

컨테이너를 지워도 데이터가 날아가지 않도록 -v 옵션으로 로컬 폴더를 연결합니다.

docker run -d \
  --name mariadb-server \
  -e MYSQL_ROOT_PASSWORD=비밀번호설정 \
  -p 3306:3306 \
  -v $HOME/mariadb/data:/var/lib/mysql \
  mariadb:latest

4. 실행 중인 컨테이너 확인

• 현재 켜져 있는 컨테이너 목록:
• docker ps

* **꺼진 것까지 전체 컨테이너 목록:**
```bash
docker ps -a

5. 컨테이너 조작 (중지 / 시작 / 삭제)

• 컨테이너 중지: docker stop 컨테이너이름
• 컨테이너 시작: docker start 컨테이너이름
• 컨테이너 삭제: docker rm 컨테이너이름 (실행 중인 것은 -f 옵션 강제 삭제)

---

유용한 꿀팁

• WSL 켤 때 도커 자동 실행 설정 (Systemd 활성화)

1. sudo nano /etc/wsl.conf 입력 후 아래 내용 저장:
2. [boot] systemd=true

```

2. 윈도우 PowerShell에서 wsl --shutdown 후 우분투 재실행하면 도커가 자동으로 켜집니다.