开源制品管理工具Hadess，一键安装及快速入门教程

​Hadess是一款国产开源免费的制品管理工具，包含制品库管理、制品搜索、制品扫描等模块，支持常见的制品类型如Maven、npm、Go、Docker、Helm、Generic、pypi、Composer、Nuget等，产品功能完善、界面简洁、开源免费，本文将介绍如何快速安装配置Hadess，及简明的入门指南

1、安装

支持 Linux、docker、Windows、Mac 等操作系统

1.1 Linux安装

本文以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安装

• 下载

访问官网进行下载，可通过安装下载也可以在网页命令在线安装

 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图标即可启动

1.4 Mac安装

• 下载：访问官网进行下载
• 安装：双击可执行文件 -> 将tiklab-hadess-1.2.2.app拉入应用程序中即可
• 启动：安装完成后点击启动太Hadess图标即可启动

2、登入

• 启动完成后，浏览中访问 http://ip:9700, 就可以打开Hadess界面, 默认登录帐号密码为admin/123456
• 同时支持LDAP、企业微信、钉钉登录方式，具体配置见：访问官网文档可查看详细配置

登录页

Hadess首页

支持登入方式：

3、配置

进入项目config文件夹下，编辑application.yaml 即可自定义配置

3.1 自定义端口

修改文件中的server.port的值为自己想要配置的端口，重新启动即可

3.2 自定义数据库配置

• 使用的数据库为postgresql，Hadess同时支持使用外部数据库以及内嵌数据库。默认使用内嵌数据库
• 外部数据库：用户自己定义链接数据库的地址，用户名，密码等。
• 内嵌数据库：使用系统内置的数据库

（1）使用外部数据库

注意：使用外部数据库的时候，需要将内嵌数据库postgresql.embbed.enable后面的数据修改为false

属性说明：

（2）使用内嵌数据库

默认使用的是内嵌数据库

属性说明：

3.3 自定义数据存储目录

DATA_HOME为数据文件存放地址。

# 数据存放地址

属性说明：

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。

• 删除制品库

进入制品库，点击仓库设置找到仓库删除点击删除即可。