Kubernetes 1.3 released
I&#x27;m really liking Kubernetes — we&#x27;re in the process of migrating to it.<p>If there&#x27;s on area that is in dire need of improvement, though, it&#x27;s the documentation. If you look around, there is essentially <i>no</i> documentation that starts from first principles, going through the different components (and their lifecycle, dependencies, requirements and so on) one by one, irrrespectively of the cloud environment. There is a &quot;Kubernetes from scratch&quot; [1] document, but it&#x27;s just a bunch of loose fragments that lacks almost all the necessary detail, and has too many dependencies. (Tip: ask the user to install from source, and leave out how to use images, cloud providers and other things that obscure the workings of everything.)<p>Almost all of the documentation assumes you&#x27;re running kube-up or some other automated setup, which is of course convention, but hides a huge amount of magic in a bunch of shell scripts, Salt config and so on that prevents true understanding. If you run it for, say, AWS, then you&#x27;ll end up with a configuration that <i>you don&#x27;t understand</i>. It doesn&#x27;t help that much of the official documentation is heavily skewed towards GCE&#x2F;GKE, where certain things have a level of automatic magic that you won&#x27;t benefit from when you run on bare metal, for example. kube-up will help someone get it up and running fast, but does <i>not</i> help someone who needs to maintain it in a careful, controller manner.<p>Right now, I have a working cluster, but getting there involved a bunch of trial and error, a <i>lot</i> of open browser tabs, source code reading, and so on. (Quick, what version of Docker does Kubernetes want? Kubernetes doesn&#x27;t seem to tell us, and it doesn&#x27;t even verify it on startup. One of the reefs that I ran aground on was when 1.11 didn&#x27;t work, and had to revert to 1.9, based on a random Github issue I found.)<p>[1] <a href="http:&#x2F;&#x2F;kubernetes.io&#x2F;docs&#x2F;getting-started-guides&#x2F;scratch&#x2F;" rel="nofollow">http:&#x2F;&#x2F;kubernetes.io&#x2F;docs&#x2F;getting-started-guides&#x2F;scratch&#x2F;</a>