<story><title>Kubernetes 1.3 released</title><url>https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG.md/#v130</url></story><parent_chain></parent_chain><comment><author>lobster_johnson</author><text>I&amp;#x27;m really liking Kubernetes — we&amp;#x27;re in the process of migrating to it.&lt;p&gt;If there&amp;#x27;s on area that is in dire need of improvement, though, it&amp;#x27;s the documentation. If you look around, there is essentially &lt;i&gt;no&lt;/i&gt; 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 &amp;quot;Kubernetes from scratch&amp;quot; [1] document, but it&amp;#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.)&lt;p&gt;Almost all of the documentation assumes you&amp;#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&amp;#x27;ll end up with a configuration that &lt;i&gt;you don&amp;#x27;t understand&lt;/i&gt;. It doesn&amp;#x27;t help that much of the official documentation is heavily skewed towards GCE&amp;#x2F;GKE, where certain things have a level of automatic magic that you won&amp;#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 &lt;i&gt;not&lt;/i&gt; help someone who needs to maintain it in a careful, controller manner.&lt;p&gt;Right now, I have a working cluster, but getting there involved a bunch of trial and error, a &lt;i&gt;lot&lt;/i&gt; of open browser tabs, source code reading, and so on. (Quick, what version of Docker does Kubernetes want? Kubernetes doesn&amp;#x27;t seem to tell us, and it doesn&amp;#x27;t even verify it on startup. One of the reefs that I ran aground on was when 1.11 didn&amp;#x27;t work, and had to revert to 1.9, based on a random Github issue I found.)&lt;p&gt;[1] &lt;a href=&quot;http:&amp;#x2F;&amp;#x2F;kubernetes.io&amp;#x2F;docs&amp;#x2F;getting-started-guides&amp;#x2F;scratch&amp;#x2F;&quot; rel=&quot;nofollow&quot;&gt;http:&amp;#x2F;&amp;#x2F;kubernetes.io&amp;#x2F;docs&amp;#x2F;getting-started-guides&amp;#x2F;scratch&amp;#x2F;&lt;/a&gt;</text></comment>
<story><title>Kubernetes 1.3 released</title><url>https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG.md/#v130</url></story><parent_chain></parent_chain><comment><author>hnarayanan</author><text>This is exciting. I need to update my Django Kubernetes tutorial (&lt;a href=&quot;https:&amp;#x2F;&amp;#x2F;harishnarayanan.org&amp;#x2F;writing&amp;#x2F;kubernetes-django&amp;#x2F;&quot; rel=&quot;nofollow&quot;&gt;https:&amp;#x2F;&amp;#x2F;harishnarayanan.org&amp;#x2F;writing&amp;#x2F;kubernetes-django&amp;#x2F;&lt;/a&gt;) with some new constructs that simplify things.</text></comment>