KubeSphere Installer 集成了 Harbor 的 Helm Chart (版本为 harbor-18.11.1),内置的 Harbor 作为可选安装项,用户可以根据团队项目的需求来配置安装,方便用户对项目的镜像管理,仅需安装前在配置文件 conf/vars.yml 中简单配置即可,参考以下步骤安装和访问 Harbor。

修改安装配置文件

1、安装 KubeSphere 前,在 Installer 中的 conf/vars.yml 文件中,参考如下配置修改。

  1. # harbor deployment
  2. harbor_enable: true
  3. harbor_domain: harbor.devops.kubesphere.local

2、修改后保存,然后执行安装脚本,即可通过 Helm Chart 的方式来安装 Harbor。

访问 Harbor

在 KubeSphere 中添加 Harbor 作为镜像仓库,请参考如下步骤,先配置 Docker 访问,然后在 KubeSphere 添加 Harbor 的用户认证信息。

配置 Docker 访问

第一步:修改 Docker 配置

修改集群中 所有节点 的 Docker 配置,需要在 /etc/systemd/system/docker.service.d/docker-options.conf 文件添加字段 --insecure-registry=harbor.devops.kubesphere.local:30280,如下所示:

配置文件修改示例

  1. [Service]
  2. Environment="DOCKER_OPTS= --registry-mirror=https://registry.docker-cn.com --data-root=/var/lib/docker --log-opt max-size=10m --log-opt max-file=3 --iptables=false --insecure-registry=harbor.devops.kubesphere.local:30280"

注意:Environment 配置应写在一行,不能手动换行。

第二步:修改 hosts 配置

在本地的 /etc/hosts 文件中,需要参考如下添加一条记录:

  1. 192.168.0.24 harbor.devops.kubesphere.local

说明:192.168.0.24 是当前主机的内网 IP,请根据实际情况填写。若需要将 Harbor 服务暴露给集群外部用户使用,则需要在外网配置 DNS 记录(DNS 服务器处或者用户的本地 hosts 文件内),把域名 harbor.devops.kubesphere.local 对应到相应的外网 IP,并将 Harbor 端口 30280 进行端口转发和开放防火墙,确保外部流量可以通过该端口。

第三步:重启 Docker 服务

修改后,需要重启 所有节点 的 Docker 服务使配置生效,⽐如在 Linux 系统中需执行以下命令:

  1. $ sudo systemctl daemon-reload
  1. $ sudo systemctl restart docker

第四步:登录 Harbor

执行以下命令登录 Harbor 镜像仓库。关于如何制作镜像、打包上传镜像以及 Dockerfile 的使用,请参考 Docker 官方文档

  1. $ docker login -u admin -p Harbor12345 http://harbor.devops.kubesphere.local:30280
  2. WARNING! Using --password via the CLI is insecure. Use --password-stdin.
  3. WARNING! Your password will be stored unencrypted in /root/.docker/config.json.
  4. Configure a credential helper to remove this warning. See
  5. https://docs.docker.com/engine/reference/commandline/login/#credentials-store
  6. Login Succeeded

KubeSphere 添加 Harbor

当后台配置 Docker 访问 Harbor 成功后,即可登录 KubeSphere,在已创建的企业空间的项目下,左侧菜单栏选择 配置中心 → 密钥,点击 创建

第一步:填写基本信息

填写密钥的基本信息,完成后点击 下一步

  • 名称:起一个简洁明了的名称,填写 harbor
  • 别名:支持中文,帮助您更好的区分资源,比如 内置 Harbor 镜像仓库
  • 描述信息:简单介绍该密钥的功能

基本信息

第二步:填写 Harbor 仓库信息

2.1. 在类型中选择镜像仓库密钥,参考如下提示填写 Harbor 仓库的登录信息。

  • 仓库地址:填写内置的 Harbor 镜像仓库域名和节点端口 http://harbor.devops.kubesphere.local:30280
  • 用户名:admin
  • 密码:Harbor12345
  • 邮箱:填写个人邮箱

安装内置 Harbor - 图2

2.2. 点击 创建,如果 Harbor 安装配置都正确,并且验证信息都填写无误,即可添加成功。Harbor 镜像仓库添加完成后,可以上传镜像和拉取镜像。

安装内置 Harbor - 图3

浏览器访问

KubeSphere 和 Harbor 都安装成功后,若需要在集群外部访问 Harbor,请在本地的 /etc/hosts 文件中参考如下示例添加一行记录,然后才可以在浏览器访问 Harbor 镜像仓库。

  1. 139.198.10.10 harbor.devops.kubesphere.local

注意:139.198.10.10 是 KubeSphere 集群的公网 IP,请根据实际情况填写。在外网访问 Harbor,需要绑定公网 IP 并配置端口转发,若公网 IP 有防火墙,请在防火墙添加规则放行对应的端口 30280,保证外网流量可以通过该端口,外部才能够访问。

Harbor 服务对外暴露的节点端口 (NodePort) 为 30280,内置的 Harbor 镜像仓库目前仅支持 http 协议,在浏览器中可以通过 {$域名}:{$NodePort}http://harbor.devops.kubesphere.local:30280 访问 Harbor 登录页面。默认的管理员用户名和密码为 admin / Harbor12345,其它用户与 KubeSphere 的用户账户体系一致。关于 Harbor 的使用详见 Harbor 官方文档

浏览器访问

使用 Harbor 镜像仓库

若需要在 KubeSphere 中使用 Harbor 镜像仓库中的镜像,需要先将相关的镜像构建后上传至 Harbor。关于 Harbor 的使用详见 Harbor 官方文档

以创建 Deployment 为例展示如何使用镜像仓库来拉取仓库中的镜像。比如 Harbor 镜像仓库中已有 mysql:5.6 的 docker 镜像,在容器组模板中需要先选择镜像仓库,然后将镜像填写为 http://harbor.devops.kubesphere.local:30280/mysql:5.6,对应的格式为 镜像仓库地址 / 镜像名称:tag,填写后创建完成即可使用该 Harbor 镜像仓库中的镜像。

使用 Harbor 镜像仓库