开源制品管理工具Hadess，一键安装及快速入门教程
Hadess是一款国产开源免费的制品管理工具，包含制品库管理、制品搜索、制品扫描等模块，支持常见的制品类型如Maven、npm、Go、Docker、Helm、Generic、pypi、Composer、Nuget等，产品功能完善、界面简洁、开源免费，本文将介绍如何快速安装配置Hadess，及简明的入门指南
1、安装
支持 Linux、docker、Windows、Mac 等操作系统
1.1 Linux安装
本文以ubuntu安装
- 下载
点击ubuntu下载，可通过安装下载也可在网页命令在线安装
wget -O tiklab-hadess-1.2.2.deb https://install.tiklab.net/app/install/hadess/V1.2.2/tiklab-hadess-1.2.2.deb
- 安装
上传之后执行以下命令安装，默认安装在opt 目录下
dpkg -i tiklab-hadess-1.2.2.deb #ubantu安装命令
- 启动
安装之后会在opt目录下出现一个名字为 tiklab-hadess的文件夹，在tiklab-hadess下的bin文件夹下，执行./hadess start命令，启动项目
./hadess start
1.2 Docker安装
- 下载
点击Docker下载，可通过安装下载也可以在网页命令在线安装
wget -O tiklab-hadess-1.2.2.tar.gz https://install.tiklab.net/app/install/hadess/V1.2.2/tiklab-hadess-1.2.2.tar.gz
- 安装
安装包名字为tiklab-hadess-1.2.2.tar.gz，下载完成执行以下命令加载镜像
docker load -i tiklab-hadess-1.2.2.tar.gz
- 启动
加载完成后，执行以下命令镜像启动
docker run -itd -p 9700:9700 tiklab-hadess:1.2.2
1.3 Windows 安装
- 下载：Hadess-下载
- 安装：双击执行文件 -> 选择安装位置 -> 点击安装
- 启动：安装完成后点击左面Hadess图标即可启动
1.4 Mac安装
- 下载：Hadess-下载
- 安装：双击可执行文件 -> 将tiklab-hadess-1.2.2.app拉入应用程序中即可
- 启动：安装完成后点击启动太Hadess图标即可启动
2、登入
- 启动完成后，浏览中访问 http://ip:9700, 就可以打开Hadess界面, 默认登录帐号密码为admin/123456
- 同时支持LDAP、企业微信、钉钉登录方式，具体配置见：配置详细
登录页
Hadess首页
支持登入方式：
| 支持类型 | 登入方式 |
| 账号登入 | 默认登入方式 |
| 企业微信登录 | 企业微信用户扫描登录 |
| 钉钉登录 | 钉钉用户扫描登录 |
| Ldap登录 | Ldap用户登录 |
3、配置
进入项目config文件夹下，编辑application.yaml 即可自定义配置
3.1 自定义端口
修改文件中的server.port的值为自己想要配置的端口，重新启动即可
3.2 自定义数据库配置
- 使用的数据库为postgresql，Hadess同时支持使用外部数据库以及内嵌数据库。默认使用内嵌数据库
- 外部数据库：用户自己定义链接数据库的地址，用户名，密码等。
- 内嵌数据库：使用系统内置的数据库
（1）使用外部数据库
注意：使用外部数据库的时候，需要将内嵌数据库postgresql.embbed.enable后面的数据修改为false
属性说明：
| 字段 | 说明 |
| jdbc.url | 数据库地址，修改为自己的外部数据库地址 |
| jdbc.username | 数据库用户名，修改外部数据库用户名 |
| jdbc.password | 数据库密码，修改外部数据库密码 |
（2）使用内嵌数据库
默认使用的是内嵌数据库
属性说明：
| 字段 | 描述 |
| postgresql.embbed.enable | 是否使用内嵌数据库，true(使用)、false(不使用)。如果配置false,需要把jdbc下的数据库连接信息更改为自己的数据库地址、用户、密码 |
| postgresql.embbed.database | 内嵌数据库名字。如果需要修改内嵌数据库名字，同时也要修改jdbc.url后面的数据库名字 |
| postgresql.db.port | 内嵌数据库的端口。如果需要更改，同时也要修改jdbc.url后面的数据库端口 |
| postgresql.db.username | 内嵌数据库用户名。如果需要更改，同时也要修改jdbc.username值 |
| postgresql.db.password | 内嵌数据库密码。如果需要更改，同时也要修改jdbc.password值 |
| postgresql.db.address | 内嵌数据库存储地址。注意：如果更改该目录，该路径目录必须为空目录，否则会导致数据库无法启动 |
3.3 自定义数据存储目录
DATA_HOME为数据文件存放地址。
# 数据存放地址
属性说明：
| 属性 | 值 |
| dcs.server.port | dcs启动端口，必须与dcs.client.url 的端口号保持一致 |
4、快速入门
4.1 制品搜索
- 查询制品
支持制品类型如：Generic、Npm、Docker、Maven、Helm、Go、pypi、composer、nuget、Conan、Rpm。
- 制品信息
- 制品类型
4.2 制品库管理
- 创建本地库：点击新建制品库选择新建本地库添加信息，点击确认
- 创建远程库：点击右上角新建远程库，输入对应内容即可
- 创建组合库：点击右上角新建组合库输入对应内容点击确定即可
- 修改本地库：修改仓库名字和描述
- 修改远程库：修改远程库代理地址至少要有一个，代理地址只有一个的时候不能被删除
- 修改组合库
1.修改仓库名字、关联的制品库
2.左边的是未关联的制品库，右边是已关联的和待确认关联的制品库。要将未关联的制品库关联，先鼠标点击需要关联的制品库，再点击中间向右图标，将该制品库放入右边待确认
3.移除关联制品库，鼠标点击需要移除的制品库，再点击向左图标，将该制品库放入左边。最后点击确定修改
- 查询制品库：通过条件查询制品库（所有库、本地库、远程库、组合库）通过制品库名称关键字查询制品库
4.2.1 本地库制品上传
即可在maven制品库库制品界面点击右上角上传制品，只有本地local库可以上传界面上传适用于第三方只有 jar 包或者压缩文件，不适用于自己有pom.xml文件。
4.2.2 制品推送与拉取
- 推送
1. 本地已经配置，跳过凭证配置
2. 进入制品库界面点击右上角操作指引选择maven进入操作指引界面,替换对应的文本。将其添加至 settings.xml 文件中。
实例：
1. 点击推送table替换文本后，复制下列配置到项目的 pom.xml 文件当中
2. 执行 mvn deploy 命令
- 拉取
1. 操作指引界面拉取，替换文本，复制配置到 settings.xml 当中
2. 在项目pom.xml中配置依赖包（dependencies 标签）
3.执行mvn install 拉取制品
其他制品类型拉取或推送同理，支持类型：Generic、Npm、Docker、Maven、Helm、Go、pypi、composer、nuget、Conan、rpm。
- 删除制品库
进入制品库，点击仓库设置找到仓库删除点击删除即可。
