우분투 서버 ‘도커’ Docker ‘포테이너’ Portainer 설치 방법

하나의 OS 환경에서 이것 저것 다양하게 사용 할 수 있도록 도와 주는 Docker 라는 서비스는 가상화 도구 입니다.

하지만 일반 VMware, VitrualBox 등 과 같이 OS 부터 모든 시스템 파일이 설치 되는 것이 아닌 해당 서비스를 구동 하기 위한 딱 그 부분만 설치가 가능 해 매우 효율적 입니다.

그리고 이 ‘도커’ 는 SSH 등에 접속 해서 코드 작성 없이 웹 에서 접속 해서 사용 할 수 있도록 ‘Portainer’ 라는 서비스도 같이 제공 하고 있습니다.

설치 방법 등 과 같은 기본적인 사용 법이 Docker 설명서 에 잘 정리 되어 있습니다.

그리고 별다른 설명이 필요 없을 정도로 아주 간단한데 추후 ‘도커’ 와 ‘포테이너’ 설명에서 필요한 부분 으로 별도 설치 과정을 정리 합니다.

사진은 명령어를 입력 한 후 반환 되는 내용들을 참고하는 용도 이고 설치 간 작성해야 하는 구문은 모두 같이 안내하니 내용을 그대로 진행 한다면 어렵지 않게 설치 할 수 있을 것 입니다.


해당 포스트는 충분한 테스트 및 검증 후 작성 되었지만 이것이 해당 내용의 정확성이나 신뢰성에 대해 보증을 하는 것은 아니니 단순 하게 참고용으로 봐주시길 바랍니다.

튜토리얼 환경 : VMware® Workstation 16 Pro , Ubuntu 20.04.3 LTS Server

Docker ‘도커’ 설치 절차

다양한 OS 에서 설치를 할 수 있지만 오늘은 개인적으로 자주 사용 하는 우분투 기준으로 설명 합니다.

기본 적인 패키지 업데이트 , 업그레이드

root_권한_부여
root 권한 부여
  1. 1 일단 입력을 편하게 하기 위해 Root 권한을 사용 합니다. 이는 선택 사항 입니다. 설명에서는 관리자 권한이지만 sudo 를 추가해서 정리 합니다.
sudo su - root
패키지_업데이트
패키지 업데이트
  1. 2 운영 체제에서 사용 가능한 패키지 들과 그 버전에 대한 정보를 업데이트 합니다.
sudo apt update
패키지_업그레이드
패키지 업그레이드
  1. 3 apt upgrade 명령으로 설치 한 패키지들을 최신 버전으로 업그레이드 합니다. OS 설치 후 업그레이드 하지 않았거나 최초 설치 인 경우 시간이 오래 소요 될 수 있습니다.
sudo apt upgrade
도커_필수_패키지_설치
도커 필수 패키지 설치
  1. 1 ‘도커’ 필수 패키지를 설치 합니다.
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

  1. 2 설치 간 진행 여부를 묻는 메시지가 나오면 입력 합니다.
y
GPG_키_인증
GPG 키 인증
  1. 1 ‘도커’ 패키지의 인증을 위한 GPG Key 를 추가 합니다.
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
  1. 2 명령어 입력 시 OK 를 반환 하면 정상적으로 완료 된 것 입니다.

Docker repository 추가

사용 중인 아키텍처에 맞추어 Docker repository (저장소) 를 추가 합니다. 아키텍쳐 정보를 모르는 경우 arch 명령으로 확인 할 수 있습니다.

일반적으로는 아래와 같은 아키텍처 선택이 가능 합니다.

  • amd64
  • armhf
  • arm64
Docker_repository_등록
Docker repository 등록
  1. 1 아래 정리한 순서대로 한줄 씩 작성 합니다. 첫 번째 라인 입력 시 > 로 전환 됩니다.

sudo add-apt-repository \
> “deb [arch=amd64] https://download.docker.com/linux/ubuntu \
> $(lsb_release -cs) \
> stable”

> 는 제외 하고 입력

  1. 2 이미지 와 같이 출력 되면서 Reading paskage list… Done 이라고 마무리 되면 정상적으로 추가 된 것 입니다.

Docker 설치

‘도커’ 설치 하고 시작 등록 한다음 실행 하는 부분까지 진행 합니다.

