Stolon Client (stolonctl)

Stolonctl — это клиент stolon, который управляет кластерами stolon.

Поскольку stolonctl должен взаимодействовать с внутренним хранилищем кластера, ему необходимо предоставить запрошенное имя кластера (--cluster-name), тип внутреннего хранилища (--store-backend) и способ доступа к хранилищу, например:

• Для etcdv2, etcdv3 или consul в качестве хранилища — список конечных точек через запятую (--store-endpoints).
• Для kubernetes в качестве хранилища — тип ресурсов kubernetes (--kube-resource-kind). См. ниже.

Пример использования stolonctl, чтобы проверить статус кластера с именем «stolon-cluster», используя «etcdv3» в качестве внутреннего хранилища:

$ stolonctl --cluster-name=stolon-cluster --store-backend=etcdv3 --store-endpoints=http://etcd-0:2379,http://etcd-1:2379,http://etcd-2:2379 status

Примечание: чтобы не повторять аргументы в каждой команде (или внутри скриптов), все параметры можно экспортировать как переменные среды. Их имена будут совпадать с именами параметров, преобразованными в верхний регистр, с заменой - на _ и префиксом STOLONCTL_.

Например:

STOLONCTL_STORE_BACKEND
STOLONCTL_STORE_ENDPOINTS
STOLONCTL_CLUSTER_NAME

Запуск в Kubernetes

stolonctl ведёт себя аналогично kubectl при выборе способа доступа к API-серверам kubernetes:

• При запуске внутри пода он использует служебную учетную запись пода для подключения к серверам API k8s.
• При внешнем запуске он учитывает переменную среды $KUBECONFIG для подключения. Таким образом, можно использовать файл конфигурации по умолчанию ~/.kube/config, или переопределённый путь, контекст и пространство имён файла kube-config, чтобы задать параметры stolonctl: --kubeconfig, --kube-context и --kube-namespace.

Пример stolonctl, чтобы проверить статус кластера с именем «kube-stolon», используя «kubernetes» в качестве внутреннего хранилища и «configmap» в качестве типа ресурса, где команда stolonctl вызывается через один из прокси-подов stolon:

$kubectl exec -i -t stolon-proxy-669f7b54fd-9psm2 -- stolonctl --cluster-name=kube-stolon --store-backend=kubernetes --kube-resource-kind=configmap status

Та же команда stolonctl как одноразовая:

kubectl run -i -t stolonctl --image=sorintlab/stolon:master-pg9.6 --restart=Never --rm -- /usr/local/bin/stolonctl --cluster-name=kube-stolon --store-backend=kubernetes --kube-resource-kind=configmap status

См. также

Вызов команды stolonctl