Innovation Version

      KubeSphere Installation Guide

      This document describes how to install and deploy Kubernetes and KubeSphere clusters on openEuler 21.09.

      What Is KubeSphere

      KubeSphere is an open source distributed OS built on Kubernetes for cloud-native applications. It supports multi-cloud and multi-cluster management and provides full-stack automated IT O&M capabilities, simplifying DevOps-based workflows for enterprises. Its architecture enables plug-and-play integration between third-party applications and cloud-native ecosystem components. For more information, see the KubeSphere official website.


      Prepare a physical machine or VM with openEuler 21.09 installed. For details about the installation method, see the openEuler 21.09 Installation Guide.

      Software Installation

      1. Install KubeKey.

        yum install kubekey

        Note Before the installation, manually deploy Docker on each node in the cluster in advance or use KubeKey to automatically deploy Docker. The Docker version automatically deployed by KubeKey is 20.10.8.

      2. Deploy the KubeSphere cluster.

        kk create cluster --with-kubesphere v3.1.1

        Note After this command is executed, Kubernetes v1.19.8 is installed by default. To specify the Kubernetes version, add --with-kubernetes < version_number > to the end of the command line. The supported Kubernetes versions include v1.17.9, v1.18.8, v.1.19.8, v1.19.9, and v1.20.6.

      3. Check whether the KubeSphere cluster is successfully installed.

        kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0]}') -f

        If the following information is displayed, the KubeSphere cluster is successfully installed:

        Note This document describes how to install KubeSphere in the x86 environment. In the ARM64 environment, you need to install Kubernetes before deploying KubeSphere.

      Accessing the KubeSphere Web Console

      Depending on your network environment, you may need to configure port forwarding rules and firewall policies. Ensure that port 30880 is allowed in the firewall rules.**

      After the KubeSphere cluster is successfully deployed, enter <node_ IP_address>:30880 in the address box of a browser to access the KubeSphere web console.


      See Also

      What is KubeSphere

      Install a Multi-node Kubernetes and KubeSphere Cluster

      Enable Pluggable Components

      Bug Catching

      Buggy Content

      Bug Description

      Submit As Issue

      It's a little complicated....

      I'd like to ask someone.


      Just a small problem.

      I can fix it online!

      Bug Type
      Specifications and Common Mistakes

      ● Misspellings or punctuation mistakes;

      ● Incorrect links, empty cells, or wrong formats;

      ● Chinese characters in English context;

      ● Minor inconsistencies between the UI and descriptions;

      ● Low writing fluency that does not affect understanding;

      ● Incorrect version numbers, including software package names and version numbers on the UI.


      ● Incorrect or missing key steps;

      ● Missing prerequisites or precautions;

      ● Ambiguous figures, tables, or texts;

      ● Unclear logic, such as missing classifications, items, and steps.


      ● Technical principles, function descriptions, or specifications inconsistent with those of the software;

      ● Incorrect schematic or architecture diagrams;

      ● Incorrect commands or command parameters;

      ● Incorrect code;

      ● Commands inconsistent with the functions;

      ● Wrong screenshots.

      Risk Warnings

      ● Lack of risk warnings for operations that may damage the system or important data.

      Content Compliance

      ● Contents that may violate applicable laws and regulations or geo-cultural context-sensitive words and expressions;

      ● Copyright infringement.

      How satisfied are you with this document

      Not satisfied at all
      Very satisfied
      Click to create an issue. An issue template will be automatically generated based on your feedback.
      Bug Catching
      编组 3备份