Skip to content

Edge Node Onboarding

According to the node access guide, obtain the installation files and access commands, install the EdgeCore edge core software on the node, so that the edge node can establish a connection with the platform and be included in platform management.

When the edge node is first onboarded, the latest version of the EdgeCore edge core software is automatically installed.

Note

The relationship between the access guide and the actual edge node machine is one-to-many. The installation files and access commands from one access guide can be used on multiple actual edge nodes.

Prerequisites

Steps

  1. On the Edge Node List page, click the Access Guide button, and a pop-up window with the access guide will appear on the right.

  2. Based on the node environment configuration, select the corresponding access guide.

  3. Click the Download File button, which will redirect you to the download center. In the download list, select the edge installation package corresponding to the version and architecture: kantadm_{version}_{architecture}.tar.gz. It is recommended to choose the latest version.

  4. Copy the edge installation package to the edge node to be accessed and unzip it.

    Unzip command:

    tar -zxf kantadm_{version}_{architecture}.tar.gz

    Note

    Place the unpacked kantadm binary file in the /usr/local/bin directory.

  5. Access the node by executing the command using either a token or certificate.

    Token Installation

    1. On the access guide interface, click the Token Installation tab in the third step to display the token installation steps.

      Note

      The token in the installation command is valid for 24 hours. For a long-term valid installation method, please use certificate installation.

    2. Access the node by executing the following command.

      kantadm join --cloudcore-host=10.31.226.14 --websocket-port=30000 --node-prefix=edge --token=b2d6bb5d9312c39ffac08ecfd5030bed006b8b67d0799d632d381f19fca9e765.eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2OTQ2NTk3NDV9.0sdaWbYSTURmAYmQwDn_zF7P9TwcRTSMhwPw6l87U7E --cgroup-driver=cgroupfs --remote-runtime-endpoint= --version=v1.12.2 --batch-name=edge --edge-registry=docker.m.daocloud.io/kubeedge --quic-port=30001 --http-port=30002 --stream-port=30003  --tunnel-port=30004 --labels=test=1,test1=1

    Certificate Installation

    1. On the access guide interface, click the Certificate Installation tab in the third step to display the certificate installation steps.

    2. Click the Download Certificate button to download the certificate to your local machine.

    3. Save the certificate and execute the following command.

      mkdir -p /etc/kant && mv ./cert.tar /etc/kant/cert.tar

    4. Access the node by executing the following command.

      kantadm join --cloudcore-host=10.2.129.13 --websocket-port=30000 --node-prefix=sh --remote-runtime-endpoint=unix:///run/containerd/containerd.sock --cgroup-driver=cgroupfs --version=v1.12.6 --batch-name=guide-test --edge-registry=docker.m.daocloud.io/kubeedge --quic-port=30001 --http-port=30002 --stream-port=30003 --tunnel-port=30004

  6. Verify if the edge node has been successfully onboarded.

    1. Select Edge Computing -> Cloud-Edge Collaboration from the left navigation bar to enter the edge unit list page.

    2. Click the edge unit name to enter the edge unit details page.

    3. Select Edge Resources -> Edge Nodes from the left navigation bar to enter the edge node list page.

    4. Check the status of the edge node. If the current status is Healthy, it means the onboarding was successful.

Comments