Skip to content

KubeSphere all-in-one installation

The All-in-One Installation provides a streamlined method to deploy a Kubernetes cluster with KubeSphere on a single Linux node.^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md] This setup utilizes the KubeKey tool to automate the provisioning of both the Kubernetes container platform and the KubeSphere cloud-native container platform simultaneously.^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md]

Prerequisites

Before initiating the installation, ensure that the necessary dependency packages are present on the system^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md]. Common requirements include: * ebtables * socat * ipset * conntrack

Additionally, the target machine should be configured with a static IP address and proper network connectivity^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md].

Installation Process

The installation is carried out in three main steps: obtaining the installation tool, executing the cluster creation command, and verifying the deployment.

1. Download KubeKey

The installation is facilitated by KubeKey (kk), which can be downloaded directly from the official project repository^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md]. For example, to download version v1.2.0:

curl -sfL https://get-kk.kubesphere.io | VERSION=v1.2.0 sh -
chmod +x kk

2. Create the Cluster

Once the binary is prepared, execute the create cluster command with specific version parameters for Kubernetes and KubeSphere^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md]. The command performs an environment check before proceeding:

./kk create cluster --with-kubernetes v1.21.5 --with-kubesphere v3.2.0

During this phase, the installer downloads necessary binaries (such as kubeadm and kubelet) and configures the container runtime.

3. Access and Verification

Upon completion, the installer outputs the default credentials and URL for the KubeSphere web console^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md].

  • Console URL: http://<IP>:30880
  • Default Account: admin
  • Default Password: P@88w0rd

You can verify the status of the installation components or check for errors by inspecting the logs of the installer job^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md]:

[kubectl](<./kubectl.md>) logs -n kubesphere-system $([kubectl](<./kubectl.md>) get [Pod](<./pod.md>) -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f

Sources

^[400-devops-06-kubernetes-k8s-learning-99k8s-all-in-one-readme.md]