首页 / 平台管理 / 工具链管理 / 工具部署与升级 / 部署 Harbor

部署 Harbor

Harbor 是一个开源的容器镜像仓库管理平台,可以帮助您安全地存储、管理和分发镜像。

注意事项

服务访问地址默认为 IPV4 地址,若需使用 IPV6 并且集群网卡支持 IPV6,请将 IPV4 地址修改为 IPV6 地址。

前提条件

存储

请确保至少满足以下一条前提。每条前提都对应不同的 存储方式

提示:删除<创建实例>功能创建的工具后,工具绑定的 PVC 仍会被保留。

网络

高可用

如需部署高可用 Harbor,请确保目标集群中满足以下要求:

私有部署

  1. 在左侧导航栏中,单击 工具链管理 > 实例管理

  2. 单击 创建实例

  3. 创建实例 页面,选择 Harbor

  4. 部署位置 区域,选择希望将工具部署到的 集群命名空间

  5. 架构区域,选择是否使用高可用架构。

    注意:部署完毕后将无法修改架构类型。

  6. 资源 区域,选择一种 CPU 和内存分配方式,并完成配置。

    分配方式 说明
    整体分配 为工具分配总资源,用于保障工具整体可用。如果您对单个组件的特性无特殊要求,全局分配方式会更为便捷。
    单个组件分配 为工具下各组件分配资源,用于保障与特定组件相关的业务表现。例如,可为 PostgreSQL 数据库设置专属资源要求,避免出现性能瓶颈。
  7. 存储 区域,选择一类存储方式,并完成配置。

    注意:实例创建后,存储配置不支持修改。

    存储方式 说明
    动态生成 PVC 前提:需提前准备存储类。
    分别设置 Harbor 各组件所需存储容量后,平台将动态为每个 Harbor 组件生成一个 PVC,并根据 PVC 请求的存储类为各组件动态创建持久卷。如需进行存储扩容,请切换至 Comtaniner Platform 中扩容 PVC。
    可用 PVC 前提:需提前准备 PVC。
    为每个 Harbor 组件指定一个可用 PVC 后,平台将根据 PVC 请求的存储类为各组件动态创建持久卷,以满足各组件对存储的不同诉求(扩容、快照等)。支持在 平台管理 中直接进行 存储扩容
    节点存储 通过 hostpath 存储方案请求集群节点上的存储资源。使用此方式无需准备存储类。
    注意
    • 此方式不适用于高可用架构。
    • 填写存储路径时,需确保该路径为绝对路径,且不曾被使用,以免挂载失败。
    • 在公有云集群中部署工具时,为避免集群自动伸缩删除节点后导致数据丢失,不支持选择此存储方式。
  8. 网络 区域,配置网络要求。

    注意

    • 部署完成后,请谨慎更新服务访问地址。若更新,需要配合外部设置才能正常访问,如配置 DNS 解析等。且本次更新只适用于当前网络设置状态,当网络设置再次发生变更时服务访问地址将会被自动替换为限制值。

    • 若待部署工具的集群中存在双网卡节点,需检查服务访问地址中 默认使用的负载均衡器 IP 地址或节点 IP 地址是否可提供集群外访问 ,否则将导致部署后无法正常访问工具,并出现“check xx alive failed”错误提示。

    • Ingress 方式

      参数 说明
      域名 选择平台中已存在的 域名 。请确保所选域名已分配至待使用本工具的项目。
      协议 支持选择 HTTP 和 HTTPS 协议。
      提示:若选择 HTTP 协议,在<创建实例>创建的 Harbor 会出现无法 push 镜像的情况,这是由于 Docker 默认不允许使用无权限验证的 Docker Registry。此时需要您 Harbor 镜像仓库的每一个集群资源节点中编辑 /etc/docker/daemon.json 文件,将 Harbor 访问地址添加至 insecure-registries 字段中,例如:"insecure-registries" : ["192.168.0.100:5000"]。完成配置后,重启生效。
      证书 若使用 HTTPS 协议,还须配置与域名匹配的 证书
      服务访问地址 将自动生成,规则为 http://{Ingress 名称}https://{Ingress 名称}
    • Nodeport 方式:根据规划设置 HTTP 端口、HTTPS 端口,和 Notary 端口。

  9. 账号 区域,配置账号相关信息。

    参数 说明
    用户名 为默认值 admin 且不可修改。
    凭据 为确保环境安全,请在凭据中设置密码:单击 创建,填写一个便于识别的名称后,在 配置HARBOR_ADMIN_PASSWORD 后填入密码。

    说明:后续如需修改密码,请请 更新凭据数据信息
    SSO 登录 单点登录。若启用,可使用平台账号登录 Harbor,该授权账号同时支持拉取镜像。

    说明:启用 SSO 登录后有如下限制。

    • 创建实例 Harbor 后,不支持更新 SSO 按钮开关状态。

    • 使用 Harbor 本地用户登录时,仅支持使用默认的管理员账号。

    • 在平台项目下绑定 Harbor 工具时,无法使用 SSO 授权账号绑定。

    • 下图 用户设置 中的 用户名CLI 密码 也可用于使用 Helm 或 Docker CLI 方式访问 Harbor。

  10. 集成 区域,指定一个 集成名称,这个名称帮助项目成员在 DevOps 中识别并选择此工具。

  11. 配置完成后,单击 部署并集成

    创建的工具实例会自动集成到 DevOps 的工具链中。

公有云部署

推荐开虚拟机部署公有云集群后部署 DevOps 工具,使用与私有集群一致的存储和网络方案,通过这种方式支持部署的工具和能力与私有集群部署工具能力对齐。

结果校验

等待部署状态为 已部署 后,单击工具访问地址,若能成功登录工具,说明操作成功。

后续操作