Install DCE Community in a Kind Cluster¶

This page explains how to install DCE Community package in a kind cluster online.

Preparation¶

• A node with CPU > 8 cores, memory > 12 GB, disk > 100 GB.
• Ensure that the node can access the Internet.

Run the following script to check the system resources and network connectivity:

set -e
if [ $(free -g|grep Mem | awk '{print $2}')              -lt 12 ]; then (echo "insufficient memory! (should >=12G)";); fi
if [ $(grep 'processor' /proc/cpuinfo |sort |uniq |wc -l) -lt 8 ]; then (echo "insufficient CPU! (should >=8C)";); fi
if [ $(df -m / |tail -n 1 | awk '{print $4}') -lt 30720 ]; then (echo "insufficient free disk space of root partition!(should >=30G)";); fi
ping daocloud.io -c 1 &> /dev/null || ( echo "no connection to internet! abort.")
echo "precheck pass.."

Expected output is something like:

precheck pass...

Install Docker¶

set -e
if  [ -x "$(command -v docker )" ] ;then
    echo "docker already installed : version = "$(docker -v);
else
    echo "docker not found, please install it first."
fi

sudo yum install -y yum-utils device-mapper-persistent-data lvm2
sudo yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
sudo sed -i 's+download.docker.com+mirrors.aliyun.com/docker-ce+' /etc/yum.repos.d/docker-ce.repo
sudo yum makecache fast
sudo yum -y install docker-ce
sudo service docker start
sudo systemctl enable docker
sudo yum install -y wget

set -e
if  [ -x "$(command -v docker )" ] ;then
    echo "docker already installed : version = "$(docker -v);
else
    echo "docker not found, please install it first."
fi
sudo apt-get update
sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository --yes "deb [arch=amd64] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"
sudo apt-get -y update
sudo apt-get -y install docker-ce
sudo apt-get -y install wget
sudo service docker start
sudo systemctl enable docker

Install kind cluster¶

1. Download the binary package of kind.

   curl -Lo ./kind https://qiniu-download-public.daocloud.io/kind/v0.17.0/kind-linux-amd64
   chmod +x ./kind
   old_kind=$(which kind)
   if [ -f "$old_kind" ]; then mv ./kind $old_kind; else mv ./kind /usr/bin/kind ; fi
   

2. Check the kind version.

   kind version
   

   The expected output is like:

   kind v0.17.0 go1.19.2 linux/amd64
   

3. Modify the kind_cluster.yaml to make it applicable in your environment.

   Expose the internal port 32088 to port 8888 (customizable) for external communication. The configuration file example is as follows:

   kind_cluster.yaml

   apiVersion: kind.x-k8s.io/v1alpha4
   kind: Cluster
   nodes:
   - role: control-plane
     extraPortMappings:
     - containerPort: 32088
       hostPort: 8888
   

4. Create a Kubernetes cluster of v1.25.3, named (for example) fire-kind-cluster.

   kind create cluster --image release.daocloud.io/kpanda/kindest-node:v1.25.3 --name=fire-kind-cluster --config=kind_cluster.yaml 
   

   The expected output is like:

   Creating cluster "fire-kind-cluster" ...
    ✓ Ensuring node image (release.daocloud.io/kpanda/kindest-node:v1.25.3) 🖼 
    ✓ Preparing nodes 📦  
    ✓ Writing configuration 📜 
    ✓ Starting control-plane 🕹️ 
    ✓ Installing CNI 🔌 
    ✓ Installing StorageClass 💾 
   Set kubectl context to "kind-fire-kind-cluster"
   

5. Check the newly created cluster.

   kind get clusters
   

   The expected output is like:

   fire-kind-cluster
   

Install DCE Community package¶

1. Install dependencies.

   You must install all dependencies of certain versions:

   - helm ≥ 3.11.1
   - skopeo ≥ 1.11.1
   - kubectl ≥ 1.25.6
   - yq ≥ 4.31.1
   

2. Download the dce5-installer binary file on the kind host.

   Takve VERSION=v0.21.0 as an example:

   export VERSION=v0.21.0
   curl -Lo ./dce5-installer https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/dce5-installer-$VERSION
   chmod +x ./dce5-installer
   

3. Get the IP of the node where kind is installed, and start installing DCE 5.0.

   myIP=$(ip -o route get 1.1.1.1 | cut -d " " -f 7)
   ./dce5-installer install-app -z -k $myIP:8888
   

   Note

   The kind cluster only supports NodePort mode. The installation lasts more than 30 minutes, depending on the network speed of image pull. You can observe the Pod startup during the installation with the following command:

   docker exec -it fire-kind-cluster-control-plane kubectl get po -A -w
   

4. After the installation is complete, the command line will prompt that the installation is successful. Congratulations!

   Now you can use the default account and password (admin/changeme) to explore the new DCE 5.0 through the URL prompted on the screen!

   

   Success

   It's recommended to write down the prompted URL for your next visit.

Comments