一、实验背景

Harbor的核心功能也采用RESTful API来实现，在开发过程中采用Swagger编写了一套可视化API规范，并作为项目的一部分提供给用户使用。

【Harbor】CentOS7.x上用harbor安装docker镜像仓库

https://www.jianshu.com/p/1e40b58089ac

【Harbor】Harbor镜像仓库的安装与历史版本镜像的清理

https://www.jianshu.com/p/3269997d8657

二、下载Harbor swagger 文件

我们下载 prepare-swagger.sh 和 swagger.yaml 到 Harbor 安装目录下，我本地虚拟机安装目录为：/opt/harbor

https://github.com/goharbor/harbor

# git clone  https://github.com/goharbor/harbor.git  

# git checkout 1.5.2

# vim  /opt/harbor/prepare-swagger.sh

######################################################

# sed   -i.bak  's/A/B/g'     file.txt

将修改内容保存到file.txt，同时会以file.txt.bak文件备份原来未修改文件内容，以确保原始文件内容安全性，防止错误操作而无法恢复原来内容。注意，-i.bak 之间没有空格！

######################################################

# cd  /opt/harbor  

#  sh prepare-swagger.sh 

#  mv   ../src   ./

# chown  -R  10000:10000  src  

# vim /opt/harbor/docker-compose.yml

####################################################################

- ./src/ui/static/vendors/swagger-ui-2.1.4/dist:/harbor/static/vendors/swagger

- ./src/ui/static/resources/yaml/swagger.yaml:/harbor/static/resources/yaml/swagger.yaml

#####################################################################

三、重启Harbor服务

#  docker-compose  -f  /opt/harbor/docker-compose.yml  down

# docker-compose  -f  /opt/harbor/docker-compose.yml  up  -d

四、访问 Harbor Swagger 

浏览器访问：https://xx.xx.xx.xx:443/static/vendors/swagger/index.html

五、参考

用Swagger调用Harbor Registry的REST API

https://my.oschina.net/vmwareharbor/blog/663675

goharbor/harbor

https://github.com/goharbor/harbor/tree/v1.5.2/docs

View and test Harbor REST API via Swagger

https://github.com/goharbor/harbor/blob/v1.5.2/docs/configure_swagger.md

HARBOR配置SWAGGER远程REST API

https://www.freesion.com/article/8770158186

Docker镜像仓库Harbor之Swagger REST API整合配置

https://blog.csdn.net/aixiaoyang168/article/details/73607305