Debian 11에 Portainer 설치하는 방법

Docker는 개발자가 애플리케이션을 쉽게 구축하고 실행하며 배포할 수 있도록 해주는 무료 오픈 소스의 가장 인기 있는 컨테이너 엔진입니다. 그러나 Docker CLI에 익숙하지 않은 초보자에게는 명령줄을 통해 컨테이너 애플리케이션을 관리하고 실행하는 것이 매우 어렵습니다. 이때 Portainer가 등장합니다. Portainer는 Docker 및 Kubernetes와 함께 작동하여 컨테이너화된 애플리케이션과 서비스를 더 쉽게 효율적으로 관리하고 배포할 수 있는 웹 기반 컨테이너 관리 플랫폼입니다.

이 튜토리얼에서는 Debian 11 서버에 Portainer를 설치하는 방법을 보여줍니다.

전제 조건

Debian 11 서버가 실행되고 있어야 합니다.
서버에 루트 비밀번호가 설정되어 있어야 합니다.

Docker CE 설치

시작하기 전에 서버에 Docker CE가 설치되어 있어야 합니다. 먼저, 다음 명령어를 사용하여 필요한 모든 종속성을 설치합니다.

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

다음으로, 다음 명령어를 사용하여 Docker GPG 키와 저장소를 추가합니다.

curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg  
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null

다음으로, 저장소를 업데이트하고 다음 명령어를 사용하여 Docker CE 패키지를 설치합니다.

apt update -y  
apt install docker-ce -y

Docker CE가 설치되면 다음 명령어를 사용하여 Docker 버전을 확인할 수 있습니다.

docker --version

다음과 같은 출력이 표시됩니다.

Docker version 20.10.23, build 7155243

Docker Compose 설치

시스템에 Docker Compose도 설치해야 합니다. 먼저, 다음 명령어를 사용하여 시스템에 Docker Compose 바이너리의 최신 버전을 다운로드합니다.

wget https://github.com/docker/compose/releases/download/v2.15.1/docker-compose-linux-x86_64

다음으로, 다운로드한 바이너리를 시스템 위치로 복사합니다.

cp docker-compose-linux-x86_64 /usr/local/bin/docker-compose

다음으로, Docker Compose 바이너리에 실행 권한을 설정합니다.

chmod +x /usr/local/bin/docker-compose

다음으로, 다음 명령어를 사용하여 Docker Compose 설치를 확인합니다:

docker-compose --version

다음과 같은 출력이 표시되어야 합니다:

Docker Compose version v2.15.1

Portainer 설치

먼저, 다음 명령어를 사용하여 Portainer 데이터를 저장할 볼륨을 생성합니다.

docker volume create data

이제 다음 명령어를 사용하여 생성된 볼륨을 확인할 수 있습니다.

docker volume ls

다음과 같은 출력이 표시됩니다.

DRIVER    VOLUME NAME
local     data

다음으로, 다음 명령어를 실행하여 Portainer Docker 이미지를 다운로드하고 실행합니다.

docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v data:/data portainer/portainer

다음과 같은 출력이 표시됩니다.

latest: Pulling from portainer/portainer
772227786281: Pull complete 
96fd13befc87: Pull complete 
0bad1d247b5b: Pull complete 
b5d1b01b1d39: Pull complete 
Digest: sha256:47b064434edf437badf7337e516e07f64477485c8ecc663ddabbe824b20c672d
Status: Downloaded newer image for portainer/portainer:latest
e0ee5b16c93f358a15dfcb93cc80d2c2d1c1c675e7b65e41434ce20f08773465

다음 명령어를 사용하여 Portainer의 상태를 확인할 수 있습니다.

docker ps

다음과 같은 출력이 표시됩니다.

CONTAINER ID   IMAGE                 COMMAND        CREATED          STATUS          PORTS                                                                                            NAMES
e0ee5b16c93f   portainer/portainer   "/portainer"   28 seconds ago   Up 27 seconds   0.0.0.0:8000->8000/tcp, :::8000->8000/tcp, 0.0.0.0:9000->9000/tcp, :::9000->9000/tcp, 9443/tcp   portainer

Portainer 웹 인터페이스에 접근

이 시점에서 Portainer가 설치되어 포트 9000에서 실행되고 있습니다. 이제 URL http://your-server-ip:9000을 사용하여 접근할 수 있습니다. 다음과 같은 페이지가 표시됩니다:

Portainer 로그인

관리자 사용자 이름, 비밀번호를 정의하고 사용자 생성 버튼을 클릭합니다. 다음과 같은 페이지가 표시됩니다:

Portainer 대시보드

시작하기 버튼을 클릭하여 모든 로컬 컨테이너의 상태를 확인합니다.

Portainer 환경

결론

축하합니다! Debian 11 서버에 Portainer를 성공적으로 설치했습니다. 이제 웹 기반 인터페이스를 통해 컨테이너화 플랫폼에서 애플리케이션을 쉽게 호스팅할 수 있습니다. 질문이 있으면 언제든지 문의해 주세요.

전제 조건

Docker CE 설치

Docker Compose 설치

Portainer 설치

Portainer 웹 인터페이스에 접근

결론

새 게시물을 받은 편지함에서 받기