433 Commits

Author SHA1 Message Date
Sharjeel Aziz c8eb9126e9 Cleanup and implement style guidelines. (#18980)
* Reworded paragraphs to reduce ambiguity.
* Added min-kubernetes-server-version metadata.
* Converted yaml to a downloadable resource.
2020-02-12 11:06:51 -08:00
Mariyan Dimitrov b70d434b36 Add kubectl patch example with quotes on Windows (#18853)
* Add kubectl patch example with quotes on Windows

When running the `kubectl patch` example, on Windows systems you get an
error when passing the patch request in single quotes. Passing it in
double quotes with the inner ones escaped produced the desired behavior
as is in the example given for Linux systems. I've added a small note
for Windows users to have that in mind.

Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>

* Use Hugo note shortcode

Windows note is placed inside a
[shortcode](https://kubernetes.io/docs/contribute/style/style-guide/#shortcodes)
to be consistent with the style guide.

Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>

* Remove shell Markdown syntax

I've removed the shell syntax from the Windows example and have changed
the description to be the same as the one used in
[jsonpath](https://kubernetes.io/docs/reference/kubectl/jsonpath/)
document to be more consistent. The jsonpath example uses cmd syntax,
though it is note inside a note shortcode, therefore I've opted out of
using any syntax as it seems to break rendering inside the shortcode.

Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>

* Add cmd markdown syntax and fix order list

I've tested this locally with `make docker-serve` on my Linux machine
and finally things are looking better, I've managed to address these two
issues:

- the Windows example is now inside `note` shortcode and also the cmd
syntax renders correctly on the page

- the list of steps broke after the first one, I've indented a paragraph
and now the steps are in the expected order

Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>

* Remove command prompt from example

According to the [style guide](https://kubernetes.io/docs/contribute/style/style-guide/#don-t-include-the-command-prompt), the command prompt should not be included when showing an example. This commit removes it for consistency with the style guide.

Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>
2020-02-08 11:23:53 -08:00
Jacky Wu b9ff4f1bf8 fix: add dns search record limit note. (#18913) 2020-02-07 11:31:46 -08:00
Tim Bannister ecda7af470 Reword kubelet live reconfiguration task (#18629)
- Revise version requirements
- Use glossary tooltips in summary
- Use sentence case for headings
- Write kubelet in lowercase where appropriate
- Add “What's next” section
2020-02-07 11:13:46 -08:00
Andrew Sy Kim 79e1b94c91 Add common examples to Service Topology documentation (#18712)
* service topology: add missing 'enabling service topology' page

Signed-off-by: Andrew Sy Kim <kiman@vmware.com>

* service topology: add common examples

Signed-off-by: Andrew Sy Kim <kiman@vmware.com>
2020-02-06 13:11:26 -08:00
Tim Bannister a84463852e Revise “Encrypting Secret Data at Rest” (#18810)
* Drop reference to old Kubernetes versions

At the time of writing, Kubernetes v1.13 is the oldest supported
version, and encryption-at-rest is no longer alpha.

* Tidy whitespace

* Add table caption

* Set metadata for required Kubernetes version
2020-02-06 13:03:24 -08:00
Mariyan Dimitrov cbb20be969 Fix small typos (#18886)
* Fix small typos

Small typos noticed and fixed in:

- configure-upgrade-etcd.md

- reconfigure-kubelet.md

Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>

* Rephrase a paragraph on etcd upgrade

en\docs\tasks\administer-cluster\configure-upgrade-etcd.md

Following a suggestion in #18886, I've rephrased a sentence on etcd
upgrade prerequisites.

Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>
2020-01-29 12:06:16 -08:00
Mariyan Dimitrov 143b5c0019 Fix typo in Scalability section (#18866)
The phrase `very larger` is not valid, it is supposed to be either `very
large` or `larger`. Propose to have it `very large`.

Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>
2020-01-26 05:53:01 -08:00
lemon 11c462e6f1 Fix deployment name in docs/tasks/administer-cluster/dns-horizontal-autoscaling.md (#18772) 2020-01-19 19:45:36 -08:00
Mariyan Dimitrov cda86d62c0 en: Fix minor semantical issue (#18752)
On the page, it says `as you .KUBECONFIG` whereas it is meant `as your
.KUBECONFIG`. Minor annoyance, but still benefits fixing. One char PR.

Signed-off-by: Mariyan Dimitrov <mariyan.dimitrov@gmail.com>
2020-01-18 09:31:35 -08:00
Gerasimos Dimitriadis 5772d582ea Fix typo in manifests path (#18753) 2020-01-18 09:29:36 -08:00
Marc Bihlmaier 571d2ff008 fix version link to changelog (#18747) 2020-01-17 07:58:57 -08:00
Lubomir I. Ivanov 08ce770ff6 kubeadm-upgrade.md: add more details for upgrade rollbacks (#18424)
Introduce a couple of paragraphs explaining what backup folders
kubeadm creates during upgrade.
2020-01-16 16:42:56 -08:00
Ajay Kemparaj fc4de6b721 coresPerReplica and nodesPerReplica are both floats (#18733)
https://github.com/kubernetes-incubator/cluster-proportional-autoscaler/blob/master/pkg/autoscaler/controller/linearcontroller/linear_controller.go#L51-L52
2020-01-16 15:14:44 -08:00
kvaps 4b35f3e44a Use --allow-change-held-packages flag (#17376) 2020-01-15 03:09:33 -08:00
Sharjeel Aziz 69ceca708e Updated document commands to use placeholders. Incorporated feedback. (#18208) 2020-01-15 01:19:32 -08:00
Antonio Ojea d2dc2c60c6 Use dnsutils image for DNS debugging (#18001)
DNS debugging documentation is using a busybox image as example.
This image has different known issues with the way it resolves
the DNS names in k8s, creating confusion with users that try to
follow the docs.

The e2e tests use a custom small image ~4.3MB for DNS testing
with all the necessary tools. Also, the fact that this image is
being used for the k8s e2e testing guarantees it's compatibility.
2020-01-15 01:17:32 -08:00
Rob Scott c1921541ef Providing more detail on EndpointSlice implementation (#18343) 2020-01-14 09:29:18 -08:00
André Martins 5cb0e3d7b4 Update Cilium related docs (#18563)
* Extend Cilium CNI plugin description

Mention that it works on top of other CNI plugins due to the CNI
chaining [1].

[1]: http://docs.cilium.io/en/v1.6/gettingstarted/cni-chaining/

Signed-off-by: Martynas Pumputis <m@lambda.lt>

* Update Cilium installation steps for kubeadm

- Use the latest v1.6 Cilium.
- By default, Cilium no longer needs/deploys ETCD store.

Signed-off-by: Martynas Pumputis <m@lambda.lt>

* Update Cilium NetworkPolicy guide

- Update minikube min version requirement.
- Use Cilium v1.6.
- Remove the etcd store bits, as Cilium v1.6 no longer depend on
  it by default.

Signed-off-by: Martynas Pumputis <m@lambda.lt>

* Update Cilium installation steps for kubeadm

- How to run without kube-proxy.

Signed-off-by: Martynas Pumputis <m@lambda.lt>

Co-authored-by: Martynas Pumputis <m@lambda.lt>
2020-01-13 04:35:36 -08:00
giri c1327715d0 Update namespaces.md (#18373) 2020-01-09 09:25:46 -08:00
kvaps 391eef3c2f use madison instead of policy (#18558) 2020-01-09 01:55:46 -08:00
Lubomir I. Ivanov f510b223e9 kubeadm: improvements to the cert management documentation (#18397)
- move the sections about custom certificates and external CA
to the kubeadm-certs page
- minor cleanups to the kubeadm-certs page, including updated output
for the check-expiration command
- link the implementation details page to the new locations
for custom certs and external CA
2020-01-03 09:45:42 -08:00
Ivan Boyko f318b7c953 Removed duplicated text (#18214)
* Removed duplicated text

* Restored sentence about default certificate directory per comment from neolit123
2020-01-03 09:41:41 -08:00
Sharjeel Aziz bc549fd3a0 Minor fix for a typo. (#18182) 2019-12-23 11:09:33 -08:00
Xiang Dai f21f4b2257 Fix en language misspell (#18201)
* fix misspell

Signed-off-by: Xiang Dai <764524258@qq.com>

* clean white noise

Signed-off-by: Xiang Dai <764524258@qq.com>
2019-12-20 06:49:32 -08:00
Sharjeel Aziz a29da47ca8 Updated default Corefile that is installed with the current version of CoreDNS. (#18158) 2019-12-16 07:27:37 -08:00
Damini Satya dff2f7b960 Official 1.17 Release Docs (#18011)
* feat: graduate TaintNodesByCondition to GA (#17073)

* Promote StartupProbe to beta (enabled by default). (#17164)

* Watch bookmarks to GA (#17026)

* feat: graduate ScheduleDaemonSetPods to GA (#17350)

* Update Docker installation instructions (#17405)

* Use exact version numbers for installing Docker in Ubuntu (#17428)

* Move CSIMigration and CSIMigrationGCE to Beta in Kubernetes v1.17 (#17478)

* Promote NodeLease feature to GA (#17189)

* Update docs for csi topology ga (#17408)

* Update RunAsUsername to beta (#17460)

* doc:Update RunAsUsername to beta

* doc: update samples - kubernetes.io/os is no longer beta

* Updating based on review feedback

* Promote Node-specific volume limits to GA (#17432)

* Promote PodShareProcessNamespace to stable (#17192)

* Promote PodShareProcessNamespace to stable

* Add for_k8s_version to feature-state label

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

* Readd version-check to shareProcessNamespace task

* Update service load balancer finalizer doc for GA (#17438)

* Update Topology Manager docs (#17451)

* Added information on how device plugins can take advantage
of Topology Manager
* Updated the Topology Manager documentation to include additionalinformation and update some out of date sections

* Fix broken Topology Manager link (#17746)

Part of What's Next Device Plugin section

* Update CRD defaulting docs for GA (#17450)

* Add documentation for VolumeSnapshot Beta (#17233)

* Updating EndpointSlice documentation for beta release in 1.17 (#17411)

* (docs/dualstack): v1.17 updates (#17457)

* Add placehold doc updates for dualstack in 1.17

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Add Downward API and /etc/hosts Pod IP validation

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* remove addressed known issue via k/k pr 85246

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Remove known issue and add flag as part of k/k 79993

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* remove follow up placeholders

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Update verbiage

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Make IP addressing consistent throughout the task

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Update to status.podIPs

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Update content/en/docs/tasks/network/validate-dual-stack.md

Use set instead of env

Co-Authored-By: Khaled Henidak (Kal) <khnidk@outlook.com>

* add topology.kubernetes.io/zone, topology.kubernetes.io/region and node.kubernetes.io/instance-type labels to docs (#17498)

Signed-off-by: Andrew Sy Kim <kiman@vmware.com>

* Service topology alpha documentation (#17459)

* Update list of feature flags for in-tree plugins migrated to CSI (#17533)

Signed-off-by: Deep Debroy <ddebroy@docker.com>

* Update Node concept for TaintNodesByCondition going GA (#17577)

* feat: graduate ResourceQuotaScopeSelectors to GA in 1.17 (#17554)

* kubeadm: update the upgrade documentation for 1.17 (#17587)

* doc: Simplify Windows deployments with RuntimeClass (#16697)

* doc: Simplify Windows deployments with RuntimeClass

* Updating on review feedback

* doc: Adding windows-build label from enhancement 1301

* update doc for kubelet option --reserved-cpus (#17648)

* feat: update TaintNodesByCondition in feature gates table (#17377)

* Update docs for v1 resource quota configuration (#17547)

* AdmissionConfiguration v1 (#17548)

* Update WebhookAdmissionConfiguration examples (#17549)

* Update AWS EBS Migration Feature state (#16126)

* Add resource version section to api-concepts documentation (#16910)

* Add Resource Version semantics section to api concepts

* Clarify risks of going back in time, add details about compaction and watch cache sizes

* Apply suggestions from liggitt

Co-Authored-By: Jordan Liggitt <jordan@liggitt.net>

* remove pesudocode, apply feedback

* Fix typo

* Clarify equality rules

* Cleanup kubectl generators docs (#17609)

* Write ReplicationController without a space

* Drop mentioning unsupported cluster versions

* Fix capitalization for “API group”

* Tweak wording

* Avoid using deprecated generator in example

* add Antrea description in dev-1.17 (#17919)

* Promote VolumeSubpathEnvExpansion to GA

* Reference Documentation for the Kubernetes API for 1.17 (#18019)

* Update feature-gates.md (#18033)

* Reference Documentation for kubectl Commands for 1.17 (#18017)

* Update for v1.17 (#18034)

* Update config.toml(release-1.17) for 1.17 (#18031)
2019-12-09 16:11:29 -08:00
Satyajit Das cc79282861 Broken link fixed (#17961)
* Broken link fixed

* Better wording

Co-Authored-By: Tim Bannister <tim@scalefactory.com>
2019-12-05 20:38:49 -08:00
prameshj 342958a0a2 Update the cluster create and disable commands (#17947) 2019-12-04 18:14:32 -08:00
Marc Bihlmaier b3ac0d1124 Update guaranteed-scheduling-critical-addon-pods.md (#17151)
* Update guaranteed-scheduling-critical-addon-pods.md

cleanup old stuff again

* Update content/en/docs/tasks/administer-cluster/guaranteed-scheduling-critical-addon-pods.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

* Update guaranteed-scheduling-critical-addon-pods.md

remove whitespace
2019-12-04 01:36:57 -08:00
bogard1203 5c87fecbf2 Deleted duplicate sentence and corrected typo (#17902)
* Corrected the typo of 'chck' with 'check'

* Removed the duplicate sentence
2019-12-02 00:09:04 -08:00
Hongcai Ren d66a1be13f Correct RegisterCloudProvider link (#17873) 2019-11-30 03:45:03 -08:00
Sharjeel Aziz aeb3cce703 Update commands/command output to reflect current versions. (#17877)
* Minor heading update according to the guideline

Fixed title of the document to use title case as described in the community guidelines.

* Capitalization fixes.

* Update commands/command output to reflect the current version
2019-11-30 03:43:03 -08:00
Kohei Yoshida 1efdef54c9 add EKS cluster upgrading section (#17800) 2019-11-25 20:51:10 -08:00
Sharjeel Aziz 49ca117430 Minor heading update according to the guideline (#17747)
* Minor heading update according to the guideline

Fixed title of the document to use title case as described in the community guidelines.

* Capitalization fixes.
2019-11-25 20:41:10 -08:00
Paul Anunda dd30366605 Removed duplicate link (#17799)
This change removes a duplicate link to the setup/best-practices/certificates page.
2019-11-25 20:37:10 -08:00
Simon Woo 085ef61502 Correct name of link to PersistentVolume (#17589) 2019-11-21 13:39:29 -08:00
Pablo Castellano 3690a264c7 Fix typo in DNS Autoscaling (#17700) 2019-11-21 02:05:28 -08:00
chentanjun f77f57925e fix-up 404 urls (#17668) 2019-11-20 18:11:28 -08:00
Luzhenxing 86d3882330 use a feature-state shortcode (#17602) 2019-11-17 17:45:42 -08:00
Tim Bannister 6d845b5f0c Clean up sample output for kubeadm upgrade (#17592) 2019-11-17 17:39:41 -08:00
Marc Bihlmaier 16316ee1ca Update kubeadm-upgrade.md (#17310)
[BUGFIX] add fix missing command
2019-11-12 17:12:11 -08:00
Oleg Butuzov 04a42af748 Returning Cert Manager mention. (#17551)
Affected URL
https://kubernetes.io/docs/tasks/administer-cluster/kubeadm/kubeadm-certs/

Cert Manager mention was removed in kubernetes/website@8781518d as part of
the merge conflict resolving.

* Links to cert manager placed back (so we wouldn't see again
  `[cert-manager][cert-manager]` in article text).
* In addition link to cert manager documentation is updated to official
  website (its still readthedocs but, its official by stand of team behind
  of the cert-manager)
2019-11-12 17:08:11 -08:00
Mitesh Jain f222648ebf Remove reference of unsupported k8s versions for CPUManager. (#17330)
* Remove reference of unsupported k8s versions for CPUManager.

* Update note for none-policy and add links.

* Remove redundant note for alpha version.
2019-11-12 01:04:07 -08:00
Mitesh Jain ff22d19e59 Fix indentation / markdown formatting for list numbering. (#17465) 2019-11-07 01:22:42 -08:00
Marc Bihlmaier 24edeac0b4 Update kubeadm-upgrade.md (#17407)
Sometimes, pods like `coredns` only run on the master nodes. If there is a problem with upgrading the master node (e.g. if it is interrupted) those pods will not keep running - and other pods will have problems with connections. 

Draining the master node will switch those pods to other nodes before the upgrade-process.
2019-11-04 14:12:12 -08:00
Rong Gao 851cd9e774 change the daemonset specific exception (#17242) 2019-11-01 23:21:40 -07:00
Luzhenxing 3aab039ac4 change kubectl get deployment output (#17351) 2019-11-01 21:31:40 -07:00
Dr Nic Williams cdc590065c base64 --decode works across Linux and MacOS (#17240)
Signed-off-by: Dr Nic Williams <drnicwilliams@gmail.com>
2019-10-29 18:24:53 -07:00
Mitesh Jain 7fa51c98d9 Update k8s version info for etcd encryption feature in securing-a-cluster. (#17027) 2019-10-27 18:45:25 -07:00