在 KubeSphere 中部署 Harbor

r囧r小猫 2023-10-03 10:50 35阅读 0赞

[Harbor][] 是一个开源仓库，通过各种策略和基于角色的访问控制来保护制品，确保镜像经过扫描且没有漏洞，并对镜像签名使其受信。

本教程演示如何从 KubeSphere 应用商店部署 [Harbor][]。

### 准备工作 ###

*  请确保[已启用 OpenPitrix 系统][OpenPitrix]。
 *  您需要创建一个企业空间、一个项目和一个用户帐户 (`project-regular`) 供本教程操作使用。该帐户需要是平台普通用户，并邀请至项目中赋予 `operator` 角色作为项目操作员。本教程中，请以 `project-regular` 身份登录控制台，在企业空间 `demo-workspace` 中的 `demo-project` 项目中进行操作。有关更多信息，请参见[创建企业空间、项目、帐户和角色][Link 1]。

### 动手实验 ###

#### 步骤 1：从应用商店中部署 Harbor ####

1.  在 `demo-project` 项目的**概览**页面，点击左上角的**应用商店**。
    
    ![应用商店][bdeaf25bc8711e917b32e23c7713fa31.png]
2.  找到 Harbor，点击**应用信息**页面上的**部署**。
    
    ![寻找 Harbor][Harbor 1]
    
    ![点击部署][52dddba4a8c8e00f18f54ae5016ec950.png]
3.  设置名称并选择应用版本。请确保将 Harbor 部署在 `demo-project` 中，点击**下一步**。
    
    ![部署 Harbor][Harbor 2]
4.  在**应用配置**页面，编辑 Harbor 的配置文件，请注意以下字段。
    
    `type`：访问 Harbor 服务的方式。本示例使用 `nodePort`。
    
    `tls`：指定是否启用 HTTPS。多数情况下设置为 `false`。
    
    `externalURL`：暴露给租户的 URL。
    
    ![配置 Harbor][Harbor 3]
    
    备注
    
     *  请指定 `externalURL`，如果您访问 Harbor 有问题，该字段会对解决问题非常有用。
     *  请确保在本教程中使用 HTTP 协议和其对应的 `nodePort`。有关更多信息，请参见常见问题中的[示例配置][Link 2]。
    
    配置编辑完成后，点击**部署**继续。
5.  稍等片刻待 Harbor 启动并运行。
    
    ![创建 Harbor][Harbor 4]

#### 步骤 2：访问 Harbor ####

1.  基于配置文件中 `expose.type` 字段的设置，访问方式可能会不同。本示例使用 `nodePort` 访问 Harbor，按照先前步骤中的设置，访问 `http://nodeIP:30002`。
    
    ![登录 Harbor][Harbor 5]
    
    备注
    
    取决于您的 Kubernetes 集群的部署位置，您可能需要在安全组中放行端口并配置相关的端口转发规则。
2.  使用默认帐户和密码 (`admin/Harbor12345`) 登录 Harbor。密码由配置文件中的 `harborAdminPassword` 字段定义。
    
    ![Harbor 仪表板][Harbor 6]

### 常见问题 ###

1.  如何启用 HTTP 登录？
    
    在步骤 1 中将 `tls.enabled` 设置为 `false`。`externalURL` 的协议必须和 `expose.type.ports` 相同。
    
    如果您使用 Docker 登录，请在 `daemon.json` 中将 `externalURL` 设置为 `insecure-registries` 其中之一，然后重新加载 Docker。
    
    下面是示例配置文件，供您参考。请注意阅读注解。
    
        ## 请注意，192.168.0.9 是示例 IP 地址，您必须使用自己的地址。 
        expose:
          type: nodePort
          tls:
            enabled: false
            secretName: ""
            notarySecretName: ""
            commonName: "192.168.0.9"  # 将 commonName 更改成您自己的值。
          nodePort:
            # NodePort 服务的名称。
            name: harbor
            ports:
              http:
                # 使用 HTTP 服务时，Harbor 监听的服务端口。
                port: 80
                # 使用 HTTP 服务时，Harbor 监听的节点端口。
                nodePort: 30002
              https:
                # 使用 HTTPS 服务时，Harbor 监听的服务端口。
                port: 443
                # 使用 HTTPS 服务时，Harbor 监听的服务端口。
                nodePort: 30003
              # 仅在 notary.enabled 设置为 true 时需要此配置。
              notary:
                # Notary 监听的服务端口。
                port: 4443
                # Notary 监听的节点端口。
                nodePort: 30004
           
        externalURL: http://192.168.0.9:30002 # 使用您自己的 IP 地址。
           
        # Harbor admin 的初始密码。启动 Harbor 后可以通过主页修改。
        harborAdminPassword: "Harbor12345"
        # 用于加密的密钥，必须是包含 16 个字符的字符串。
        secretKey: "not-a-secure-key"
2.  如何启用 HTTPS 登录？
    
    a. 使用自签名证书。
    
     *  在步骤 1 中将配置文件中的 `tls.enabled` 设置为 `true`，并对应编辑 `externalURL`。
     *  将 Pod `harbor-core` 的 `/etc/core/ca` 中存储的自签名证书复制到您的主机。
     *  先在您的主机中信任该自签名证书，然后重启 Docker。
    
    b. 使用公共 SSL。
    
     *  将证书添加为密钥 (Secret)。
     *  在步骤 1 中将配置文件中的 `tls.enabled` 设置为 `true`，并对应编辑 `externalURL`。
     *  编辑 `tls.secretName`。

有关更多信息，请参见 [Harbor 文档][Harbor 7]。

原文链接：https://kubesphere.com.cn/docs/application-store/built-in-apps/harbor-app/

[Harbor]: https://goharbor.io/
[OpenPitrix]: https://kubesphere.com.cn/docs/pluggable-components/app-store/
[Link 1]: https://kubesphere.com.cn/docs/quick-start/create-workspace-and-project/
[bdeaf25bc8711e917b32e23c7713fa31.png]: https://img-blog.csdnimg.cn/img_convert/bdeaf25bc8711e917b32e23c7713fa31.png
[Harbor 1]: https://img-blog.csdnimg.cn/img_convert/541ba3069f85349f16cdb222f9bba891.png
[52dddba4a8c8e00f18f54ae5016ec950.png]: https://img-blog.csdnimg.cn/img_convert/52dddba4a8c8e00f18f54ae5016ec950.png
[Harbor 2]: https://img-blog.csdnimg.cn/img_convert/23510c383503788ed0141bc8a36b372a.png
[Harbor 3]: https://img-blog.csdnimg.cn/img_convert/c80c2e971d802a9f2170315ab1dab084.png
[Link 2]: https://kubesphere.com.cn/docs/application-store/built-in-apps/harbor-app/#%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98
[Harbor 4]: https://img-blog.csdnimg.cn/img_convert/f4d85d76410e0a01633c9a4cfa6c3e84.png
[Harbor 5]: https://img-blog.csdnimg.cn/img_convert/eaebd36777f9831ee52bb0ff27915e28.png
[Harbor 6]: https://img-blog.csdnimg.cn/img_convert/4d295817030efb084b897bb010d16a5d.png
[Harbor 7]: https://goharbor.io/docs/2.1.0/