A. 사용환경

• OS : Rocky Linux 9.5 (Blue Onyx)
• Docker : 28.0.4

B. Portainer란?

docker를 사용할 때 명령어 기반으로 사용해도 되지만... 여전히 GUI는 필요하다.(ㅎㅎ)
Portainer를 간단하게 설명하면 docker 관리소프트웨어(웹기반)정도로 이해해도 된다. Portainer 공식 홈페이지에서 확인해보면 기능이 아주 많은 것 같은데... 사실 나의 경우에는 아주 단순한 기능만 사용하고 있다.

명령어는 계속 사용하면 괜찮은데... 가끔씩 기억이 안날때가 있어서 GUI의 힘을 이용해보자!
그래도 docker를 처음 사용해보는 사람이라면 명령어기반으로 학습을 해보는 것을 권장한다. 명령어를 알고서 GUI 화면을 보는 것과 그냥 화면만 보는 것은 큰 차이가 있다.

C. Portainer용 도커볼륨 생성

$ sudo docker volume create portainer_data
portainer_data
$

이제 잘 생성되었는지 확인한다.

$ sudo docker volume ls
DRIVER    VOLUME NAME
local     portainer_data
$

위 처럼 지정한 명칭인 portainer_data라는 볼륨이 확인되면 정상적으로 생성된 것이다. 실제로 저장 위치는 /var/lib/docker/volumes하위에 저장된다.

$ sudo ls -al /var/lib/docker/volumes
total 24
drwx-----x.  3 root root     72 Apr 14 15:30 .
drwx--x---. 12 root root    171 Apr 11 12:29 ..
brw-------.  1 root root 253, 0 Apr 11 12:29 backingFsBlockDev
-rw-------.  1 root root  32768 Apr 14 15:30 metadata.db
drwx-----x.  3 root root     19 Apr 14 15:30 portainer_data
$

D. 설치할 이미지 선택

개인적으로는 특정 컨테이너 이미지의 latest태그가 붙은 최신버전을 선호하지 않는다. docker ps로 조회했을 때 현재 적용된 버전을 확인하기 어렵고... 의도하지 않게 latest 이미지로 업그레이드가 됬을 경우에 부작용이 발생할 수 있으므로 특정 버전을 지정해서 설치하고, 업그레이드가 되는 것을 추적해서 수동으로 버전업그레이드를 시켜주는 것을 선호한다.(일을 사서 만드는 경향이 있음...)

만약에 그냥 최신버전을 설치하고, 항상 최신 버전으로 유지하기 원하시는 분이라면 바로 설치로 넘어가면 될 것 같다.

가장 간단한 방법은 docker hub에 접속해서 latest와 동일한 Digest를 가진 버전을 선택하는 것이다.(설치할 때 기준으로?)

https://hub.docker.com/r/portainer/portainer-ce/tags

위 링크에 접속해서.... 구동할 서버의 아키텍쳐와 OS에 해당하는 Digest를 복사해서 검색해보자.

동일한 Digest를 가진 버전을 확인해보니 2.27.3이다. (2025/04/14 기준)

설치를 원하는 버전을 찾았으니 이제 아래의 명령어로 컨테이너 이미지를 다운받자!

$ sudo docker pull portainer/portainer-ce:2.27.3
2.27.3: Pulling from portainer/portainer-ce
e2e06b27b87e: Pull complete
1fed1531b45b: Pull complete
04de093ad5ed: Pull complete
86a7cce72d42: Pull complete
e09df2601140: Pull complete
eae3ebf29ea8: Pull complete
c12aa3fbd31a: Pull complete
f111bda3f9a6: Pull complete
81021110ed01: Pull complete
4f4fb700ef54: Pull complete
Digest: sha256:7f10a26bfdda3fc58295ea09b860117ecd86a642d66fb94ce1f27a4c221d4649
Status: Downloaded newer image for portainer/portainer-ce:2.27.3
docker.io/portainer/portainer-ce:2.27.3
$

프로그레스바들이 출력되면서 전부 Pull complete가 뜨고, 프롬프트가 떨어지면서 다음 입력을 대기하면 완료된 것이다. 아래의 명령어로 이미지 목록을 확인해보자.

$ sudo docker image ls
REPOSITORY               TAG       IMAGE ID       CREATED        SIZE
portainer/portainer-ce   2.27.3    fab249e1b82c   2 weeks ago    268MB
hello-world              latest    74cc54e27dc4   2 months ago   10.1kB
$

방금 다운 받은 portainer/portainer-ce:2.27.3이미지와 처음 docker를 설치했을 때 다운받았던 hello-world 컨테이너 이미지가 있다.

E. Portainer 배포

Portainer 공식 설치문서에서 가이드한 명령어세 tag 부분만 위에서 pull로 다운받은 tag로 변경한다.

$ sudo docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:2.27.3

그리고 docker ps명령어로 확인

$ sudo docker ps
CONTAINER ID   IMAGE                           COMMAND        CREATED         STATUS         PORTS                                                                                                NAMES
bd30f258d1ca   portainer/portainer-ce:2.27.3   "/portainer"   7 seconds ago   Up 7 seconds   0.0.0.0:8000->8000/tcp, [::]:8000->8000/tcp, 0.0.0.0:9443->9443/tcp, [::]:9443->9443/tcp, 9000/tcp   portainer
$

F. 설치 마무리

이제 웹브라우저를 실행해서 https://[도커서버IP주소]:9443으로 접속한다.

ID와 Password를 입력하면 아래와 같이 성공!

Get Started를 선택하면...

이제 사용준비가 완료되었다! 이젠 GUI 환경으로 docker 컨테이너를 배포할 수 있다.

G. 참고문서

1. https://docs.portainer.io/start/install-ce/server/docker/linux