Kubectl документация без запуска Kubernetes

Question

Я установил кластер K8S на ноутбуке, используя Kubeadm и VirtualBox.Кажется немного странным, что кластер должен быть запущен и запущен для просмотра документации, показанной ниже.

praveensripati@praveen-ubuntu:~$ kubectl explain pods
Unable to connect to the server: dial tcp 192.168.0.31:6443: connect: no route to host

Есть ли какое-нибудь решение для этого?

Answer 1

Документация объяснения находится в kube-apiserver и его определениях ресурсов.Отсюда необходимость подключения к нему через kubectl explain, чтобы получить любые документы.Это отличается от стандартной базовой справочной системы kubectl, в которой он находится в kubectl коде Голанга.

Так что на самом деле нет другого обходного пути, кроме создания фиктивного кластера Kubernetes иkubectl указать на это.Обратите внимание, что справка CRD может быть недоступна, поскольку они находятся в самих развернутых CRD.

Answer 2

Таким образом, довольно трезвые новости заключаются в том, что AFAIK нет готового способа сделать это, хотя вы могли бы полностью написать плагин kubectl (он стал довольно тривиальным в 1.12).Но сейчас лучшее, что я могу предложить, это следующее:

# figure out which endpoint kubectl uses to retrieve docs:
$ kubectl -v9 explain pods

# from above I learn that in my case it's apparently
# https://192.168.64.11:8443/openapi/v2 so let's curl that:
$ curl -k https://192.168.64.11:8443/openapi/v2 > resources-docs.json

Отсюда вы можете, например, использовать jq для запроса описаний.Это не так хорошо, как правильное объяснение, но это достаточно хороший обходной путь, пока кто-то не напишет плагин kubectl для автономного запроса документов.

Answer 3

См. " kubectl объяснение - # HeptioProTip "

За кулисами kubectl только что сделал запрос API к моему кластеру Kubernetes , схватилтекущая документация Swagger версии API, работающей в кластере, и вывод документации и типов объектов.

Попробуйте kubectl help в качестве автономной альтернативы, но это будет не так полно (ограниченосам kubectl).