README.md

Deploy

Charts

The plugins dir contains kubegems helm charts.

name	description
kubegems	kubegems core components, installed on the control cluster
kubegems-local	kubegems edge components, installed on the managed cluster
kubegems-install	kubegems installer operator,to install kubegems components and related components

Setup Kubernets Cluster (optional)

From Kind

Skip this section if you already have a kubernetes cluster.

install kind from: https://kind.sigs.k8s.io/docs/user/quick-start/#installation

or

go install sigs.k8s.io/[email protected]

and create a kind cluster

sudo kind create cluster --name kubegems --kubeconfig ${HOME}/.kube/config

or you can use below config to quick setup a faster kind cluster.

cat <<EOF | tee kind-tmp.yaml
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
name: kubegems
nodes:
  - role: control-plane
    extraPortMappings:
      - containerPort: 30000
        hostPort: 30000
kubeadmConfigPatches:
  - |
    apiVersion: kubeadm.k8s.io/v1beta2
    kind: ClusterConfiguration
    etcd:
      local:
        dataDir: /tmp/etcd # /tmp directory is a tmpfs(in memory),use it for speeding up etcd and lower disk IO.
EOF
sudo kind create cluster --config=kind-tmp.yaml --kubeconfig ${HOME}/.kube/config

update cuurent context of kubeconfig to kind-kubegems

kubectl config use-context kind-kubegems

From Kubeadm

Bootstrapping clusters with kubeadm

or using kubeadm with kuberouter for your local environment:

sudo kubeadm init --pod-network-cidr 10.244.0.0/16
KUBECONFIG=/etc/kubernetes/admin.conf kubectl taint nodes --all node-role.kubernetes.io/master-
KUBECONFIG=/etc/kubernetes/admin.conf kubectl apply -f https://raw.githubusercontent.com/cloudnativelabs/kube-router/master/daemonset/kubeadm-kuberouter.yaml

Deploy KubeGems

Install kubegems installer using helm.

helm install --namespace kubegems-installer --create-namespace kubegems-installer charts/kubegems-installer

or deploy installer from generated manifests.

kubectl create namespace kubegems-installer
kubectl apply --namespace kubegems-installer -f https://raw.githubusercontent.com/kubegems/kubegems/main/deploy/installer.yaml

if you has no storage plugin installed:

kubectl apply -f https://raw.githubusercontent.com/kubegems/kubegems/main/deploy/plugins-extends.yaml

Deploy kubegems core components:

kubectl apply -f https://raw.githubusercontent.com/kubegems/kubegems/main/deploy/plugins-core.yaml

Wait until everything becomes OK.

Generate Installer Manifests

Regenerate installer manifests using helm:

make generate-installer-manifests