Ubuntu에서 Docker 설치·시작하는 방법 | 설치부터 컨테이너 운영 기본까지 완전 가이드

1. Docker란 무엇인가? Ubuntu와의 관계

2. 필요 환경·전제 조건

Ubuntu 버전에 대하여

시스템 요구 사항

• 64bit 버전 Ubuntu가 설치되어 있어야 함(32bit 미지원)
• CPU: 2코어 이상 권장
• 메모리: 2GB 이상(4GB 이상이면 여유 있음)
• 여유 디스크 용량: 최소 10GB 이상

인터넷 연결

사용자 권한에 대하여

오래된 Docker 패키지 삭제

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

정리

3. Docker Engine 설치 및 설정

공식 리포지토리 추가 및 사전 준비

1. 필요한 패키지 설치

sudo apt-get update
sudo apt-get install 
    ca-certificates 
    curl 
    gnupg 
    lsb-release

2. GPG 키 추가

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

3. Docker 리포지토리 추가

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 Engine 설치

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

docker --version

Docker Desktop에 대하여 (보충)

문제가 발생했을 경우

4. docker 명령을 sudo 없이 사용할 수 있게 하기

docker 그룹에 사용자 추가 절차

1. 사용자를 docker 그룹에 추가하는 다음 명령으로 현재 로그인 중인 사용자를 docker 그룹에 추가합니다。 （$USER는 자동으로 현재 사용자 이름으로 대체됩니다）

sudo usermod -aG docker $USER

2. 설정을 반영시키는 그룹 추가 설정을 유효하게 하려면 다시 로그인해야 합니다。 가장 간단한 방법은 ‘한 번 로그아웃하고 다시 로그인’하는 것입니다。

newgrp docker

3. 확인 sudo 없이 Docker 명령을 실행할 수 있는지 확인합니다。 예를 들어, 다음과 같이 버전이 표시되면 성공입니다。

docker version

보충: 보안 측면에 대하여

5. Docker 데몬 시작·자동 시작 설정

Docker 데몬의 시작·중지·재시작

• 시작

sudo systemctl start docker

• 중지

sudo systemctl stop docker

• 재시작

sudo systemctl restart docker

• 상태 확인

sudo systemctl status docker

자동 시작 설정(부팅 시 활성화/비활성화)

• 자동 시작을 활성화

sudo systemctl enable docker

• 자동 시작을 비활성화

sudo systemctl disable docker

보충：service 명령으로도 조작 가능

오류 시 체크 포인트

• Docker 데몬이 시작되지 않을 경우 sudo systemctl status docker로 오류 메시지를 확인합니다。
• 의존 패키지가 부족하거나 커널 설정이 맞지 않을 경우 오류가 발생할 수 있습니다。
• 로그는 journalctl -u docker 명령으로도 확인할 수 있습니다。

6. Ubuntu 컨테이너 시작 절차

1. Ubuntu 이미지 가져오기(pull)

docker pull ubuntu:22.04

docker pull ubuntu

2. Ubuntu 컨테이너 새로 시작(run)

docker run -it --name myubuntu ubuntu:22.04 /bin/bash

• -it：대화형 모드(쉘 조작용)
• --name myubuntu：컨테이너에 원하는 이름을 지정(생략 가능)
• ubuntu:22.04：사용할 이미지
• /bin/bash：시작 시 실행할 명령어(bash 쉘)

3. 백그라운드에서 시작

docker run -d --name myubuntu ubuntu:22.04 tail -f /dev/null

4. 컨테이너 종료 및 재시작

• 컨테이너를 종료할 경우

docker stop myubuntu

• 다시 시작할 경우

docker start myubuntu

5. 상태 확인

• 실행 중인 컨테이너 목록

docker ps

• 중지된 것까지 포함해 모두 표시하려면

docker ps -a

정리

7. 컨테이너 운영의 기본 명령어 정리

컨테이너 목록 표시

• 실행 중인 컨테이너 목록

docker ps

• 중지된 것까지 포함한 모든 컨테이너 목록

docker ps -a

컨테이너 시작·정지·재시작

• 컨테이너 시작

docker start [컨테이너 이름 or ID]

• 컨테이너 정지

docker stop [컨테이너 이름 or ID]

• 컨테이너 재시작

docker restart [컨테이너 이름 or ID]

컨테이너에 연결·조작

• 실행 중인 컨테이너에 명령 실행（exec）

docker exec -it [컨테이너 이름 or ID] /bin/bash

컨테이너 삭제

• 컨테이너 삭제

docker rm [컨테이너 이름 or ID]

• 강제로 삭제（실행 중도 가능）

docker rm -f [컨테이너 이름 or ID]

이미지 삭제

• 미사용 이미지 확인

• 이미지 삭제

