Release docs for Kubernetes 1.11 #9171

mdlinville · 2018-06-20T17:18:14Z

/hold
/assign @kubernetes/sig-docs-maintainers

This PR is the release vehicle for the docs for Kubernetes 1.11. The Netlify preview is the current state of the release-1.11 branch.

Assignees: There are two pending PRs that need to be merged (#9066 and #9089).

k8sio-netlify-preview-bot · 2018-06-20T17:18:18Z

Deploy preview for kubernetes-io-vnext-staging processing.

Built with commit 76ebd19

https://app.netlify.com/sites/kubernetes-io-vnext-staging/deploys/5b2a8c57e39e7c19092b0d20

k8sio-netlify-preview-bot · 2018-06-20T17:22:33Z

Deploy preview for kubernetes-io-master-staging ready!

Built with commit 97eada0

https://deploy-preview-9171--kubernetes-io-master-staging.netlify.com

k8sio-netlify-preview-bot · 2018-06-20T17:24:32Z

Deploy preview for kubernetes-io-vnext-staging processing.

Built with commit 97eada0

https://app.netlify.com/sites/kubernetes-io-vnext-staging/deploys/5b340806792f89301d8e70c4

chenopis

couple small nits

chenopis · 2018-06-20T18:14:12Z

config.toml

 githubbranch = "master"
-docsbranch = "master"
+docsbranch = "release-1.11"


docsbranch should remain master so that it is correct when the release-1.11 branch gets merged into master.

chenopis · 2018-06-20T18:16:01Z

config.toml

 deprecated = false
 currentUrl = "https://kubernetes.io/docs/home/"
 nextUrl = "http://kubernetes-io-vnext-staging.netlify.com/"
 githubWebsiteRepo = "github.com/kubernetes/website"

+[[params.versions]]


Since we are only supporting current + last 4, remove the section for ~~v1.7 starting on line 87~~ v1.6 starting on line 94.

@chenopis Did you mean removing the section for v1.6?

Yup, sorry. My counting fingers aren't working today. :( I meant for v1.6 starting on line 94.

zacharysarah

We need to add a "static snapshot" warning for 1.10, similar to the one for 1.9--but because this is the first time we've done it in Hugo, I'm not sure how. (Possibly deprecated = true on line 54?)

zacharysarah · 2018-06-20T19:34:45Z

config.toml

 deprecated = false
 currentUrl = "https://kubernetes.io/docs/home/"
 nextUrl = "http://kubernetes-io-vnext-staging.netlify.com/"
 githubWebsiteRepo = "github.com/kubernetes/website"

+[[params.versions]]


@chenopis Did you mean removing the section for v1.6?

zacharysarah · 2018-06-20T19:44:53Z

config.toml

 githubbranch = "master"
-docsbranch = "master"
+docsbranch = "release-1.11"
 deprecated = false


@chenopis @steveperry-53 Is this the value we change to add a "static snapshot" warning to 1.10?

Yes, it triggers display of the deprecation warning message at the top of the page defined in /layouts/partials/deprecation-warning.html.

This should be done in the release-1.10 branch after it has been synced w/ master before the 1.11 release.

mdlinville · 2018-06-27T00:28:14Z

@chenopis just added a commit to address your feedback. PTAL

* Doc about PID pressure condition. Signed-off-by: Da K. Ma <klaus1982.cn@gmail.com> * "so" -> "too"

* Feature gate: StorageObjectInUseProtection is GA Update feature gate reference for 1.11 * Trivial commit to re-trigger Netlify

* Seperate priority and preemption (#8144) * CRIContainerLogRotation is Beta in 1.11 xref: kubernetes/kubernetes#64046

* StorageObjectInUseProtection is GA (#8291) * Feature gate: StorageObjectInUseProtection is GA Update feature gate reference for 1.11 * Trivial commit to re-trigger Netlify * Bring StorageObjectInUseProtection feature to GA StorageObjectInUseProtection is Beta in K8s 1.10. It's brought to GA in K8s 1.11. * Fixed typo and added feature state tags.

The support to the KUBER_API_VERSIONS environment variable is completely dropped (no deprecation). This PR removes the related doc in release-1.11. xref: kubernetes/kubernetes#63165

The feature (was experimental) is dropped in 1.11. xref: kubernetes/kubernetes#58784

* Remove docs related to in-tree support to GPU The in-tree support to GPU is completely removed in release 1.11. This PR removes the related docs in release-1.11 branch. xref: kubernetes/kubernetes#61498 * Update content updated by PR to Hugo syntax Signed-off-by: Misty Stanley-Jones <mistyhacks@google.com>

Signed-off-by: Xianglin Gao <xianglin.gxl@alibaba-inc.com>

CoreDNS is installed by default in 1.11. Add notes on how to install kube-dns instead. Update notes about CoreDNS->CoreDNS upgrades as in 1.11 the Corefile is retained. Add example on upgrading from kube-dns to CoreDNS.

Update note about CoreDNS feature gate. This change also updates a tab as a kubeadm sub-command will change. It looks for a new generated file: generated/kubeadm_alpha_phase_addon_coredns.md instead of: generated/kubeadm_alpha_phase_addon_kube-dns.md

* Update cloud controller manager docs to beta 1.11 * Use Hugo shortcode for feature state

Also: - Include note that this was added in 1.11. - Modify the note about upgrade guidance.

Give CoreDNS instead of kube-dns examples in: - docs/setup/independent/create-cluster-kubeadm.md - docs/setup/independent/troubleshooting-kubeadm.md

xref: kubernetes/kubernetes#64275

* add cos for storage limits * Update docs specific for aws and gce * fix some minor things * Update storage-limits.md * Add k8s version to feature-state shortcode

Signed-off-by: Da K. Ma <klaus1982.cn@gmail.com>

The said admission controller is disabled by default in 1.11 (kubernetes/kubernetes#64326) and scheduled to be removed in future release.

* Updates HA kubeadm docs Signed-off-by: Chuck Ha <ha.chuck@gmail.com> * kubeadm HA - Add stacked control plane steps * ssh instructions and some typos in the bash scripts Signed-off-by: Chuck Ha <ha.chuck@gmail.com> * Fix typos and copypasta errors * Fix rebase issues * Integrate more changes Signed-off-by: Chuck Ha <ha.chuck@gmail.com> * copyedits, layout and formatting fixes * final copyedits * Adds a sanity check for load balancer connection Signed-off-by: Chuck Ha <ha.chuck@gmail.com> * formatting fixes, copyedits * fix typos, formatting

Closes: #9107 Xref: kubernetes/kubernetes#64057

* Mention 'KubeletPluginsWatcher' feature This feature is more developers oriented than users oriented, so simply mention it in the feature gate should be fine. In future, when the design doc is migrated from Google doc to the kubernetes/community repo, we can add links to it for users who want to dig deeper. Closes: #9108 Xref: kubernetes/kubernetes#63328, kubernetes/kubernetes#64605 * Copyedit

The dynamic volume list feature has been documented but the feature gate related was not there yet. Closes: #9105

This adds docs for the service account projection feature. Xref: kubernetes/kubernetes#63819, kubernetes/community#1973 Closes: #9102

* Update pod priority and preemption user docs * Copyedit

* Documentation on setting node name with Kubeadm * copyedit

* Add kubeadm upgrade docs for 1.11 * Initial docs review feedback * Add 1-11 to outline * Fix formatting on tab blocks * Move file to correct location * Add `kubeadm upgrade node config` step * Overzealous ediffing * copyedit, fix lists and headings * clarify --force flag for fixing bad state

* Blog post for 1.11 release * Update 2018-06-26-kubernetes-1.11-release-announcement.md * Update 2018-06-26-kubernetes-1.11-release-announcement.md * Update 2018-06-26-kubernetes-1.11-release-announcement.md

mdlinville · 2018-06-27T22:18:59Z

/lgtm
/approve
/hold cancel

/cc @jberkus

k8s-ci-robot · 2018-06-27T22:19:00Z

@mistyhacks: you cannot LGTM your own PR.

In response to this:

/lgtm
/approve
/hold cancel

/cc @jberkus

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

kbarnard10 · 2018-06-27T22:22:47Z

/approve

k8s-ci-robot · 2018-06-27T22:22:53Z

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: kbarnard10, mistyhacks

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

~~OWNERS~~ [mistyhacks]
~~content/en/blog/OWNERS~~ [kbarnard10]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

kbarnard10 · 2018-06-27T22:25:45Z

/lgtm

k8s-ci-robot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Jun 20, 2018

k8s-ci-robot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Jun 20, 2018

k8s-ci-robot requested review from bowei and caesarxuchao June 20, 2018 17:18

mdlinville added this to the 1.11 milestone Jun 20, 2018

kubernetes deleted a comment from k8sio-netlify-preview-bot Jun 20, 2018

chenopis reviewed Jun 20, 2018

View reviewed changes

zacharysarah reviewed Jun 20, 2018

View reviewed changes

k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Jun 21, 2018

mdlinville force-pushed the release-1.11 branch from 2844fcf to 30a04f8 Compare June 27, 2018 00:24

resouer and others added 16 commits June 27, 2018 13:07

Seperate priority and preemption (#8144)

ca2914e

Doc about PID pressure condition. (#8211)

9b4e698

* Doc about PID pressure condition. Signed-off-by: Da K. Ma <klaus1982.cn@gmail.com> * "so" -> "too"

Update version selector for 1.11

f607448

StorageObjectInUseProtection is GA (#8291)

c786f99

* Feature gate: StorageObjectInUseProtection is GA Update feature gate reference for 1.11 * Trivial commit to re-trigger Netlify

CRIContainerLogRotation is Beta in 1.11 (#8665)

f377f9a

* Seperate priority and preemption (#8144) * CRIContainerLogRotation is Beta in 1.11 xref: kubernetes/kubernetes#64046

Remove KUBE_API_VERSIONS doc (#8292)

fa23024

The support to the KUBER_API_VERSIONS environment variable is completely dropped (no deprecation). This PR removes the related doc in release-1.11. xref: kubernetes/kubernetes#63165

Remove InitialResources from admission controllers (#8293)

88e0fba

The feature (was experimental) is dropped in 1.11. xref: kubernetes/kubernetes#58784

Update the doc about extra volume in kubeadm config (#8453)

7b39ed7

Signed-off-by: Xianglin Gao <xianglin.gxl@alibaba-inc.com>

Update CRD Subresources for 1.11 (#8519)

18f8bf9

coredns: update notes in administer-cluster/coredns.md (#8697)

d87adab

CoreDNS is installed by default in 1.11. Add notes on how to install kube-dns instead. Update notes about CoreDNS->CoreDNS upgrades as in 1.11 the Corefile is retained. Add example on upgrading from kube-dns to CoreDNS.

Update cloud controller manager docs to beta 1.11 (#8756)

86dcbc9

* Update cloud controller manager docs to beta 1.11 * Use Hugo shortcode for feature state

kubeadm-upgrade: include new command kubeadm upgrade diff (#8617)

f57085d

Also: - Include note that this was added in 1.11. - Modify the note about upgrade guidance.

independent: update CoreDNS mentions for kubeadm (#8753)

cac0432

Give CoreDNS instead of kube-dns examples in: - docs/setup/independent/create-cluster-kubeadm.md - docs/setup/independent/troubleshooting-kubeadm.md

tengqm and others added 14 commits June 27, 2018 13:07

Update DynamicKubeletConfig feature to beta (#9110)

fa92e2f

xref: kubernetes/kubernetes#64275

Documentation for dynamic volume limits based on node type (#8871)

53ec6a9

* add cos for storage limits * Update docs specific for aws and gce * fix some minor things * Update storage-limits.md * Add k8s version to feature-state shortcode

The Doc update for ScheduleDaemonSetPods (#8842)

ae35800

Signed-off-by: Da K. Ma <klaus1982.cn@gmail.com>

Update docs related to PersistentVolumeLabel admission control (#9109)

cb820ce

The said admission controller is disabled by default in 1.11 (kubernetes/kubernetes#64326) and scheduled to be removed in future release.

client exec auth: updates for 1.11 (#9154)

fa75933

Document the Pod Ready++ feature (#9180)

aa0f7a7

Closes: #9107 Xref: kubernetes/kubernetes#64057

Amend dynamic volume list docs (#9181)

b566a04

The dynamic volume list feature has been documented but the feature gate related was not there yet. Closes: #9105

Document for service account projection (#9182)

bb2dd30

This adds docs for the service account projection feature. Xref: kubernetes/kubernetes#63819, kubernetes/community#1973 Closes: #9102

Update pod priority and preemption user docs (#9172)

19a4e90

* Update pod priority and preemption user docs * Copyedit

Documentation on setting node name with Kubeadm (#8925)

fd558f0

* Documentation on setting node name with Kubeadm * copyedit

Get TOML ready for 1.11 release

bae709e

mdlinville force-pushed the release-1.11 branch from 8ea8f16 to bae709e Compare June 27, 2018 20:07

Blog post for 1.11 release (#9254)

97eada0

* Blog post for 1.11 release * Update 2018-06-26-kubernetes-1.11-release-announcement.md * Update 2018-06-26-kubernetes-1.11-release-announcement.md * Update 2018-06-26-kubernetes-1.11-release-announcement.md

mdlinville force-pushed the release-1.11 branch from c255f0a to 97eada0 Compare June 27, 2018 21:56

k8s-ci-robot requested a review from jberkus June 27, 2018 22:19

k8s-ci-robot removed the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Jun 27, 2018

k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jun 27, 2018

k8s-ci-robot assigned kbarnard10 Jun 27, 2018

k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jun 27, 2018

k8s-ci-robot merged commit 5f30e7d into master Jun 27, 2018

chenopis added the team/google label Aug 6, 2018

zacharysarah mentioned this pull request Oct 8, 2018

Update localization guidelines #10485

Merged

31 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Release docs for Kubernetes 1.11 #9171

Release docs for Kubernetes 1.11 #9171

mdlinville commented Jun 20, 2018

k8sio-netlify-preview-bot commented Jun 20, 2018

k8sio-netlify-preview-bot commented Jun 20, 2018 •

edited

Loading

k8sio-netlify-preview-bot commented Jun 20, 2018 •

edited

Loading

chenopis left a comment

chenopis Jun 20, 2018

chenopis Jun 20, 2018 •

edited

Loading

zacharysarah Jun 20, 2018

chenopis Jun 20, 2018

zacharysarah left a comment

zacharysarah Jun 20, 2018

zacharysarah Jun 20, 2018

chenopis Jun 20, 2018

chenopis Jun 21, 2018

mdlinville commented Jun 27, 2018

mdlinville commented Jun 27, 2018

k8s-ci-robot commented Jun 27, 2018

kbarnard10 commented Jun 27, 2018

k8s-ci-robot commented Jun 27, 2018

kbarnard10 commented Jun 27, 2018

Release docs for Kubernetes 1.11 #9171

Release docs for Kubernetes 1.11 #9171

Conversation

mdlinville commented Jun 20, 2018

k8sio-netlify-preview-bot commented Jun 20, 2018

k8sio-netlify-preview-bot commented Jun 20, 2018 • edited Loading

k8sio-netlify-preview-bot commented Jun 20, 2018 • edited Loading

chenopis left a comment

Choose a reason for hiding this comment

chenopis Jun 20, 2018

Choose a reason for hiding this comment

chenopis Jun 20, 2018 • edited Loading

Choose a reason for hiding this comment

zacharysarah Jun 20, 2018

Choose a reason for hiding this comment

chenopis Jun 20, 2018

Choose a reason for hiding this comment

zacharysarah left a comment

Choose a reason for hiding this comment

zacharysarah Jun 20, 2018

Choose a reason for hiding this comment

zacharysarah Jun 20, 2018

Choose a reason for hiding this comment

chenopis Jun 20, 2018

Choose a reason for hiding this comment

chenopis Jun 21, 2018

Choose a reason for hiding this comment

mdlinville commented Jun 27, 2018

mdlinville commented Jun 27, 2018

k8s-ci-robot commented Jun 27, 2018

kbarnard10 commented Jun 27, 2018

k8s-ci-robot commented Jun 27, 2018

kbarnard10 commented Jun 27, 2018

k8sio-netlify-preview-bot commented Jun 20, 2018 •

edited

Loading

k8sio-netlify-preview-bot commented Jun 20, 2018 •

edited

Loading

chenopis Jun 20, 2018 •

edited

Loading