Skip to content

Latest commit

 

History

History
181 lines (128 loc) · 5.74 KB

usage_zh.md

File metadata and controls

181 lines (128 loc) · 5.74 KB

使用

先决条件

  • 安装 docker

  • 安装 kubeadm/kubectl

  • 初始化 Kubernetes

  • 在完成 Kubernetes master 的初始化后, 我们需要暴露 Kubernetes apiserver 的 http 端口8080用于与 edgecontroller/kubectl 交互。请按照以下步骤在 Kubernetes apiserver 中启用 http 端口。

    vi /etc/kubernetes/manifests/kube-apiserver.yaml
    # Add the following flags in spec: containers: -command section
    - --insecure-port=8080
    - --insecure-bind-address=0.0.0.0

克隆KubeEdge

git clone https://github.com/kubeedge/kubeedge.git $GOPATH/src/github.com/kubeedge/kubeedge
cd $GOPATH/src/github.com/kubeedge/kubeedge

配置MQTT模式

KubeEdge 的边缘部分在 deviceTwin 和设备之间使用 MQTT 进行通信。KubeEdge 支持3个 MQTT 模式:

  1. internalMqttMode: 启用内部 mqtt 代理。
  2. bothMqttMode: 同时启用内部和外部代理。
  3. externalMqttMode: 仅启用外部代理。

可以使用 edge.yaml 中的 mode 字段去配置期望的模式。

使用 KubeEdge 的 mqtt 内部或外部模式,您都需要确保在边缘节点上安装 mosquittoemqx edge 作为 MQTT Broker。

生成证书

KubeEdge 在云和边缘之间基于证书进行身份验证/授权。证书可以使用 openssl 生成。请按照以下步骤生成证书。

# $GOPATH/src/github.com/kubeedge/kubeedge/build/tools/certgen.sh genCertAndKey edge

证书和密钥会分别自动生成在/etc/kubeedge/ca/etc/kubeedge/certs 目录下。

运行KubeEdge

运行Cloud

以二进制文件方式运行

  • 构建 Cloud

    cd $GOPATH/src/github.com/kubeedge/kubeedge/cloud
    make # or `make edgecontroller`
  • 修改 $GOPATH/src/github.com/kubeedge/kubeedge/cloud/conf/controller.yaml 配置文件,将 cloudhub.cacloudhub.certcloudhub.key修改为生成的证书路径

  • 创建 device model 和 device CRDs

    cd $GOPATH/src/github.com/kubeedge/kubeedge/build/crds/devices
    kubectl create -f devices_v1alpha1_devicemodel.yaml
    kubectl create -f devices_v1alpha1_device.yaml
  • 运行二进制文件

    cd $GOPATH/src/github.com/kubeedge/kubeedge/cloud
    # run edge controller
    # `conf/` should be in the same directory as the cloned KubeEdge repository
    # verify the configurations before running cloud(edgecontroller)
    ./edgecontroller

运行Edge

部署 Edge node

我们提供了一个示例 node.json 来在 Kubernetes 中添加一个节点。 请确保在 Kubernetes 中添加了边缘节点 edge-node。运行以下步骤以添加边缘节点 edge-node。

  • 编译 $GOPATH/src/github.com/kubeedge/kubeedge/build/node.json 文件,将 metadata.name 修改为edge node name
  • 部署node
    kubectl apply -f $GOPATH/src/github.com/kubeedge/kubeedge/build/node.json
  • 将证书文件传输到edge node

运行Edge

以二进制文件方式运行
  • 构建 Edge

    cd $GOPATH/src/github.com/kubeedge/kubeedge/edge
    make # or `make edge_core`

    KubeEdge 可以跨平台编译,运行在基于ARM的处理器上。 请点击 Cross Compilation 获得相关说明。

  • 修改$GOPATH/src/github.com/kubeedge/kubeedge/edge/conf/edge.yaml配置文件

    • edgehub.websocket.certfileedgehub.websocket.keyfile 替换为自己的证书路径
    • edgehub.websocket.url 中的 0.0.0.0 修改为 master node 的IP
    • 用 edge node name 替换 yaml文件中的 fb4eb70-2783-42b8-b3f-63e2fd6d242e
  • 运行二进制文件

    # run mosquitto
    mosquitto -d -p 1883
    # or run emqx edge
    # emqx start
    
    # run edge_core
    # `conf/` should be in the same directory as the cloned KubeEdge repository
    # verify the configurations before running edge(edge_core)
    ./edge_core
    # or
    nohup ./edge_core > edge_core.log 2>&1 &

    请使用具有root权限的用户运行 edge。

检查状态

在 Cloud 和 Edge 被启动之后, 您能通过如下的命令去检查边缘节点的状态。

kubectl get nodes

请确保您创建的边缘节点状态是 ready

如果您使用华为云 IEF, 那么您创建的边缘节点应该正在运行(可在 IEF 控制台页面中查看)。

部署应用

请按照以下步骤部署应用程序示例。

kubectl apply -f $GOPATH/src/github.com/kubeedge/kubeedge/build/deployment.yaml

提示: 目前对于边缘端,必须在 Pod 配置中使用 hostPort,不然 Pod 会一直处于 ContainerCreating 状态。 hostPort 必须等于 containerPort 而且不能为 0。

然后可以使用下面的命令检查应用程序是否正常运行。

kubectl get pods

运行测试

运行Edge单元测试

make edge_test

单独运行包的单元测试。

export GOARCHAIUS_CONFIG_PATH=$GOPATH/src/github.com/kubeedge/kubeedge/edge
cd <path to package to be tested>
go test -v

运行Edge集成测试

make edge_integration_test

集成测试框架的详细信息和用例

请单击链接 link 找到 KubeEdge 集成测试框架的详细信息和用例。