Harbor 开源项目安装与使用指南

目录结构及介绍

Harbor 是一个开源的信任云原生注册表项目，用于存储、签名和扫描内容。它的目录结构反映了其功能组件和技术栈。

根目录

根目录包含了项目的主入口点：

• docker-compose.yml: 此文件用于通过Docker Compose部署整个Harbor环境。
• .env.example: 示例环境变量文件，可以用来创建自己的.env文件来控制构建过程中的各种参数。
• scripts: 包含了用于自动化部署或维护Harbor的脚本。

子目录

• config: 这个目录包含了所有可自定义的配置文件，包括数据库连接细节，认证方式等。
• static: 存放静态资源如图片、字体和其他不需编译的前端资源。
• templates: 包含HTML模板，这些模板被后端渲染以供前端使用。
• src: 源代码存放处，其中可能有多个子目录，分别对应不同的服务实现（例如API服务器，Web界面）。
• docs: 文档目录，提供了开发指南、API文档以及常见问题解答。

启动文件介绍

在 Harbor 中，主要依赖于docker-compose.yml文件进行服务的启动。该文件定义了一个由多个容器组成的应用，具体到 Harbor，则包含了数据库、核心应用以及其他辅助服务（如Redis）。通过执行以下命令，即可完成Harbor的初始化和运行：

docker-compose up -d

这将后台运行整个 Harbor 系统，包括必要的设置和启动过程。

此外，对于更高级的使用场景，比如持续集成/持续交付(CI/CD)，或者特定的企业级部署，Harbor也提供了一种基于Helm的部署方法。在这种情况下，可以通过下载对应的 Helm chart 并安装它来启动 Harbor 应用程序。

配置文件介绍

Harbor 的关键配置主要位于config目录下。以下是几个重要的配置文件及其说明：

config/core.env

这个文件控制着 Harbor 的核心服务行为，例如数据持久化策略、日志级别、网络接口配置等。

config/database.conf

此文件用于指定数据库的相关配置，包括数据库类型（默认是 PostgreSQL）、连接字符串、用户名密码等详细信息。

config/log_rotate.json

此JSON配置文件决定了日志文件的轮转规则，确保日志文件不会无限增长，从而影响系统性能。

Harbor 的配置灵活性较高，大部分配置都可以在部署后动态调整，无需重启服务。这种设计使得 Harbor 在不同环境下（从本地测试到生产环境）都能轻松适应并高效工作。

---

请注意，在实际操作中，应参照最新的官方文档和示例进行配置，以确保最佳实践和安全标准得到遵循。