라즈베리파이에서 Docker로 시작하는 컨테이너 혁명: 초보자를 위한 완벽 가이드

🐳 라즈베리파이와 Docker의 강력한 조합을 경험해보세요! 이 가이드를 통해 미니 컴퓨터에서 최신 컨테이너 기술을 마스터할 수 있습니다. 복잡한 설정은 잊으세요. 단계별 설명으로 누구나 쉽게 따라할 수 있습니다. 지금 바로 라즈베리파이를 강력한 컨테이너 플랫폼으로 변신시켜보세요!

목차

1. Docker와 컨테이너 소개
2. 라즈베리파이 준비하기
3. Docker 설치하기
4. 첫 번째 Docker 컨테이너 실행하기
5. 도커 이미지 만들기
6. Docker Compose 사용하기
7. 라즈베리파이에서 유용한 Docker 애플리케이션
8. Docker 네트워크 설정
9. 데이터 관리와 볼륨
10. Docker 컨테이너 모니터링
11. 보안 고려사항
12. 트러블슈팅
13. 결론 및 다음 단계

 

Docker와 컨테이너 소개

Docker는 애플리케이션을 컨테이너라는 표준화된 유닛으로 패키징하고 실행할 수 있게 해주는 플랫폼입니다. 컨테이너는 경량화되어 있고, 모든 필요한 파일과 라이브러리를 포함하고 있어 어떤 환경에서도 동일하게 실행될 수 있습니다.

Docker를 사용하면 다음과 같은 이점이 있습니다:

• 일관된 개발 및 배포 환경
• 리소스 효율성
• 빠른 배포 및 확장
• 애플리케이션 격리

라즈베리파이에서 Docker를 사용하면, 이 작은 컴퓨터를 강력한 홈 서버나 개발 플랫폼으로 변신시킬 수 있습니다.

 

라즈베리파이 준비하기

Docker를 설치하기 전에 라즈베리파이를 준비해야 합니다:

1. 최신 Raspberry Pi OS를 설치합니다. (64비트 버전 권장)
2. 시스템을 업데이트합니다:

# 패키지 목록 업데이트
sudo apt update
# 설치된 패키지 업그레이드
sudo apt upgrade -y

3. 재부팅합니다:

# 시스템 재부팅
sudo reboot

 

Docker 설치하기

라즈베리파이에 Docker를 설치하는 과정은 다음과 같습니다:

1. 공식 스크립트를 사용하여 Docker 설치:

# Docker 설치 스크립트 다운로드 및 실행
curl -sSL https://get.docker.com | sh

2. 현재 사용자를 docker 그룹에 추가 (sudo 없이 Docker 명령어 실행 가능):

# 현재 사용자를 docker 그룹에 추가
sudo usermod -aG docker $USER

3. 변경사항을 적용하기 위해 로그아웃 후 다시 로그인하거나 시스템을 재부팅합니다.
4. Docker가 정상적으로 설치되었는지 확인:

# Docker 버전 확인
docker --version

5. Hello World 컨테이너를 실행하여 테스트:

# Hello World 컨테이너 실행
docker run hello-world

 

첫 번째 Docker 컨테이너 실행하기

간단한 웹 서버를 Docker 컨테이너로 실행해 보겠습니다:

1. Nginx 웹 서버 컨테이너 실행:

# Nginx 웹 서버 컨테이너 실행
docker run -d -p 80:80 --name my-nginx nginx

– -d: 백그라운드에서 실행
– -p 80:80: 호스트의 80 포트를 컨테이너의 80 포트에 연결
– --name my-nginx: 컨테이너 이름 지정
– nginx: 사용할 이미지 이름

2. 브라우저에서 라즈베리파이의 IP 주소로 접속하여 Nginx 웹페이지를 확인합니다.
3. 실행 중인 컨테이너 목록 확인:

# 실행 중인 컨테이너 목록 확인
docker ps

4. 컨테이너 중지:

# 컨테이너 중지
docker stop my-nginx

5. 컨테이너 제거:

# 컨테이너 제거
docker rm my-nginx

 

도커 이미지 만들기

자신만의 Docker 이미지를 만들어 보겠습니다:

1. 새 디렉토리 생성:

# 새 디렉토리 생성 및 이동
mkdir my-docker-app
cd my-docker-app

2. 간단한 Python 애플리케이션 작성 (app.py):

# app.py
from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'Hello, Docker on Raspberry Pi!'

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

3. Dockerfile 작성:

# Dockerfile
FROM python:3.9-slim
WORKDIR /app
COPY . .
RUN pip install flask
CMD ["python", "app.py"]

4. 이미지 빌드:

# Docker 이미지 빌드
docker build -t my-flask-app .

5. 빌드한 이미지로 컨테이너 실행:

# 빌드한 이미지로 컨테이너 실행
docker run -d -p 5000:5000 --name my-flask-container my-flask-app

6. 브라우저에서 http://<라즈베리파이_IP>:5000으로 접속하여 확인합니다.

 

Docker Compose 사용하기

Docker Compose를 사용하면 여러 컨테이너로 구성된 애플리케이션을 쉽게 정의하고 실행할 수 있습니다:

1. Docker Compose 설치:

# Docker Compose 설치
sudo apt-get install docker-compose

2. docker-compose.yml 파일 작성:

