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.

Prerequisites

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.

kubesphere-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.

PR

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.

Usability

● Incorrect or missing key steps;

● Missing prerequisites or precautions;

● Ambiguous figures, tables, or texts;

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

Correctness

● 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
Submit
Click to create an issue. An issue template will be automatically generated based on your feedback.