< img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=3131724&fmt=gif" />
🚀 KubeSphere v4.1.2 with Enhancements and Bug Fixes is available now. Read the release notes for v4.1.2 → close
  • English
    • English
    • 简体中文
    1. 1.Create a KubeSphere Cloud account and log in to the platform.
    2. 2.In the upper-right corner, click Console, and then click Lite Cluster on the left.
    3. 3.Create a K8s cluster with KubeSphere installed.
    4. 4.Access KubeSphere with the default account and password (admin/P@88w0rd).
  •  Star
  1. Docs / 
  2. Documentation / 
  3. Extension User Guide / 
  4. KubeEdge / 
  5. Add Edge Nodes

Documentation

Last updated:
    Edit

    Add Edge Nodes

    This section describes how to add an edge node.

    Prerequisites

    • You should join a cluster and have the Node Management permission within the cluster. For more information, refer to "Cluster Members" and "Cluster Roles".

    • KubeEdge should have been installed and enabled.

    • The edge node to be added needs to be able to access the 30000, 30001, 30002, 30004 ports of the KubeSphere cluster master node.

    • The edge node has Docker, containerd, CRI-O, or Virtlet installed as the container runtime. KubeEdge use containerd by default as the runtime. For more information, see KubeEdge Documentation.

    • The SSH login information of the edge node has been obtained.

    Configure Edge Node

    Perform the following steps to configure EdgeMesh on the edge node.

    1. Run the following command to edit the /etc/nsswitch.conf file:

      vi /etc/nsswitch.conf

    2. Add the following content to the /etc/nsswitch.conf file and save the file:

      hosts:          dns files mdns4_minimal [NOTFOUND=return]

    3. Run the following command to enable IP forwarding on the edge node:

      sudo echo "net.ipv4.ip_forward = 1" >> /etc/sysctl.conf

    4. Run the following command to verify the configuration result:

      sudo sysctl -p | grep ip_forward

      If the following information is displayed, the configuration is successful:

      net.ipv4.ip_forward = 1

    Add Edge Node

    1. Log in to the KubeSphere web console with a user who has the Node Management permission, and access your cluster.

    2. Click Nodes > Edge Nodes in the left navigation pane.

    3. Click Add on the right side of the page.

    4. In the Add Edge Node dialog, set the parameters for the edge node.

      ParameterDescription

      Name

      The name of the edge node. The system will automatically generate a name for the edge node, or you can manually set the name of the edge node. The name can only contain lowercase letters, numbers, and hyphens (-), must start and end with a lowercase letter or number, and can be up to 63 characters long.

      Add Default Taint

      Whether to add a taint to the edge node to prevent pods from being scheduled to the edge node.

    5. Click Verify to generate the edge node configuration command.

    6. Click Copy to copy the edge node configuration command to the clipboard, then make the following modifications.

      Modify the ports in the edge node configuration command 10000,10001,10002,10004 to the ports exposed by the cloudcore service 30000,30001,30002,30004.

    7. Log in to the edge node and run the modified command.

      Note

      • Ensure that the edge node can access the KubeSphere cluster master node via the IP address specified by the --cloudcore-ipport parameter.

      • Ensure that the edge node can access the ports of KubeSphere cluster master node - 30000, 30001, 30002, 30004 respectively via the port numbers specified by the --cloudcore-ipport, --quicport, --certport, and --tunnelport parameters.

      • Depending on your network environment, you may need to configure firewall and traffic forwarding rules.

    8. Refresh the Edge Nodes page of the KubeSphere web console. If the addition is successful, the edge node will be displayed in the edge node list.

    Receive the latest news, articles and updates from KubeSphere


    Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.

    Previous : Set Auto Expansion for Storage Volumes
    What’s on this Page