# docker-compose.yml
version: '3'
services:
  web:
    image: my-flask-app
    ports:
      - "5000:5000"
  db:
    image: postgres
    environment:
      POSTGRES_PASSWORD: mysecretpassword

3. Docker Compose로 서비스 시작:

# Docker Compose로 서비스 시작
docker-compose up -d

4. 서비스 중지:

# Docker Compose로 서비스 중지
docker-compose down

 

라즈베리파이에서 유용한 Docker 애플리케이션

라즈베리파이에서 Docker를 활용할 수 있는 몇 가지 유용한 애플리케이션:

1. Portainer (Docker 관리 UI):

# Portainer 설치 및 실행
docker run -d -p 9000:9000 --name=portainer --restart=always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data portainer/portainer-ce

2. Pi-hole (네트워크 광고 차단):

# Pi-hole 설치 및 실행
docker run -d --name pihole -p 53:53/tcp -p 53:53/udp -p 80:80 \
-e TZ="Your_Timezone" \
-v "${DOCKER_CONFIGS}/pihole/:/etc/pihole/" \
-v "${DOCKER_CONFIGS}/dnsmasq.d/:/etc/dnsmasq.d/" \
--dns=127.0.0.1 --dns=1.1.1.1 \
--restart=unless-stopped \
pihole/pihole:latest

3. Home Assistant (홈 오토메이션):

# Home Assistant 설치 및 실행
docker run -d --name homeassistant --privileged \
--restart=unless-stopped \
-e TZ=YOUR_TIME_ZONE \
-v /PATH_TO_YOUR_CONFIG:/config \
-p 8123:8123 \
homeassistant/raspberrypi4-homeassistant:stable

 

 

Docker 네트워크 설정

Docker 네트워크를 이용하면 컨테이너 간 통신을 쉽게 설정할 수 있습니다:

1. 새 네트워크 생성:

# 새 Docker 네트워크 생성
docker network create my-network

2. 네트워크에 컨테이너 연결:

# 네트워크에 컨테이너 연결
docker run -d --name my-app --network my-network my-flask-app

3. 같은 네트워크의 다른 컨테이너에 연결 (예: 데이터베이스):

# 데이터베이스 컨테이너 실행 및 네트워크 연결
docker run -d --name my-db --network my-network postgres

 

데이터 관리와 볼륨

Docker 볼륨을 사용하면 컨테이너의 데이터를 영구적으로 저장할 수 있습니다:

1. 볼륨 생성:

# Docker 볼륨 생성
docker volume create my-data

2. 볼륨을 사용하여 컨테이너 실행:

# 볼륨을 마운트하여 컨테이너 실행
docker run -d -v my-data:/app/data my-flask-app

 

Docker 컨테이너 모니터링

컨테이너의 리소스 사용량을 모니터링하는 방법:

1. 실시간 컨테이너 상태 확인:

# 실시간 컨테이너 상태 모니터링
docker stats

2. 특정 컨테이너의 로그 확인:

# 컨테이너 로그 확인
docker logs my-container

3. 컨테이너 내부 프로세스 확인:

# 컨테이너 내부 프로세스 확인
docker top my-container

 

보안 고려사항

Docker를 안전하게 사용하기 위한 팁:

1. 항상 공식 이미지를 사용하거나 신뢰할 수 있는 소스의 이미지만 사용하세요.
2. 컨테이너에 필요한 최소한의 권한만 부여하세요.
3. 정기적으로 Docker와 컨테이너 이미지를 업데이트하세요.
4. 민감한 정보는 환경 변수나 Docker secrets를 사용하여 관리하세요.

 

트러블슈팅

일반적인 문제와 해결 방법:

1. 컨테이너가 시작되지 않을 때:
   • 로그를 확인: docker logs <container_name>
   • 리소스 부족 여부 확인: free -m, df -h
2. 네트워크 연결 문제:
   • 포트 매핑 확인: docker port <container_name>
   • 네트워크 설정 확인: docker network inspect <network_name>
3. 성능 문제:
   • 리소스 사용량 확인: docker stats
   • 불필요한 컨테이너나 이미지 정리: docker system prune

 

결론 및 다음 단계

축하합니다! 이제 라즈베리파이에서 Docker를 사용하여 컨테이너화된 애플리케이션을 배포할 수 있게 되었습니다. 이는 강력하고 유연한 홈 서버 구축의 시작점이 될 수 있습니다.

다음 단계로 고려해볼 만한 것들:

1. CI/CD 파이프라인 구축하기
2. Docker Swarm이나 Kubernetes로 컨테이너 오케스트레이션 시도하기
3. 다양한 self-hosted 애플리케이션 실험하기 (예: NextCloud, Gitea, Jellyfin 등)

Docker와 라즈베리파이의 조합으로 무한한 가능성이 열립니다. 계속 실험하고 학습하면서 여러분만의 강력한 홈 서버 생태계를 구축해 보세요! 🚀🏠💻

전체 코드

app.py

# app.py
from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'Hello, Docker on Raspberry Pi!'

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

Dockerfile

# Dockerfile
FROM python:3.9-slim
WORKDIR /app
COPY . .
RUN pip install flask
CMD ["python", "app.py"]

docker-compose.yml

# docker-compose.yml
version: '3'
services:
  web:
    image: my-flask-app
    ports:
      - "5000:5000"
  db:
    image: postgres
    environment:
      POSTGRES_PASSWORD: mysecretpassword

​​​​​​​​​​​​​​​​