Развёртывание KubeSphere в кластере Kubernetes

English | 中文

KubeSphere можно развернуть на существующем кластере Kubernetes.

Подготовка

1. Убедитесь, что версия Kubernetes — 1.15.x, 1.16.x, 1.17.x или 1.18.x. Для этого выполните команду:

$ kubectl version
Client Version: version.Info{Major:"1", Minor:"15", GitVersion:"v1.15.1", GitCommit:"4485c6f18cee9a5d3c3b4e523bd27972b1b53892", GitTreeState:"clean", BuildDate:"2019-07-18T09:09:21Z", GoVersion:"go1.12.5", Compiler:"gc", Platform:"linux/amd64"}
Server Version: version.Info{Major:"1", Minor:"15", GitVersion:"v1.15.1", GitCommit:"4485c6f18cee9a5d3c3b4e523bd27972b1b53892", GitTreeState:"clean", BuildDate:"2019-07-18T09:09:21Z", GoVersion:"go1.12.5", Compiler:"gc", Platform:"linux/amd64"}

Обратите внимание на строку Server Version в выводе. Если значение GitVersion больше или равно v1.15.0, то версия Kubernetes подходит для установки. В противном случае обновите версию K8s.

2. Объём доступной памяти в кластере должен быть не менее 2 ГБ. При установке allinone выполните команду free -g, чтобы проверить доступные ресурсы:

$ free -g
              total        used        free      shared  buff/cache   available
Mem:              16          4          10           0           3           2
Swap:             0           0           0

3. KubeSphere требует постоянного хранилища. Выполните команду kubectl get sc, чтобы узнать типы хранилищ в текущей среде (если используется хранилище по умолчанию, то можно не заполнять информацию о хранилище в конфигурационном файле):

$ kubectl get sc
NAME                      PROVISIONER               AGE
ceph                      kubernetes.io/rbd         3d4h
csi-qingcloud (default)   disk.csi.qingcloud.com    54d
glusterfs                 kubernetes.io/glusterfs   3d4h

4. Функция CSR signing должна быть активирована в kube-apiserver. Обратитесь к RKE installation issue.

Если ваш кластер соответствует этим требованиям, вы можете продолжить установку.

Установка

Минимальное развёртывание

kubectl apply -f https://raw.githubusercontent.com/kubesphere/ks-installer/v3.0.0/deploy/kubesphere-installer.yaml
kubectl apply -f https://raw.githubusercontent.com/kubesphere/ks-installer/v3.0.0/deploy/cluster-configuration.yaml

 # Просмотр прогресса и журналов
 $ kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f

После завершения установки выполните следующую команду, чтобы увидеть служебный порт консоли. Используйте IP:consolePort (по умолчанию: 30880), чтобы получить доступ к интерфейсу пользователя KubeSphere. По умолчанию учётная запись администратора кластера — admin/P@88w0rd.

kubectl get svc/ks-console -n kubesphere-system

Это минимальное развёртывание. Чтобы включить дополнительные функции, следуйте инструкциям ниже.

Установка подключаемых компонентов

• Обратите внимание:
  • KubeSphere позволяет включать подключаемые компоненты до или после установки, см. cluster-configuration.yaml;
  • Перед включением подключаемых компонентов убедитесь, что ваш кластер имеет достаточно ресурсов CPU и памяти для их работы.

1. [Необязательно] Создайте сертификат Secret для кластера Etcd (требуется только для включения мониторинга Etcd).

   • Примечание: создайте его на основе фактического местоположения сертификата Etcd в вашем кластере;
   • Если Etcd уже настроен с сертификатом, используйте следующие команды (эти команды подходят для среды кластера Kubeadm):

   $ kubectl create ns kubesphere-monitoring-system
   $ kubectl -n kubesphere-monitoring-system create secret generic kube-etcd-client-certs  \
   --from-file=etcd-client-ca.crt=/etc/kubernetes/pki/etcd/ca.crt  \
   --from-file=etcd-client.crt=/etc/kubernetes/pki/etcd/healthcheck-client.crt  \
   --from-file=etcd-client.key=/etc/kubernetes/pki/etcd/healthcheck-client.key
   • Если у Etcd нет сертификата, создайте пустой Secret:

   kubectl -n kubesphere-monitoring-system create secret generic kube-etcd-client-certs

2. Отредактируйте ClusterConfiguration, чтобы включить подключаемые компоненты:

   kubectl edit cc ks-installer -n kubesphere-system

   После редактирования конфигурации в соответствии с требованиями функций, выйдите из редактора и дождитесь применения изменений. Если изменения не применяются, используйте следующую команду для просмотра журналов:

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

Обновление

1. Скачайте файлы v3.0.0 для установки:

   wget https://raw.githubusercontent.com/kubesphere/ks-installer/v3.0.0/deploy/kubesphere-installer.yaml
   wget https://raw.githubusercontent.com/kubesphere/ks-installer/v3.0.0/deploy/cluster-configuration.yaml

2. Синхронизируйте конфигурацию v2.1.1 с cluster-configuration.yaml, сохранив настройки постоянного хранилища и подключаемых компонентов:

   kubectl apply -f kubesphere-installer.yaml
   kubectl apply -f cluster-configuration.yaml

   Примечание: если в вашем кластере уже установлена версия KubeSphere v2.1.0 или более ранняя, сначала обновитесь до версии v2.1.1.