Harbor 安装完整文档-DOKI SEKAI

Harbor 安装完整文档

本篇文档详细介绍了如何在 CentOS 8 系统上安装 Harbor，包括：

安装步骤
配置 docker-compose 为绝对路径
配置文件修改
启动、重载配置等常见操作

1. 前提条件

在安装 Harbor 前，确保你的系统满足以下要求：

Docker 已安装，版本要求为 1.13 或更高。
Docker Compose 已安装，版本要求为 1.18.0 或更高。
网络能访问 Docker Hub，若需要离线安装，则需要先下载 Harbor 离线安装包。

1.1 检查 Docker 和 Docker Compose

执行以下命令检查 Docker 和 Docker Compose 是否已安装：

docker --version
docker-compose --version

如果没有安装 Docker 或 Docker Compose，请根据官方文档进行安装。

2. 下载 Harbor 离线安装包

在 Harbor 官网或者 GitHub Releases 页面下载最新版本的 Harbor 离线安装包。以版本 2.5.1 为例，使用 wget 下载：

wget https://github.com/goharbor/harbor/releases/download/v2.5.1/harbor-offline-installer-v2.5.1.tgz

3. 解压安装包

下载完成后，解压 Harbor 离线安装包：

tar -zxvf harbor-offline-installer-v2.5.1.tgz
cd harbor

4. 修改 `docker-compose` 为绝对路径

Harbor 安装过程中会用到 docker-compose，确保其路径正确。为了避免安装脚本找不到 docker-compose，你需要设置为绝对路径。

4.1 查找 `docker-compose` 的安装路径

首先，检查 docker-compose 的安装路径：

which docker-compose

假设输出路径为 /usr/local/bin/docker-compose。

4.2 修改安装脚本

使用 vi 或其他文本编辑器打开 install.sh 文件：

vi install.sh

在脚本中找到 docker-compose 使用的地方，修改为绝对路径。例如：

DOCKER_COMPOSE=/usr/local/bin/docker-compose

4.3 保存并退出编辑

保存文件并退出 vi：

:wq

5. 配置 Harbor

Harbor 的配置文件是 harbor.yml。你需要根据自己的环境修改此文件。

5.1 修改 `harbor.yml` 配置文件

vi harbor.yml

重要配置项：

hostname: 设置 Harbor 的主机名或 IP 地址。
http/https: 配置 Harbor 的 HTTP/HTTPS 端口和证书路径。
storage: 配置 Harbor 镜像的存储路径。

修改 harbor.yml 中的相关配置，例如：

hostname: harbor.example.com

http:
  port: 80
  secret: some-secret-key

https:
  port: 443
  certificate: /data/cert/server.crt
  private_key: /data/cert/server.key

database:
  password: root123

storage:
  local:
    root: /data/harbor

保存并退出编辑。

6. 执行安装脚本

确保 docker-compose 的路径已经正确设置，并执行安装脚本：

sudo ./install.sh

6.1 执行脚本步骤

安装脚本将执行以下操作：

检查 Docker 和 Docker Compose 是否安装。
拉取 Harbor 镜像。
启动 Harbor 服务。

如果一切顺利，安装脚本会自动启动 Harbor 服务，配置文件和容器的初始化会顺利完成。

7. 启动 Harbor 服务

安装完成后，可以使用 Docker Compose 启动 Harbor 服务。

docker-compose up -d

该命令会在后台启动所有 Harbor 容器（如 harbor-core, harbor-db, nginx 等）。

8. 访问 Harbor Web 界面

安装完成后，可以通过浏览器访问 Harbor 的 Web 界面。默认的 URL 为：

http://<hostname>:80（HTTP）
https://<hostname>:443（HTTPS）

初始的登录用户名和密码是：

用户名：admin
密码：Harbor12345

如果你设置了 HTTPS，确保证书配置正确，访问时需要使用 https。

9. 重载 Harbor 配置

如果你修改了 Harbor 的配置文件（例如 harbor.yml），需要重新启动 Harbor 服务才能使配置生效。

9.1 停止 Harbor 服务

停止 Harbor 服务，清理容器和网络：

docker-compose down

9.2 重新启动 Harbor 服务

重新启动所有服务并应用新配置：

docker-compose up -d

9.3 检查容器状态

使用以下命令检查 Harbor 容器的运行状态：

docker ps

确认相关容器（如 harbor-core, harbor-db, nginx 等）都在运行。

10. 常见问题及解决方案

10.1 `docker-compose: command not found`

如果安装脚本或命令提示找不到 docker-compose，可能是由于路径问题。请确保 docker-compose 在全局可访问。可以通过以下命令检查：

which docker-compose

如果没有找到，可以手动安装并添加到 /usr/local/bin：

sudo curl -L https://github.com/docker/compose/releases/download/1.29.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

10.2 Harbor 无法启动或 Web 页面无法访问

检查 harbor.yml 配置文件中的 hostname 设置是否正确。
确保防火墙配置允许访问 Harbor 配置的端口（如 80 或 443）。
检查相关容器的日志：
```
docker logs harbor-core
```

10.3 `docker-compose` 文件路径配置

如果 install.sh 脚本仍然找不到 docker-compose，可以修改脚本，明确指定其路径。假设 docker-compose 安装在 /usr/local/bin/docker-compose，在脚本中添加以下行：

export PATH=$PATH:/usr/local/bin

11. 总结

准备工作：确保安装了 Docker 和 Docker Compose。
下载并解压 Harbor 安装包。
配置 harbor.yml：根据实际情况配置 Harbor 的主机名、端口、证书等。
执行安装脚本：设置 docker-compose 为绝对路径并运行 install.sh。
启动和访问 Harbor：通过 docker-compose up -d 启动服务并访问 Harbor Web 界面。
重载配置：修改配置后，通过 docker-compose down 和 docker-compose up -d 重启服务。

按照本步骤安装和配置 Harbor 后，你将能够在本地或企业环境中使用 Harbor 来管理 Docker 镜像。如果遇到问题，欢迎随时向我咨询。

目录CONTENT

Harbor 安装完整文档