docker rmi [이미지 이름 or ID]

그 외 자주 쓰는 편리한 명령어

• 로그 확인

docker logs [컨테이너 이름 or ID]

• 디스크 사용량 확인

docker system df

포인트 정리

• docker ps, docker start, docker stop, docker exec 등 기본 명령어를 숙지하면 일상 운영·문제 대응이 원활해집니다。
• 불필요한 컨테이너와 이미지는 정기적으로 삭제하고, 디스크 용량을 관리하는 것도 중요합니다。

8. 트러블슈팅/자주 묻는 질문

자주 발생하는 트러블과 해결 방법

1. “Cannot connect to the Docker daemon” 오류

• 대처 방법:

1. Docker 데몬이 실행 중인지 확인 sudo systemctl status docker
2. 실행되지 않았다면 다음 명령으로 시작 sudo systemctl start docker
3. sudo가 필요한 경우 붙여 실행하거나, 4장에 따라 “docker 그룹”에 자신의 사용자를 추가합시다.

2. 오래된 Docker 패키지 및 충돌 문제

• 대처 방법: 오래된 패키지를 제거합니다.

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

3. 컨테이너 시작에 실패하는 경우

• 대처 방법:
• 이미지 이름 및 명령의 철자를 확인
• docker images로 올바른 이미지가 존재하는지 확인
• 서버의 남은 디스크 용량 및 메모리를 확인

4. 포트 충돌 오류

• 대처 방법:
• 다른 포트 번호를 지정
• 기존 프로세스를 중지

5. rootless(루트리스) 모드 주의점

실전 체크리스트

• docker ps -a 로 컨테이너 상태 파악
• docker logs [컨테이너명] 로 오류 내용 확인
• journalctl -u docker 로 시스템 전체 Docker 관련 로그 확인

핵심 정리

9. 요약 및 다음 단계

이 글 요약

• Docker 개요와 장점 Ubuntu와의 친화성이 높아 어디서든 동일한 환경을 빠르게 재현할 수 있다는 점.
• 도입 전 준비와 포인트 Ubuntu 버전 및 하드웨어 요구사항, 권한, 오래된 패키지 정리 등.
• Docker Engine 설치 방법 공식 레포지토리를 사용해 안전하고 최신 Docker를 도입합니다.
• sudo 없이 작업 및 데몬 관리 방법 그룹 추가와 systemctl을 통한 자동 시작·중지.
• Ubuntu 컨테이너 실행 및 다양한 명령 사용법 컨테이해? 컨테이너 생성, 관리, 운영에 관한 기본 조작.
• 자주 발생하는 문제와 해결 방법 권한 및 버전 충돌 등 실무에서 자주 발생하는 문제의 해결 방법.

다음 단계·추가 활용으로

• Dockerfile을 이용한 맞춤 컨테이너 구축 단순히 이미지를 사용하는 것에 그치지 않고, 자신의 용도에 맞게 커스터마이징한 이미지를 만들 수 있습니다.
• Docker Compose를 이용한 다중 컨테이너 연동 여러 서비스(예: Web+DB)의 동시 실행 및 관리도 간단하게.
• 볼륨 및 네트워크 기능 활용데이터 영속화와 다중 컨테이너 간 통신 관리도 가능합니다.
• Kubernetes 등 컨테이너 오케스트레이션 대규모 운영 및 자동 스케일링 등, 한 단계 더 진보된 클라우드 운영에도 도전할 수 있습니다.

마지막으로

10. FAQ［자주 묻는 질문］

Q1. Docker는 Ubuntu Desktop과 Ubuntu Server 중 어느 쪽에서도 사용할 수 있나요?

Q2. Ubuntu에 Docker Desktop이 필요합니까?

Q3. rootless(루트리스) 모드란 무엇인가요?

Q4. 컨테이너에 영구적인 스토리지(데이터 저장 영역)를 부여하려면?

docker run -v /host/path:/container/path ubuntu:22.04

Q5. 컨테이너와 Docker 데몬의 자동 시작 설정은 어떻게 하나요?

docker run --restart=unless-stopped -d --name myubuntu ubuntu:22.04 tail -f /dev/null

Q6. 다른 OS용 Docker 이미지도 Ubuntu에서 실행할 수 있나요?

Q7. 이미지와 컨테이너가 너무 많이 늘어났을 때 정리 방법은?

• 전체 중지된 컨테이너 삭제

  docker container prune

• 미사용 이미지 삭제

  docker image prune

• 불필요한 데이터 일괄 정리

  docker system prune

Q8. 문제 발생 시 지원 및 정보원은?

Q9. Docker Compose 등 다중 컨테이너 관리 도구를 배우는 방법은?

Q10. 최신 Ubuntu 버전(예: 24.04)에서도 사용할 수 있나요?