<div class="snippet-clipboard-content notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="Kubernetes e2e suite.Generated release_1_2 clientset should create pods, delete pods, watch pods (from (junit_24.xml))

Failing for the past 1 build (Since Unstable#28905 )
Took 5 min 7 sec.
Stacktrace

/go/src/k8s.io/kubernetes/_output/dockerized/go/src/k8s.io/kubernetes/test/e2e/generated_clientset.go:158
Expected error:
    &lt;*errors.errorString | 0xc20850e0a0&gt;: {
        s: &quot;gave up waiting for pod 'podf9342a69-d526-11e5-a8f5-42010af00003' to be 'running' after 5m0s&quot;,
    }
    gave up waiting for pod 'podf9342a69-d526-11e5-a8f5-42010af00003' to be 'running' after 5m0s
not to have occurred"><pre class="notranslate"><code class="notranslate">Kubernetes e2e suite.Generated release_1_2 clientset should create pods, delete pods, watch pods (from (junit_24.xml))

Failing for the past 1 build (Since Unstable#28905 )
Took 5 min 7 sec.
Stacktrace

/go/src/k8s.io/kubernetes/_output/dockerized/go/src/k8s.io/kubernetes/test/e2e/generated_clientset.go:158
Expected error:
    &lt;*errors.errorString | 0xc20850e0a0&gt;: {
        s: "gave up waiting for pod 'podf9342a69-d526-11e5-a8f5-42010af00003' to be 'running' after 5m0s",
    }
    gave up waiting for pod 'podf9342a69-d526-11e5-a8f5-42010af00003' to be 'running' after 5m0s
not to have occurred
</code></pre></div>
<p dir="auto">And e2e logs:</p>
<div class="snippet-clipboard-content notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="Feb 16 19:36:45.943: INFO: Waiting for pod podf9342a69-d526-11e5-a8f5-42010af00003 in namespace 'e2e-tests-clientset-kx6g0' status to be 'running'(found phase: &quot;Pending&quot;, readiness: false) (4m58.478121768s elapsed)
Feb 16 19:36:47.943: INFO: Unexpected error occurred: gave up waiting for pod 'podf9342a69-d526-11e5-a8f5-42010af00003' to be 'running' after 5m0s
[AfterEach] Generated release_1_2 clientset
  /go/src/k8s.io/kubernetes/_output/dockerized/go/src/k8s.io/kubernetes/test/e2e/framework.go:83"><pre class="notranslate"><code class="notranslate">Feb 16 19:36:45.943: INFO: Waiting for pod podf9342a69-d526-11e5-a8f5-42010af00003 in namespace 'e2e-tests-clientset-kx6g0' status to be 'running'(found phase: "Pending", readiness: false) (4m58.478121768s elapsed)
Feb 16 19:36:47.943: INFO: Unexpected error occurred: gave up waiting for pod 'podf9342a69-d526-11e5-a8f5-42010af00003' to be 'running' after 5m0s
[AfterEach] Generated release_1_2 clientset
  /go/src/k8s.io/kubernetes/_output/dockerized/go/src/k8s.io/kubernetes/test/e2e/framework.go:83
</code></pre></div>
<p dir="auto">Forked from <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="51629775" data-permission-text="Title is private" data-url="https://github.com/kubernetes/kubernetes/issues/2841" data-hovercard-type="issue" data-hovercard-url="/kubernetes/kubernetes/issues/2841/hovercard" href="https://github.com/kubernetes/kubernetes/issues/2841">#2841</a>, <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="59325361" data-permission-text="Title is private" data-url="https://github.com/kubernetes/kubernetes/issues/4926" data-hovercard-type="issue" data-hovercard-url="/kubernetes/kubernetes/issues/4926/hovercard?comment_id=78006098&amp;comment_type=issue_comment" href="https://github.com/kubernetes/kubernetes/issues/4926#issuecomment-78006098">#4926 (comment)</a>, <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="86253843" data-permission-text="Title is private" data-url="https://github.com/kubernetes/kubernetes/issues/9399" data-hovercard-type="issue" data-hovercard-url="/kubernetes/kubernetes/issues/9399/hovercard" href="https://github.com/kubernetes/kubernetes/issues/9399">#9399</a>, <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="95355842" data-permission-text="Title is private" data-url="https://github.com/kubernetes/kubernetes/issues/11361" data-hovercard-type="issue" data-hovercard-url="/kubernetes/kubernetes/issues/11361/hovercard" href="https://github.com/kubernetes/kubernetes/issues/11361">#11361</a>, <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="61251481" data-permission-text="Title is private" data-url="https://github.com/kubernetes/kubernetes/issues/5465" data-hovercard-type="issue" data-hovercard-url="/kubernetes/kubernetes/issues/5465/hovercard" href="https://github.com/kubernetes/kubernetes/issues/5465">#5465</a>, and other issues.</p>
<p dir="auto">We need to decide how we want examples to be written, document that, and make existing examples conform.</p>
<p dir="auto">Issues:</p>
<ul dir="auto">
<li>Decide objectives: teaching system concepts, demonstrating system features, getting started quickly with a particular application, providing sample configurations that can be extended by the user for real use cases, ...</li>
<li>If teaching concepts or demonstrating features, which ones? How many examples need to illustrate the same concepts/features?</li>
<li>What techniques do we want to use to make the examples engaging: interactivity, rewards, etc.?</li>
<li>Does it need to be a realistic application configuration (e.g., HA)?</li>
<li>Should the example demonstrate the application being used?</li>
<li>System best practices
<ul dir="auto">
<li><a href="https://github.com/kubernetes/kubernetes/blob/master/docs/user-guide/config-best-practices.md">https://github.com/kubernetes/kubernetes/blob/master/docs/user-guide/config-best-practices.md</a>
<ul dir="auto">
<li>Show individual files and then combined files?</li>
</ul>
</li>
<li><a href="https://github.com/kubernetes/kubernetes/blob/master/docs/user-guide/pods.md#durability-of-pods-or-lack-thereof">https://github.com/kubernetes/kubernetes/blob/master/docs/user-guide/pods.md#durability-of-pods-or-lack-thereof</a>
<ul dir="auto">
<li>Show singleton pods and then demonstrate why controllers are needed for self-healing?</li>
</ul>
</li>
<li>Secret</li>
</ul>
</li>
<li>Cross references to other documentation (e.g., concept and feature documentation)</li>
<li>Consistent organization (e.g., should the summary appear at the beginning or the end?)</li>
<li>Keeping examples up to date with new features and evolving conventions</li>
<li>Repo locations for text vs. config and code</li>
<li>Whether/how to show multiple solutions (e.g., kubectl run and yaml)</li>
<li>Shell command format (e.g., prompt or no prompt)</li>
<li>kubectl output or not</li>
<li>Screenshots</li>
<li>How to make it possible to run examples without cloning the whole repo</li>
<li>System addons that can be assumed (e.g., DNS)</li>
<li>Examples that show the cluster being created and destroyed in addition to deploying the application</li>
<li>Cloud-provider-specific examples vs. portable examples</li>
<li>Unit and end-to-end testing of the examples</li>
</ul>
<p dir="auto">cc <a class="user-mention notranslate" data-hovercard-type="user" data-hovercard-url="/users/aronchick/hovercard" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="https://github.com/aronchick">@aronchick</a></p>