📗 프로비저닝 - Harbor

🏳️‍🌈 [궁금한점]

• 로컬 환경에 이미지 저장소를 만들어 활용하는 방법

---

🔗[목차]

• Harbor 설치
  • 사전준비
  • Harbor 설치 파일 다운로드
  • harbor.yml 구성
  • 관리자 비밀번호
  • Harbor 설치 실행
  • 접속 확인
• Harbor 이미지 올리기
  • 1. Docker 로그인
  • 2. Harbor에서 프로젝트 생성
  • 3. 테스트 이미지 태깅 및 푸시
  • 4. 이미지 확인
  • (선택) 인증서 없는 HTTP Harbor 사용 시 docker push 실패하는 경우

Harbor 설치

Harbor(하버)를 Docker로 설치하는 방법은 공식적으로 Docker Compose를 사용하는 방식이 가장 간단하고 널리 사용된다. 운영 환경에서는 HTTPS + CA 인증서 + 외부 DB + reverse proxy 구성이 권장된다. Harbor는 기본적으로 다음 구성 요소를 포함한다.

• nginx
• core service
• jobservice
• registry
• database (PostgreSQL)
• Redis

사전준비

# Docker 설치
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

# Docker Compose 설치
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" \
-o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Harbor 설치 파일 다운로드

wget https://github.com/goharbor/harbor/releases/download/v2.10.0/harbor-online-installer-v2.10.0.tgz
tar xzvf harbor-online-installer-v2.10.0.tgz
cd harbor

버전은 공식 GitHub 릴리즈에서 최신 확인 가능

harbor.yml 구성

cp harbor.yml.tmpl harbor.yml

• vim harbor.yml

hostname: localhost         # 또는 IP, 도메인 (예: harbor.example.com)
http:
  port: 8088                # 기본 포트 변경 가능

# https 설정은 꺼두고 시작 (테스트 목적)
https:
  enabled: false

관리자 비밀번호

harbor_admin_password: Harbor12345

Harbor 설치 실행

sudo ./install.sh

설치 완료되면 Docker Compose로 Harbor가 실행된다

접속 확인

• 브라우저 접속: http://localhost:8080
• 기본 로그인:
• ID: admin
• PW: Harbor12345 (위에서 설정한 비밀번호)

Harbor 이미지 올리기

전제: Harbor가 http://localhost:8088 (HTTPS 안 씀) 에 설치되어 있다고 가정한다.

1. Docker 로그인

docker login localhost:8088

• 사용자명: admin
• 비밀번호: Harbor12345 (harbor.yml에서 지정한 값)

2. Harbor에서 프로젝트 생성

• 웹 브라우저에서 http://localhost:8088 접속 → Projects → New Project 클릭
• 예시: myproject 생성 (Public 설정해도 됨)

3. 테스트 이미지 태깅 및 푸시

docker pull nginx:latest
docker tag nginx:latest localhost:8088/myproject/nginx:latest
# Harbor로 푸시
``` bash
docker push localhost:8080/myproject/nginx:latest

4. 이미지 확인

웹 UI에서:

Projects → test-project 클릭 → Repositories → nginx에서 확인 가능

(선택) 인증서 없는 HTTP Harbor 사용 시 docker push 실패하는 경우

/etc/docker/daemon.json에 insecure registry 설정이 필요할 수 있다

{
  "insecure-registries": ["localhost:8088"]
}

설정 후:

sudo systemctl restart docker