当前位置：首页 > 文章列表 > 文章 > linux > Harbor部署ECS私有镜像仓库教程

Harbor部署ECS私有镜像仓库教程

2025-08-27 20:16:02 0浏览收藏

本文详细介绍了如何使用 Harbor 搭建私有 Docker 镜像仓库并部署到 ECS，实现安全便捷的镜像管理。首先，阐述了 Harbor 的安装配置过程，包括服务器准备、Docker 环境搭建以及关键配置项的修改，如 hostname、管理员密码等。接着，讲解了如何创建 Harbor 项目，配置 Docker 客户端，以及构建和推送镜像到 Harbor 仓库。然后，重点介绍了 ECS 部署配置，包括安全组设置、Docker 安装以及镜像拉取策略。此外，还深入探讨了 Harbor 的权限管理机制，包括基于项目的权限分配、用户角色设置以及 LDAP/AD 集成。最后，详细阐述了 Harbor 的备份与恢复策略，以及如何通过 Prometheus、Grafana 和 ELK Stack 等工具监控 Harbor 的运行状态，确保镜像仓库的安全稳定运行。

首先，Harbor通过项目进行权限管理，1. 可为不同用户分配项目级别的只读、读写或管理员权限；2. 支持内置角色如项目管理员、开发人员和访客；3. 可配置访问控制规则，限制用户或用户组对镜像的访问；4. 支持LDAP/AD集成以统一认证。其次，备份与恢复需1. 定期备份数据库（使用pg_dump）、镜像文件（复制data_volume目录）和harbor.yml配置文件；2. 恢复时先恢复数据库，再复制镜像文件并重新配置Harbor。最后，监控方式包括1. 与Prometheus集成以暴露metrics；2. 使用Grafana可视化关键指标如存储使用率和请求量；3. 通过ELK Stack分析日志；4. 利用Harbor Web界面查看基本运行状态，确保镜像仓库安全稳定运行。

如何用 Harbor 构建私有 Docker 镜像仓库并部署到 ECS

用 Harbor 构建私有 Docker 镜像仓库，然后部署到 ECS，简单来说，就是为了更安全、更方便地管理和使用你的 Docker 镜像。Harbor 帮你集中管理，ECS 帮你运行起来。

解决方案：

Harbor 安装与配置：
首先，你需要一台服务器来安装 Harbor。这台服务器最好有足够的磁盘空间，因为你要存放 Docker 镜像。 Harbor 本身可以运行在 Docker 上，所以你需要先安装 Docker 和 Docker Compose。
下载 Harbor 的离线安装包（通常是 harbor-offline-installer-*.tgz），解压后，你会找到 harbor.yml 配置文件。这个文件是 Harbor 的核心。你需要修改它，设置 Harbor 的 hostname、数据库密码、管理员密码等等。
```
tar xvf harbor-offline-installer-*.tgz
cd harbor
vi harbor.yml
```
关键配置项：
- hostname: Harbor 的访问地址，比如 harbor.example.com。
- harbor_admin_password: Harbor 管理员密码。
- database.password: 数据库密码。
- data_volume: Harbor 存储数据的目录。
修改完成后，运行安装脚本：
```
./install.sh
```
安装完成后，通过浏览器访问你设置的 hostname，使用管理员账号登录 Harbor。
创建 Harbor 项目：
登录 Harbor 后，创建一个新的项目，比如 my-project。这个项目用来存放你的 Docker 镜像。
Docker 客户端配置：
在你的开发机或者构建服务器上，需要配置 Docker 客户端，使其能够登录到 Harbor。
首先，你需要安装 Harbor 的证书，否则 Docker 客户端会报错。你可以从 Harbor 的 Web 界面下载证书。
然后，使用 docker login 命令登录 Harbor：
```
docker login harbor.example.com
```
输入你的 Harbor 用户名和密码。
构建和推送镜像：
构建你的 Docker 镜像，并给镜像打上 tag，指定 Harbor 的地址和项目名称。
```
docker build -t my-image .
docker tag my-image harbor.example.com/my-project/my-image:latest
docker push harbor.example.com/my-project/my-image:latest
```
推送完成后，你可以在 Harbor 的 Web 界面看到你的镜像。
ECS 部署配置：
现在，你需要将你的镜像部署到 ECS 上。
首先，确保你的 ECS 实例可以访问 Harbor。这可能需要配置安全组规则，允许 ECS 实例访问 Harbor 服务器的 443 端口（HTTPS）。
然后，在 ECS 实例上，你需要安装 Docker。
最后，你可以使用 docker run 命令来运行你的镜像：
```
docker run -d -p 8080:8080 harbor.example.com/my-project/my-image:latest
```
这个命令会启动你的镜像，并将容器的 8080 端口映射到 ECS 实例的 8080 端口。
你也可以使用 Docker Compose 来管理你的容器。创建一个 docker-compose.yml 文件：
```
version: "3.9"
services:
  my-app:
    image: harbor.example.com/my-project/my-image:latest
    ports:
      - "8080:8080"
```
然后，运行 docker-compose up -d 命令来启动你的容器。
镜像拉取策略：
在 ECS 上部署时，需要注意镜像拉取策略。如果 ECS 实例无法访问外网，你需要配置 ECS 实例的 Docker 客户端，使其能够从 Harbor 拉取镜像。这通常需要配置 Docker 的 daemon.json 文件，添加 Harbor 的证书。

Harbor 镜像仓库如何进行权限管理？

Harbor 的权限管理基于项目进行。你可以为不同的用户分配不同的项目权限，比如只读、读写、管理员等等。

用户角色： Harbor 内置了多种用户角色，比如项目管理员、开发人员、访客等等。不同的角色拥有不同的权限。
访问控制： 你可以为每个项目配置访问控制规则，允许或拒绝特定用户或用户组访问项目中的镜像。
LDAP/AD 集成： Harbor 支持与 LDAP/AD 集成，方便你使用现有的用户认证系统。

Harbor 镜像仓库如何进行备份与恢复？

Harbor 的备份与恢复是一个比较重要的环节，确保数据安全。

数据备份： Harbor 的数据包括数据库、镜像文件、配置文件等等。你需要定期备份这些数据。数据库可以使用 pg_dump 命令进行备份。镜像文件存储在 data_volume 目录下，你可以直接复制这个目录进行备份。
数据恢复： 恢复数据时，你需要先恢复数据库，然后将镜像文件复制回 data_volume 目录。
Harbor 自身备份: 建议备份 Harbor 的 harbor.yml 配置文件，以便快速恢复 Harbor 环境。

如何监控 Harbor 镜像仓库的运行状态？

监控 Harbor 的运行状态可以帮助你及时发现问题。