Docker镜像仓库Harbor安装部署详细教程

引言

在容器化技术日益普及的今天，Docker已成为开发、测试和部署应用的标准工具。然而，随着Docker镜像数量的增加，如何高效、安全地管理这些镜像成为了一个亟待解决的问题。Harbor作为一款开源的企业级Docker镜像仓库，提供了强大的镜像管理、权限控制和安全审计功能，成为众多企业的首选。本文将详细介绍Harbor的安装部署过程，帮助开发者快速搭建起自己的Docker镜像仓库。

一、环境准备

1.1 硬件要求

Harbor的安装对硬件有一定的要求，主要包括：

• CPU：建议至少2核，对于生产环境，4核或更多更佳。
• 内存：建议至少4GB，对于生产环境，8GB或更多更佳。
• 磁盘空间：根据镜像存储需求确定，建议至少100GB。
• 网络：确保服务器有稳定的网络连接，以便与Docker客户端通信。

1.2 软件要求

• 操作系统：Harbor支持在多种Linux发行版上运行，如CentOS、Ubuntu等。本文以CentOS 7为例进行介绍。
• Docker：Harbor依赖于Docker运行，需提前安装Docker CE或EE版本。
• Docker Compose：Harbor使用Docker Compose进行部署，需提前安装。
• OpenSSL：用于生成自签名证书（如果使用HTTPS）。

1.3 域名与证书

为了安全起见，建议为Harbor配置HTTPS访问。这需要准备一个域名和对应的SSL证书。如果暂时没有正式的域名和证书，可以使用自签名证书进行测试。

二、安装步骤

2.1 下载Harbor安装包

访问Harbor的GitHub仓库（https://github.com/goharbor/harbor/releases），下载最新版本的安装包。例如，下载`harbor-offline-installer-v2.x.x.tgz`。

2.2 解压安装包

将下载的安装包解压到指定目录，如/opt：

tar -xzf harbor-offline-installer-v2.x.x.tgz -C /opt

2.3 配置Harbor

进入解压后的Harbor目录，编辑harbor.yml配置文件：

cd /opt/harbor
vi harbor.yml

在配置文件中，主要修改以下参数：

• hostname：设置为Harbor服务器的域名或IP地址。
• https：如果启用HTTPS，设置为true，并配置certificate和private_key路径。
• harbor_admin_password：设置Harbor管理员的初始密码。
• database、storage_driver等：根据实际需求进行配置。

2.4 运行安装脚本

配置完成后，运行Harbor的安装脚本：

./install.sh

安装过程中，脚本会自动下载所需的Docker镜像，并启动Harbor的各个服务。

2.5 验证安装

安装完成后，访问Harbor的Web界面（通常是https://<hostname>），使用配置的管理员用户名和密码登录，验证Harbor是否正常运行。

三、配置优化

3.1 配置HTTPS

如果之前未配置HTTPS，现在可以通过以下步骤进行配置：

1. 生成自签名证书（如果还没有正式证书）：

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /opt/harbor/ssl/harbor.key -out /opt/harbor/ssl/harbor.crt

1. 修改harbor.yml：启用HTTPS，并指定证书和私钥路径。
2. 重新运行安装脚本：

./prepare
./install.sh

3.2 配置用户与权限

Harbor支持多用户管理和细粒度的权限控制。可以通过Web界面或API创建用户、项目，并分配相应的权限。

3.3 配置镜像复制

Harbor支持镜像复制功能，可以将镜像从一个Harbor实例复制到另一个实例。这需要在System Management -> Replications中配置复制规则。

3.4 配置日志与监控

Harbor的日志默认存储在/var/log/harbor目录下。可以通过配置日志轮转、集中日志收集等方式优化日志管理。同时，Harbor支持与Prometheus、Grafana等监控工具集成，实现镜像仓库的监控。

四、常见问题与解决方案

4.1 安装失败

如果安装过程中出现错误，首先检查错误日志（通常在/var/log/harbor目录下），根据错误信息排查问题。常见的问题包括网络问题、权限问题、配置错误等。

4.2 访问404或502错误

这通常是由于配置错误或服务未正常启动导致的。检查Harbor的各个服务是否正常运行（docker-compose ps），并验证配置文件是否正确。

4.3 镜像上传/下载失败

这可能是由于网络问题、权限问题或存储问题导致的。检查Docker客户端与Harbor服务器的网络连接，验证用户权限，并检查存储驱动是否配置正确。

五、总结与展望

通过本文的介绍，相信开发者已经掌握了Harbor的安装部署过程。Harbor作为一款强大的Docker镜像仓库，不仅提供了高效的镜像管理功能，还支持多用户、细粒度的权限控制，以及镜像复制、日志监控等高级功能。未来，随着容器化技术的不断发展，Harbor将继续优化和完善其功能，为开发者提供更加便捷、安全的镜像管理服务。