docker(Ubuntu 20.04) / Portainer

Overview

이 글에서는 Ubuntu에 Docker를 설치하는 방법과 Portainer를 이용한 Docker 관리 방법을 다룬다.
Docker는 리눅스 환경에서 컨테이너 기반 가상화 기술을 제공하며,
Ubuntu는 Linux 계열 운영체제이므로 바로 설치하여 사용할 수 있다.

이제 Docker 설치부터 Portainer 설정까지 차근차근 진행해보자.

 

 

 

---

 

Ubuntu에 Docker 설치하기

 

1️⃣ 필수 패키지 설치

 

먼저, apt가 HTTPS 프로토콜을 통해 저장소(repository)를 사용할 수 있도록 패키지를 설치한다.

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

 

 

 

2️⃣ Docker 공식 저장소 추가

 

Docker를 설치하려면, 공식 저장소를 APT 소스 리스트에 추가해야 한다.

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

 

 

3️⃣ Docker 설치 및 실행

 

이제 Docker 패키지를 설치하고 서비스를 활성화한다.

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

 

 

 

📌 혹시 오류 발생?

sudo apt install docker.io

위 명령어로 docker.io를 설치하면 해결될 수 있다.

 

 

 

4️⃣ Docker 서비스 자동 실행 설정

 

Docker가 시스템 부팅 시 자동으로 시작되도록 설정한다.

sudo systemctl enable docker sudo systemctl start docker

 

 

✅ 설치 확인

sudo systemctl status docker

💡 Active (running) 상태라면 Docker 서비스가 정상적으로 동작 중이다!

 

 

 

 

---

 

 

 

Portainer란?

🔹 Portainer는 Docker의 컨테이너, 네트워크, 볼륨 등을 쉽게 관리할 수 있도록 도와주는 GUI 웹 인터페이스이다.
🔹 Docker의 이미지 = Windows ISO 파일처럼 생각하면 된다.
🔹 Docker Hub (hub.docker.com)에서 다양한 이미지(ex. CentOS, Nginx, MariaDB 등)를 다운로드할 수 있다.

이제 Portainer를 설치하고, GUI로 Docker를 쉽게 관리하는 방법을 알아보자.

 

 

 

 

Portainer 설치하기

 

1️⃣ Portainer 볼륨 매칭을 위한 디렉터리 생성

컨테이너와 호스트 간 볼륨 공유를 위해 `/data` 디렉터리를 만든다.

 

 

 

2️⃣ Portainer 컨테이너 실행

sudo docker run -d \
  --name portainer \
  -p 9000:9000 \
  --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /data:/data \
  portainer/portainer-ce

 

 

 

📌 설명

• `--name portainer` → 컨테이너 이름 지정
• `-p 9000:9000` → 외부 포트(호스트: 9000) ↔ 내부 포트(컨테이너: 9000) 연결
• `-d` → 백그라운드에서 실행 (데몬 모드)
• `--restart always` → 시스템 재부팅 시 자동 실행
• `-v /var/run/docker.sock:/var/run/docker.sock` → Docker API 소켓 공유
• `-v /data:/data` → Portainer 데이터 저장

 

 

3️⃣ 방화벽 설정 (필요 시 추가)

sudo ufw allow 9000/tcp sudo ufw reload

✅ 이제 PC의 IP 주소 + 포트(9000)를 입력하여 웹 브라우저에서 Portainer에 접속할 수 있다.

 

 

 

Portainer 웹 인터페이스 설정

 

1️⃣ 웹 브라우저에서 Portainer 접속

http://<서버 IP>:9000

 

2️⃣ 관리자 계정 생성

• 사용자 ID & 비밀번호 입력 후 Create User 클릭

 

 

3️⃣ Local Docker 연결

• "Local" 선택 → "Connect" 클릭

 

 

 

 

✅ 설정 완료! 

 

 

 

 

Portainer를 활용한 Docker 관리

Portainer를 이용하면 GUI 환경에서 Docker를 쉽게 관리할 수 있다.
아래 메뉴에서 다양한 기능을 사용할 수 있다.

 

📌 Portainer 주요 기능

🔹 Dashboard → Docker 컨테이너, 네트워크, 볼륨 등의 개요 확인
🔹 Templates → 미리 설정된 Docker 템플릿으로 쉽게 컨테이너 배포
🔹 Containers → 컨테이너 상태 확인, 실행/중지, 로그 조회, 삭제
🔹 Images → Docker Hub에서 새로운 이미지 다운로드
🔹 Networks → Docker 네트워크 설정 및 관리

 

성공!!

Dashboard

 

 

template

 

container

 

 

 

 

 

 

---

 

 

 

 

마무리

✅ Ubuntu에 Docker를 설치하고 Portainer로 GUI 관리 환경을 구축하였다.
✅ 이제 Docker 컨테이너를 GUI 환경에서 쉽게 관리할 수 있다.
✅ Portainer를 통해 Docker의 이미지, 컨테이너, 네트워크를 시각적으로 확인할 수 있다.

💡 이제 Docker를 활용하여 Nginx, MySQL, Redis 등의 컨테이너를 직접 배포해보자!

 

 

 

 

---

 

Reference

🔗 Docker 공식 문서
🔗 Portainer 공식 문서

🚀 더 많은 정보는 Docker Hub (https://hub.docker.com) 에서 확인 가능!