---
hide:
  - toc
---

# 创建专有边缘单元

边缘单元定义：指容器运行所需计算资源的集合，包括云端 Master 和边端工作节点 Node。边缘单元跟 K8S 中的集群是同一概念，
但组网方式有所不同，Master 节点部署在云端，一个云端 master (主备多台)对应一个边缘集群。

边缘单元业务：给指定工作集群安装 KubeEdge 云端套件（CloudCore、ControllerManager），并且对其进行全生命周期管理。KubeEdge 是一个开源系统，将原生的容器化应用程序编排功能扩展到边缘节点。

- CloudCore：KubeEdge 云端核心组件。
- ControllerManager：KubeEdge CRD 扩展，目前应用于边缘应用和边缘节点组。

DCE 5.0 云边协同支持两种边缘单元：

- **专有边缘单元** 给指定工作集群安装 KubeEdge 云端套件（CloudCore、ControllerManager），并且对其进行全生命周期管理。

- **外接边缘单元** 指的是将企业系统中已安装的 KubeEdge 接入到 DCE 5.0 云边协同中进行统一管理。参见 [创建外接边缘单元](./create-external-unit.md)

## 操作步骤

下文说明创建专有边缘单元的步骤：

1. 选择左侧导航栏的 __云边协同__ ，进入边缘单元列表页面，点击页面右上角的 __创建边缘单元__ 按钮，在下拉列表中选择 __创建专有边缘单元__ ；

    ![创建专有边缘单元](../../images/create-edgeunit-01.png)

1. 填写基础信息；

    - 边缘单元名称：小写字母、数字、中划线（-）、点（.）的组合，不能有连续符号；以字母或数字为开头、结尾；最多包含 253 个字符。
    - 集群：运行边缘单元控制面的集群。
    - KubeEdge 版本：KubeEdge 开源系统发布的某一个版本，用于将容器化应用程序编排功能扩展到边缘的主机，
      它基于 kubernetes 构建，并为网络应用程序提供基础架构支持。
    - MQTT 服务：是否开启边缘节点中默认的 KubeEdge mqtt 服务（mosquitto），主要作用于消息路由和设备 mapper 通信。

    <!--- 边缘组件副本数：云端边缘组件的副本数，确保云端节点故障时，边缘组件高可用。-->

    - 描述：边缘单元描述信息。

    ![基本信息](../../images/create-edgeunit-05.png)

<!-- 3. 组件仓库设置。KubeEdge 、Kant 的云端组件仓库设置；

    - KubeEdge 镜像仓库：KubeEdge 云端组件镜像仓库。
        - 默认：系统提供的默认镜像仓库地址，存储 KubeEdge 云端组件镜像，像 cloudcore 等。
        - 自定义：如果用户将 KubeEdge 云端组件镜像存储在自己的镜像仓库，用户可以选择自定义镜像仓库地址。

    - KubeEdge Helm 仓库：KubeEdge helm 应用仓库。如果下拉选项中没有您想要的 Helm 仓库，可以点击右侧 __创建仓库__ 按钮，创建新的 Helm 仓库。

    - Kant 镜像仓库：系统所需云端组件镜像仓库，Kant 代指云边协同模块。
        - 默认：系统提供的默认镜像仓库地址，存储云边协同模块所需云端组件镜像，像 kant-worker-admission;
        - 自定义：如果用户将系统云端组件镜像存储在自己的镜像仓库，用户可以选择自定义仓库地址。

    - Kant Helm 仓库：系统所需云端组件 helm 应用仓库，Kant 代指云边协同模块。如果下拉选项中没有您想要的 Helm 仓库，可以点击右侧 __创建仓库__ 按钮，创建新的 Helm 仓库。

    ![组件仓库设置](../../images/create-edgeunit-02.png)

    !!! note

        如果您想修改 KubeEdge 和 Kant 镜像仓库默认值，可以前往 **Global 集群 kant-system 命名空间**下，修改 ConfigMap 配置文件对应参数 kubeedgeImageRepo 和 kantImageRepo。
        
        - ConfigMap 配置文件名称：dynamic-properties-config
        - 参数示例如下：

        ```yaml
        data:
          kantAPIServerProperties: |-
           {
            ...
            # KubeEdge 和 Kant 镜像仓库默认值
            "kubeedgeImageRepo": "docker.m.daocloud.io/kubeedge",
            "kantImageRepo": "release-ci.daocloud.io/kant",
           }
        ``` -->

1. 填写高级设置

    !!! note

        如果您是使用在线安装方式，则只需要填写访问配置，如果使用的是离线安装，则还需设置组件仓库信息。

    **访问设置**
    
    KubeEdge 云端组件的访问设置，边缘节点通过此设置与云端建立连接。

    - 通讯协议：云边信令通道通信协议，云边网络经常不稳定时，推荐使用 QUIC 协议。
    - 访问地址：KubeEdge 云端组件 CloudCore 的访问地址，需要能被边缘节点访问，边缘节点通过该地址与云端建立连接。
    - 端口：云端 CloudCore 默认给边端开放 NodePort 端口，如有冲突，请修改。
        - WebSocketPort ：访问协议 WebSocket 端口，默认30000。
        - QUICPort：访问协议 QUIC 端口，默认30001。
        - HTTPServerPort：HTTP 服务端口，默认30002。
        - CloudStreamPort：云端流处理接口端口，默认30003。
        - TunnelPort：边缘节点业务数据通道端口，默认30004。

    ![访问配置](../../images/create-edgeunit-06.png)

1. 完成以上信息配置后，点击 __确定__ 按钮，完成边缘单元创建，自动返回边缘单元列表。

下一步：[管理边缘单元](./manage-unit.md)