search

coreos / coreos-kubernetes

CoreOS Container Linux+Kubernetes documentation & Vagrant installers
https://coreos.com/kubernetes/docs/latest/
Apache License 2.0
1.1k stars 466 forks source link

deploy-master docs confusing if avoiding Calico #830

Open pgburt opened 7 years ago

pgburt commented 7 years ago

Problem

User is confused by the step in the docs for invoking the kubelet-wrapper. There may be too many forking paths.

Docs in question https://coreos.com/kubernetes/docs/latest/deploy-master.html

Proposals

Simple: link to docs for kubelet-wrapper and kubelet flags resolved the issue. Do the same in the docs.

Difficult: Consider removing the forking recommendations in the docs, or finding a way to highlight defaults better.

Source

From a user on the Kubernetes Slack:

Hey everyone, I have a question. I’m setting up a kubernetes cluster using the step-by-step instructions. I’m on the deploy master step (again) as I feel I’m having issues with Calico, so I want to set it up without. But the instructions don’t say what to do if you don’t use Calico. The part that I’m confused on is the kubelet creation. It says “if using Calico for network policy, replace ${NETWORK_PLUGIN} with cni and add some rkt options. It doesn’t say what to put for the network plugin if not using Calico. Do I put something else in? Or not use that option altogether? Earlier in the tutorial, it says that flannel also uses CNI and I had to set up CNI for flannel. What do I do? https://coreos.com/kubernetes/docs/latest/deploy-master.html#set-up-calico-for-network-policy-optional
ofthesun9 commented 7 years ago

I am lost as well :-) I would like to make it without calico (until I understand more the pros&con) but I don't understnad how to configure the kubelet.service.... I made few attemps, but the DNS addons failed to install and I guess it is related....

yasassri commented 7 years ago

This is, of course confusing, in previous versions It was told to keep that field blank if not using calico, Can someone clear this out, please? This (https://kubernetes.io/docs/concepts/cluster-administration/network-plugins/) talks about two modes, cni and kubenetes, So if Calico is not used are we suppose to use the kubernetes mode? @pgburt @ofthesun9 Did you get an answer for this? :) @robszumski @aaronlevy any feedback?