# Подготовка кластера и рабочего места

Перед установкой Global ERP подготовьте Kubernetes-кластер и рабочее место администратора. Требования к среде перечислены в [описании раздела](./010_whatis.md#требования-к-установке).

## Подготовка кластера Kubernetes

Чтобы получить простейший кластер Kubernetes:

1. Установите на хостах [kubelet, kubeadm и kubectl](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/#installing-kubeadm-kubelet-and-kubectl).
2. Запустите `kubeadm init` на ведущем хосте для [инициализации кластера](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/#initializing-your-control-plane-node) и получите токен для присоединения других нод к кластеру.
3. [Подключите ведомые хосты](https://kubernetes.io/docs/tasks/administer-cluster/kubeadm/adding-linux-nodes/) при помощи команды `kubeadm join` и токена.
4. [Установите сетевой плагин CNI](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/#pod-network), такой как [Flannel](https://docs.tigera.io/calico/latest/getting-started/) или [Calico](https://docs.tigera.io/calico/latest/getting-started/).
5. Установите пакет `nfs-common` на каждую ноду, чтобы Kubernetes мог смонтировать NFS.

Подробнее: [читайте в документации Kubernetes](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/).

```{note}

Если кластер запускается в закрытой сети, docker регистр может не использовать SSL (Insecure Docker Registry).
Запуск Insecure Docker Registry для хранения своих docker-образов не самый лучший вариант с точки зрения безопасности, но порой это самое простое и разумное решение в закрытых сетях.

Для настройки нужно изменить (или создать, если такового нет) конфигурационный файл /etc/docker/daemon.json, добавив в него следующие строки:

~~~json
{
    "insecure-registries" : ["myregistry.example.local:1234"]
}
~~~

, где myregistry.example.local:1234 - адрес и порт локального докер регистра

```


## Подготовка рабочего места

1. Установите [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/).
2. Установите [Helm](https://helm.sh/docs/intro/install/).
3. Поместите [файл kubeconfig](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/), необходимый для авторизации пользователя перед кластером, по пути `~/.kube/config`. При создании кластера при помощи `kubeadm init`, такой файл для суперпользователя сохраняется по пути `/etc/kubernetes/admin.conf`.

Проверяем доступ:

```bash
kubectl cluster-info
kubectl get nodes -o wide
```

При успешном подключении должны получить вывод:

```bash
Kubernetes control plane is running at https://0.0.0.0:6443
CoreDNS is running at https://0.0.0.0:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.
NAME           STATUS   ROLES           AGE   VERSION   INTERNAL-IP     EXTERNAL-IP   OS-IMAGE                         KERNEL-VERSION    CONTAINER-RUNTIME
k8s-master01   Ready    control-plane   46d   v1.29.1   0.0.0.0         <none>        Debian GNU/Linux 11 (bullseye)   5.10.0-27-amd64   containerd://1.6.27
k8s-worker01   Ready    <none>          46d   v1.29.1   0.0.0.0         <none>        Debian GNU/Linux 11 (bullseye)   5.10.0-27-amd64   containerd://1.6.27
k8s-worker02   Ready    <none>          46d   v1.29.1   0.0.0.0         <none>        Debian GNU/Linux 11 (bullseye)   5.10.0-27-amd64   containerd://1.6.27
k8s-worker03   Ready    <none>          46d   v1.29.1   0.0.0.0         <none>        Debian GNU/Linux 11 (bullseye)   5.10.0-27-amd64   containerd://1.6.27
```
