7error/harbor

Harbor 一站式集成镜像

镜像概述和主要用途

该镜像是一个集成所有必要组件的goharbor一站式解决方案，旨在解决无需docker-compose即可部署Harbor容器镜像仓库的需求。通过单个容器即可运行完整的Harbor服务，包含PostgreSQL、Redis、Registry、Nginx等所有依赖组件，大幅简化部署流程，适合快速搭建私有镜像仓库。

核心功能和特性

• 一站式集成：包含Harbor运行所需全部组件（PostgreSQL、Redis、Registry、Nginx、Clair等）
• 无需docker-compose：无需复杂的多容器编排，单个容器即可部署完整Harbor服务
• 简化部署：通过简单命令完成证书生成和服务启动
• 数据持久化：支持通过卷挂载实现数据持久化，包括证书、镜像存储、数据库数据等
• 完整功能：保留Harbor全部核心功能，包括镜像管理、用户认证、Helm Chart仓库、安全扫描等

使用场景和适用范围

• 快速搭建私有容器镜像仓库的场景
• 不想使用docker-compose进行多容器管理的环境
• 开发测试环境中需要快速部署Harbor服务
• 对部署复杂度有要求，需要简化维护的场景

使用方法和配置说明

部署步骤

Step 1：创建目录并生成证书

首先创建必要的目录结构，并生成Harbor所需证书：

bash
mkdir -p $(pwd)/harbor/{cert,registry,postgresql,redis,chart_storage,job_logs}

# 设置PostgreSQL目录权限
chown -R 999:999 $(pwd)/harbor/postgresql

# 生成证书（替换SNI中的域名和IP为实际值）
docker run \
--entrypoint "" \
--user `id -u`:`id -g` \
--volume $(pwd)/harbor/cert:/tmp/cert \
--interactive \
--tty \
--rm \
7error/harbor:1.10.4-8 \
bash -c "export SNI='192.168.9.119;your-harbor-domain;reg.domain.com;192.168.100.111' && cd /tmp/cert && /init-cert.sh"

注意：SNI环境变量需替换为实际使用的IP和域名，多个值用分号分隔

Step 2：启动Harbor容器

使用以下命令启动Harbor服务：

bash
docker run -d \
--name harbor \
--restart=always \
--env EXT_ENDPOINT=https://reg.domain.com:8443 \  # 外部访问端点
--env TZ=Asia/Shanghai \  # 设置时区
-p 8443:8443 \  # Harbor UI和API端口
-p 6080:6080 \  # 门户端口
-p 4443:4443 \  # Notary服务端口
-v $(pwd)/harbor:/data \  # 数据目录
-v $(pwd)/harbor/job_logs:/var/log/jobs \  # 任务日志
-v $(pwd)/harbor/postgresql:/var/lib/postgresql/data \  # PostgreSQL数据
-v $(pwd)/harbor/redis:/var/lib/redis \  # Redis数据
-v $(pwd)/harbor/registry:/storage \  # 镜像存储
-v $(pwd)/harbor/chart_storage:/chart_storage \  # Helm Chart存储
-v $(pwd)/harbor/cert/ca.pem:/etc/core/ca/ca.crt \  # CA证书
-v $(pwd)/harbor/cert/harbor.pem:/etc/cert/server.crt \  # 服务器证书
-v $(pwd)/harbor/cert/harbor-key.pem:/etc/cert/server.key \  # 服务器密钥
-v $(pwd)/harbor/cert/notary-signer-ca.crt:/etc/notary/notary-signer-ca.crt \  # Notary签名CA证书
-v $(pwd)/harbor/cert/notary-signer.key:/etc/notary/notary-signer.key \  # Notary签名密钥
-v $(pwd)/harbor/cert/notary-signer.crt:/etc/notary/notary-signer.crt \  # Notary签名证书
-v $(pwd)/harbor/cert/private_key.pem:/etc/core/private_key.pem \  # 核心私钥
-v $(pwd)/harbor/cert/root.crt:/etc/registry/root.crt \  # 注册表根证书
7error/harbor:1.10.4-8

访问和使用

Web界面访问

• UI地址：[***]
• 默认用户名：admin
• 默认密码：Harbor***

命令行工具（CLI）使用

Docker客户端配置

bash
# 将CA证书添加到系统信任
cp $(pwd)/harbor/cert/ca.pem /etc/pki/ca-trust/source/anchors/ca.cert
update-ca-trust force-enable
update-ca-trust
systemctl restart docker

# 登录Harbor
docker login -u admin --password Harbor12345 reg.domain.com:8443

# 推送和拉取镜像示例
docker pull debian:10
docker tag debian:10 reg.domain.com:8443/library/debian:10
docker push reg.domain.com:8443/library/debian:10
docker pull reg.domain.com:8443/library/debian:10

Helm客户端配置

bash
helm repo update
# 添加Harbor Chart仓库
helm repo add --ca-file $(pwd)/harbor/cert/ca.pem myrepo https://reg.domain.com:8443/chartrepo/library
helm repo update
helm search myrepo  # 搜索仓库中的Chart

容器内服务管理

查看服务状态

bash
docker exec -it harbor bash -c "s6-service all status"

管理单个服务（以Nginx为例）

bash
docker exec -it harbor bash
s6-service nginx stop    # 停止Nginx服务
s6-service nginx reload  # 重新加载Nginx配置
s6-service nginx restart # 重启Nginx服务

查看容器内端口监听情况

bash
docker exec -it harbor bash -c "ss -tunlp"

查看进程树

bash
docker exec -it harbor bash -c "pstree"
# 查看详细进程树
docker exec -it harbor bash -c "pstree -a"