Long-Term Supported Versions

    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].metadata.name}') -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备份