[Docker] 포테이너(Portainer) 설치 & 개념 정리

포테이너(Portainer) 설치 & 개념 정리

---

init

도커를 쉽게 관리할 수 있는 방법은 Portainer를 이용하는 것입니다. Portainer란 Docker 환경을 쉽게 관리할 수 있도록 도와주는 웹 기반의 GUI 관리도구 입니다. 이번 포스팅에서는 Portainer의 개념을 정리하고, Ubuntu 24.04.1 LTS 환경에서 Portainer를 설치하는 방법을 작성하려 합니다.

---

포테이너란?

Portainer는 컨테이너 관리의 복잡성을 줄이기 위해 설계된 경량의 도구입니다. 이를 통해 사용자는 실행 중인 컨테이너, 설치한 이미지, 볼륨 등의 상태를 직관적으로 확인할 수 있으며, 몇 번의 클릭만으로 컨테이너의 상태를 변경하거나 필요한 애플리케이션을 빠르게 배포할 수 있습니다. 특히, 템플릿 기능을 활용하면 반복적인 작업을 줄이고 원하는 환경을 손쉽게 구성할 수 있습니다. 많은 사용자들이 다운로드하여 활용하는 유용한 관리 도구입니다.

---

포테이너 필요성 및 장점

💡 GUI 툴로 Docker Desktop 이 있는데 Portainer를 꼭 사용해야 하나요??

GUI 방식으로 관리하는 도구로는 Docker Desktop을 사용하기도 합니다. Docker Desktop은 로컬 환경에서 컨테이너를 쉽게 관리할 수 있도록 설계된 도구입니다. 기본적으로 로컬 호스트(127.0.0.1)에서만 접근 가능하며, 별도의 네트워크 설정 없이 외부에서 직접 접근하는 것은 불가능합니다. 컨테이너를 외부에서 접근하려면 포트 포워딩, 네트워크 브릿지, WSL 설정 조정 등의 추가적인 작업이 필요합니다.

 

하지만 왜 굳이 Desktop을 설치 안 하고 Portainer를 설치하려는 이유는 Docker Desktop을 사용하면 윈도우 환경에서 GUI 방식으로 컨테이너를 쉽게 관리할 수 있습니다. 하지만 Portainer는 웹으로된 GUI 환경을 제공해서 외부에서 접속이 가능하다.  활용하면 더 효율적인 컨테이너 관리, 외부 접속, 팀 협업 환경 구축이 가능하다는 점에서 큰 장점을 가집니다.

---

포테이너 설치

저는 도커 관련 컨테이너는 따로 폴더를 두어 관리를 하려 합니다. 

저는 도커 관련 컨테이너는 한 곳에서 효율적으로 관리하기 위해 최상단(/)에 data 폴더를 만들어 둘 예정입니다.

 

# data 폴더 생성
$ sudo mkdir -p /data

# 최신 포테이너 설치
$ sudo docker run -d \
  --name portainer \
  -p 8001:9000 \
  --restart always \
  -v /data/portainer:/data \
  -v /var/run/docker.sock:/var/run/docker.sock \
  portainer/portainer-ce:latest

 

 

옵션	의미
-p 8001:9000	해당 옵션은 포트 매핑을 의미합니다. 호스트의 8001번 포트로 접속하면, 컨테이너 내부의 9000번 포트로 전달 됩니다. - 8001: 호스트 포트 - 9000: 컨테이너 포트  호스트의 8001번 포트 → 컨테이너의 9000번 포트
--name portainer	컨테이너 이름을 지정합니다.  - portainer: 컨테이너 이름
--restart always	도커가 실행되면 컨테이너가 자동 재시작 되록하는 옵션입니다.
-v /data/portainer:/data	볼륨 마운트 옵션입니다. 컨테이너가 전에 만들어 두었던 data 폴더에 저장됩니다. - /data/portainer: 호스트 디렉토리 - /data: 컨테이너 디렉토리 📢  Portainer의 데이터가 호스트 /data/portainer에 저장되므로 컨테이너가 삭제돼도 데이터 유지됩니다.
-v /var/run/docker.sock:/var/run/docker.sock	Docker 소켓을 컨테이너 내부에서 사용하도록 연결
portainer/portainer-ce:latest	사용할 이미지 입니다.  - portainer/portainer-ce: 커뮤니티 버전 사용 - latest: 가장 최신 버전

---

포테이너 설치 확인 

명령어를 실행해 포테이너가 정상적으로 설치되었는지 확인합니다. 출력 결과에 portainer 컨테이너가 보이면 정상적으로 설치가 진행된 것입니다.

$ docker ps

---

포테이너 로그인

Portainer 웹주소로 접속합니다. 주소는 http://{서버 IP}:8001입니다. 초기 진입 시 유저를 생성하는 화면이 나타납니다.

Portainer 유저 생성 화면

유저 생성후 초기 진입 화면

 

컨테이너 리스트 화면

 

위 화면과 같이 카테고리에서 Containers를 클릭해서 화면에 들어가면 현재 설치된 컨테이너 리스트를 확인할 수 있습니다.

---

마무으리

드디어 고군분투 끝에 Portainer 설치를 완료했습니다! 🎉

설치 후 기본적인 기능을 사용해 보고 컨테이너도 직접 생성해 보니, 확실히 설치와 구동이 매우 간편하다는 걸 느꼈습니다. 앞으로 더 다양한 기능을 익히고, 기본적인 컨테이너 생성 및 활용법을 학습한 후에 사용법을 정리한 포스팅을 작성할 계획입니다. 💪

이 글이 필요한 분들에게 도움이 되기를 바랍니다! 🙏