패키지 설치

docker_설치
docker 설치
  1. 1 이제 ‘도커’ 설치 명령으로 설치를 진행 합니다.
sudo apt-get update && sudo apt-get install docker-ce docker-ce-cli containerd.io
  1. 2 설치간 진행 여부를 묻는 메시지가 나오면 입력 합니다.
y
docker_설치_완료
docker 설치 완료
  1. 3 잠시 설치가 진행 되니 기다려 줍니다.

‘도커’ 버전 확인

docker_버전_확인
docker 버전 확인
  1. 1 설치 된 ‘도커’ 의 버전을 확인 할 수 있습니다.
docker -v

‘도커’ 시작 등록 및 실행

도커_서비스_시작_등록_및_실행
도커 서비스 시작 등록 및 실행
  1. 1 도커가 OS 재부팅 후에 자동적으로 시작 enable 되도 록 등록을 해야 합니다. 그리고 실행 까지 해보겠습니다.
sudo systemctl enable docker && service docker start
Docker_정상_동작_중
Docker 정상 동작 중
  1. 2 현재 도커가 정상적으로 동작 하는 지 확인 할 수 있습니다.
service docker status
  1. 3 해당 화면을 종료 하기 위해서는 Q 를 입력 하면 됩니다.

Portainer ‘포테이너’ 설치 절차

‘포테이너’ 설치를 하고 웹 으로 접속 하는 부분 까지 정리 합니다.

‘포테이너’ 설치

포테이너는 ‘도커’ 서비스 입니다. ‘도커’ 관련 된 서비스라는 것도 맞는데, 이 ‘포테이너’ 라는 서비스 자체도 ‘도커’ 컨테이너로 실행 되고 있습니다.

그래서 명령어가 굉장히 간단 합니다.

portainer_디렉토리_생성
portainer 디렉토리 생성
  1. 1 아래 명령으로 portainer 라는 디렉토리를 생성 해 줍니다.
mkdir -p /data/portainer
docker_실행
docker 실행
  1. 2 아래 명령어를 입력하여 ‘포테이너’ 이미지를 내려받고 실행 해 줍니다.
docker run --name portainer -p 9000:9000 -d --restart always -v /data/portainer:/data -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer
  1. 3 간단하게 내용을 설명 하면 아래와 같습니다.
    • –-name: 컨테이너 생성
    • -p: 호스트 포트, 내부 포트 지정
    • -d: 데몬으로 백그라운드 실행
    • –restart always: 재 부팅 시 서비스 자동 시작
    • -v /data: 호스트 와 ‘도커’ 컨테이너간 볼륨 매칭
    • docker.sock: 컨테이너 내부에서 데몬과 상호 작용(공유)

‘포테이너’ 접속

이제 브라우저에 IP 를 입력 해 현재 포테이너가 설치 된 장치로 접속 할 수 있습니다.

아이피_확인
아이피 확인
  1. 1 만약 현재 사용 중인 아이피를 모르는 경우 ifconfig 를 사용 합니다.
Portainer_접속
Portainer 접속
  1. 2 브라우저 주소창에 ip:9000 이라고 입력 하면 ‘포테이너’ 로 접속 됩니다.
  2. 3 이 곳에서 최초 등록한 아이디비밀번호가 계정 정보가 됩니다.
  3. 4 필드를 모두 채운 다음 Create user 버튼으로 접속 할 수 있습니다.
Local_Docker_와_Connect
Local Docker 와 Connect
  1. 5 ‘도커’ 관리 환경 설정 화면 입니다. 포테이너가 설치된 서버에서 도커를 같이 실행시킬 것이므로 Local 탭을 선택 한 다음 Connect 버튼을 눌러 줍니다.
포테이너_홈
포테이너 홈
  1. 6 ‘포테이너’ 홈으로 이동 했습니다. 이 부분이 도커의 현재 상황 이라고 보면 됩니다.

마무리

이렇게 우분투에서 ‘도커’ Docker 와 ‘포테이너’ Portainer 를 설치 하는 전체 과정 에 대해 알아 보았습니다.

이제 도커 허브 ( https://hub.docker.com/ ) 에서 다양한 이미지를 다운로드 해서 사용 해보시길 바랍니다.

참고

Leave a Comment