Raspberry Pi 5 에서 Docker 사용하기

Docker 공식 가이드에서 소개하고 있는 Docker를 사용하는 가장 쉬운 방법은 Docker Desktop을 설치하는 것입니다.

하지만 Raspberry Pi 5 는 arm64(aarch64) CPU 아키텍쳐를 사용하고 있기 때문에, Docker 공식 홈페이지의 설치 가이드를 따라하더라도 Docker Desktop을 제대로 설치할 수 없습니다.

해당 가이드에서는 사용자의 CPU가 amd64 기반의 x86_64 아키텍쳐라고 상정하고 있기 때문입니다.

어찌저찌 커뮤니티를 돌며 arm64 설치 방법을 찾아서 설치하더라도, 제대로 동작하지 않았습니다.

 

(Docker Desktop을 설치하기 위해서는 KVM을 활성화해야 하는데, 제가 삽질을 해본 결과 무슨무슨 모듈을 설치해야 하고... 또 arm64 아키텍쳐에서는 qemu 기반으로 동작하기 때문에 네이티브한 성능을 기대하기 어렵더라구요. 만약 이를 해결하는 방법을 아시는 분은 댓글 부탁드립니다.)

 

따라서 라즈베리파이 5 사용자들이 Docker와 Docker Compose를 설치하실 때 도움이 될까 싶어 경험을 공유합니다.

 

본 가이드는 여러분이 Raspberry Pi 5에 공식 Raspberry Pi OS를 설치했다고 가정합니다.
(Debian based, Linux raspberrypi 6.6.51+rpt-rpi-2712)

 

기본적으로 아래 Debian 기반 설치 가이드를 따르면 됩니다.

https://docs.docker.com/engine/install/debian/

 

우선 혹시 모를 충돌을 방지하기 위해서 설치되어 있는 Docker 관련 패키지들을 제거합니다.

for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove $pkg; done

 

그리고 apt repository를 활용한 설치를 진행합시다.

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

# Latest Version으로 설치 진행
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

 

설치가 완료되면 Docker 서비스가 자동으로 시작됩니다.

잘 돌아가고 있는지 다음 명령어로 확인해볼 수 있습니다.

sudo systemctl status docker

# 만약 안 돌아가고 있다면 아래 명령어로 수동으로 시작해줍시다.
sudo systemctl start docker

# Optional: hello-world 이미지를 사용해서 도커가 잘 돌아가는지 최종적으로 확인해줍시다.
sudo docker run hello-world

 

Docker Engine이 정상적으로 설치되었습니다.

Docker Compose도 설치 과정에 포함되어 있었기 때문에, 함께 잘 설치되었을 것입니다. 다음 명령어로 확인해볼 수 있습니다.

docker compose version
# Expected output: Docker Compose version v2.40.0

 

 

작은 도움이 되었기를 바랍니다.