Ubuntu에서 Docker 이미지 만들기·관리 완전 가이드 | 설치·최적화·문제 해결

1. 소개

Docker란?

Ubuntu에서 Docker를 사용할 때의 장점

• 공식 지원：Docker는 Ubuntu를 공식적으로 지원하며, 공식 저장소에서 쉽게 설치할 수 있습니다。
• 안정적인 패키지 관리：Ubuntu의 APT 패키지 관리자를 활용하여 Docker 버전 관리를 쉽게 할 수 있습니다。
• 광범위한 커뮤니티 지원：Ubuntu는 전 세계적으로 사용자가 많아 문제 발생 시 정보를 얻기 쉽습니다。

이 기사에서 배울 수 있는 내용

1. Ubuntu에 Docker를 설치하는 방법
2. Docker 이미지의 기본적인 조작
3. Dockerfile을 사용한 커스텀 이미지 생성
4. Ubuntu 컨테이너의 일본어 환경 설정
5. Docker 이미지 최적화 및 경량화
6. Ubuntu 컨테이너에서의 앱 개발
7. 자주 발생하는 오류와 해결책

2. Ubuntu에서 Docker 설치

공식 리포지토리를 사용한 Docker 설치

1. 기존 Docker 패키지 삭제

sudo apt remove docker docker-engine docker.io containerd runc

2. 필요한 패키지 설치

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

3. Docker 공식 리포지토리 추가

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

4. Docker 설치

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

5. 설치 확인

docker --version

설치 후 초기 설정

1. Docker 서비스 시작 및 활성화

sudo systemctl start docker
sudo systemctl enable docker

2. 비root 사용자에게 Docker 사용 가능하게 하기

sudo usermod -aG docker $USER

3. 동작 확인

docker run hello-world

3. Docker 이미지 기본 작업

Docker 이미지란?

Docker Hub에서 Ubuntu 이미지를 가져오기

docker pull ubuntu

컨테이너 시작·정지

docker run -it ubuntu bash

컨테이너 목록 표시

docker ps

docker ps -a

컨테이너 정지와 삭제

docker stop [컨테이너ID또는이름]

docker rm [컨테이너ID또는이름]

Docker 이미지 관리

docker images

docker rmi [이미지ID]

4. Dockerfile을 사용한 커스텀 이미지 만들기

Dockerfile이란?

Dockerfile의 기본 구문

Ubuntu 기반 커스텀 이미지 만들기

1. 작업 디렉터리 만들기

mkdir my-ubuntu-image
cd my-ubuntu-image

2. Dockerfile 만들기

# Ubuntu 공식 이미지
FROM ubuntu:latest

# 유지보수자 정보(선택)
LABEL maintainer="your-email@example.com"

# 패키지 목록을 업데이트하고 기본 도구를 설치
RUN apt update && apt install -y curl vim git

# 작업 디렉터리 설정
WORKDIR /workspace

# 컨테이너 시작 시 실행할 명령
CMD ["bash"]

3. Docker 이미지 빌드

docker build -t my-ubuntu-image .

4. 이미지 확인

docker images

5. 컨테이너 시작

docker run -it my-ubuntu-image

5. Ubuntu 컨테이너의 일본어 환경 설정

일본어 로케일 설정

1. 필요한 패키지 설치

apt update
apt install -y language-pack-ja locales

2. 로케일 설정

locale-gen ja_JP.UTF-8
update-locale LANG=ja_JP.UTF-8

3. 설정 반영

export LANG=ja_JP.UTF-8

일본어 입력 환경 구축

apt install -y ibus-mozc

export GTK_IM_MODULE=ibus
export XMODIFIERS=@im=ibus
export QT_IM_MODULE=ibus

GUI 애플리케이션 사용

docker run -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix my-ubuntu-image

6. Docker 이미지 최적화 및 경량화

경량 Ubuntu 기반 이미지를 만드는 방법

FROM ubuntu:minimal

FROM alpine:latest
RUN apk add --no-cache bash curl

불필요한 파일을 삭제하여 이미지 크기를 줄이기

RUN apt update && apt install -y curl vim     && apt clean     && rm -rf /var/lib/apt/lists/*

멀티스테이지 빌드 활용

FROM ubuntu as builder
RUN apt update && apt install -y gcc

FROM ubuntu:minimal
COPY --from=builder /usr/bin/gcc /usr/bin/gcc

7. 실전: Ubuntu 컨테이너로 앱 개발

Python 개발 환경 설정

FROM ubuntu:latest
RUN apt update && apt install -y python3 python3-pip
CMD ["python3"]

docker build -t python-dev .
docker run -it python-dev

Node.js 개발 환경 설정

FROM ubuntu:latest
RUN apt update && apt install -y nodejs npm
CMD ["node"]

docker build -t node-dev .
docker run -it node-dev

8. FAQ·문제 해결

Docker와 가상 머신의 차이

• Docker: 호스트 OS의 커널을 공유하기 때문에 가볍고, 컨테이너 시작이 빠릅니다.
• 가상 머신（VM）: 독립된 OS를 가지고 있어 리소스 소비가 많고, 시작도 느립니다.

Ubuntu 컨테이너의 데이터 영속성

docker run -v my_data:/data ubuntu

자주 발생하는 오류와 해결책

1. permission denied 오류

sudo usermod -aG docker $USER

2. image not found 오류

docker pull ubuntu:22.04