Harbor 사용 후기

Docker를 써야만 했다.

Docker라는 것은 참 신기하다. 없어도 충분히 할 수 있었고, 진입장벽도 높아서 신입 때는 “이걸 왜 사용해야 할까?“라는 의문이 떠나질 않았다. 하지만 학습이 끝나고 사용해야 하는 이유를 느끼게 되자, 이제는 Docker 없는 개발자의 삶을 상상하기 어려워졌다.

처음 약간의 진입장벽만 넘으면, 마치 넓은 평야가 펼쳐지듯 허들을 넘어야 할 이유는 충분했다. 이번에 AI 관련 수업을 들으면서 Hugging Face에 있는 수많은 모델들을 내가 만든 서비스에 녹여내고 싶었다. 그래서 집에서 운영 중인 PC에 Docker로 각 서비스를 운영하기로 했다.

하지만 문제는 비용이었다. 현재 직장을 쉬며 공부 중이라 수입이 없어, 최대한 비용을 아껴야 했다. Docker Hub 구독으로 Private Repository를 사용하기엔 부담스러웠고, 대안을 찾아 나섰다.

가장 먼저 알게 된 방법은 docker-registry를 설치해 자신의 로컬 PC에서 직접 운영하는 것이었다. 하지만 더 살펴보다가 Harbor라는 오픈소스 서비스를 알게 되었고, 여러 가지 관리 기능까지 제공한다는 점에서 큰 매력을 느꼈다. 그래서 바로 사용해보기로 했다.

Harbor 설치 방법

arbor 설치는 기본적으로 다음 단계를 따랐다. 네트워크 지식이 부족한 탓에 처음엔 약간 애를 먹었지만, 덕분에 많은 것을 배웠다.

1. Docker 및 Docker Compose 설치

# Docker 설치
sudo apt update
sudo apt install -y docker.io

# Docker Compose 설치
sudo apt install -y docker-compose

Harbor는 컨테이너로 구동되기 때문에, 우선 Docker와 Docker Compose가 설치되어 있어야 한다. 설치 명령어는 다음과 같다.

2. Harbor 설치 파일 다운로드

Harbor의 설치 파일은 Harbor 공식 GitHub에서 다운로드할 수 있다. 아래 명령어로 최신 버전을 다운로드하고 압축을 해제했다.

wget https://github.com/goharbor/harbor/releases/download/v<VERSION>/harbor-offline-installer-v<VERSION>.tgz
tar -xvzf harbor-offline-installer-v<VERSION>.tgz
cd harbor

3. 설정 파일 수정

설치 디렉토리 안에 있는 harbor.yml 파일을 수정했다. 주로 변경한 항목은 다음과 같다:

hostname: Harbor 서버의 IP 주소 또는 도메인.
https 설정: SSL 인증서를 적용하고 싶다면 관련 경로 설정.

4. Harbor 설치 및 실행

설정을 마친 후, 다음 명령어로 Harbor를 설치하고 실행했다.

./install.sh

5. Harbor 웹 접속

설치가 완료되면 브라우저에서 http:// 또는 https:// 으로 접속해 Harbor 웹 UI에 로그인할 수 있다. 기본 계정은 아래와 같다: • 아이디: admin • 비밀번호: Harbor12345 (설치 중 변경 가능)

Harbor의 웹 UI는 깔끔하고 직관적이었다. 사용해보며 느낀 장점은 다음과 같다:

Private Repository 관리가 간편하다 Docker 이미지를 Private Repo로 저장하고 관리할 수 있어, 외부 의존도를 줄이고 보안도 강화할 수 있었다.
사용자 및 프로젝트 관리 기능 팀 협업 환경에서도 유용할 것으로 보인다. 사용자 권한을 세분화할 수 있어, 여러 사람이 사용할 때도 안전하게 운영 가능하다.
Webhook과 보안 정책 특정 조건에 따라 Webhook을 설정하거나 이미지 보안 검사를 수행할 수 있는 기능이 매력적이었다. 개인 프로젝트뿐만 아니라 상용 프로젝트에도 충분히 활용 가능해 보였다.

아쉬운 점

처음 설치 과정에서 네트워크와 포트 설정 문제로 약간의 시행착오가 있었다. 특히 방화벽 설정이나 SSL 인증서 적용은 초보자에겐 약간 복잡하게 느껴질 수 있다.
관리 기능이 많다 보니 처음엔 모든 옵션을 이해하는 데 시간이 필요했다.

결론

Harbor는 Docker Registry의 강력한 대안이었다. 특히 비용을 아끼고 싶지만, 관리 기능도 놓치고 싶지 않은 사람들에게 완벽한 솔루션이다. 개인 서버에 Docker Private Repo가 필요하다면 한 번 도전해볼 만하다.

직접 설치하고 운영하면서 배우는 재미도 있으니, 관심 있다면 꼭 한 번 시도해보길 추천합니다

Docker를 써야만 했다.

Harbor 설치 방법

Harbor 사용 후기

아쉬운 점

결론

댓글