99 Commits

Author SHA1 Message Date
Tim Bannister c3917a5e50 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
2019-12-06 17:48:49 -05:00
Zach Corleissen bb45a9818d Revert breaking commits (#17967)
* Revert "Remove dead links to old getting started guides (#17889)"

This reverts commit d6285eaac4.

* Revert "Fix a command in kubectl cheatsheet (#17888)"

This reverts commit e03f4b258c.
2019-12-05 15:22:49 -08:00
Qiming e03f4b258c Fix a command in kubectl cheatsheet (#17888)
Closes: #17883
2019-11-30 21:23:03 -08:00
praveen-kg e26dd31892 incorrect command for sort-by operation on pod (#17032)
* incorrect command for sort-by

kubectl get pods -n test --sort-by=.spec.capacity.storage, is incorrect for pod as pods will not have capacity.storage under .spec, rather it should be for PersistentVolume.

So change the command  

kubectl get pv -n test --sort-by=.spec.capacity.storage

* Update cheatsheet.md
2019-11-25 21:29:10 -08:00
Dr Nic Williams 41d5f445b2 jsonpath example of child with dot in name (#17625)
Promoting the solution shown in https://github.com/kubernetes/kubernetes/issues/23386#issuecomment-305348170
to formal documentation.
2019-11-17 17:27:41 -08:00
Luzhenxing 09d2b5848c add resource to be the same as kubectl api-resources (#17367) 2019-11-04 19:50:39 -08:00
Luzhenxing 3aab039ac4 change kubectl get deployment output (#17351) 2019-11-01 21:31:40 -07:00
Ismail Alidzhikov 18ee7f8d94 en: Remove deprecated --include-uninitialized flag (#16974)
Signed-off-by: ialidzhikov <i.alidjikov@gmail.com>
2019-10-23 08:36:19 -07:00
Alexander Zhukov cd1b7d6f45 Use the tidle shortcut in the --cache-dir default (#17115) 2019-10-23 06:28:15 -07:00
Yuk, Yongsu d437e8c6bc en: Change the full link in the document to an inline link. (#17057)
* Change the full link in the document to an inline link.

grep -r "https \: \ / \ / kubernetes \ .io" content/en/docs
Changed to inline link except the following list.
- URLs are mentioned directly in the body
- release note
- url to blog
- url to community
- Url to be redirected

* Apply suggestions from code review

Co-Authored-By: June Yi <june.yi@samsung.com>
2019-10-23 06:20:14 -07:00
Tim Bannister 6a954bb700 Replace sample IP address with documentation use address (#16867)
108.59.85.141 is a genuine IPv4 address; at the time of writing it's
assigned to Google LLC / Google Cloud Platform. Use a documentation IPv4
address instead.
2019-10-14 16:05:51 -07:00
Ahmad Bani jamali 57047b2c2c a small fix in the delete all pods (#16824)
There was a typo in kubectl -n my-ns delete pod,svc --all
2019-10-14 15:33:51 -07:00
Daniel Laing a2edf8f934 Minor text edit (#16760)
Clarified the description of `kubectl edit`.
2019-10-14 15:27:51 -07:00
Peter Mikitsh 3964d24053 fix(cheatsheet): update context cmd description (#15935)
* fix(cheatsheet): update context cmd description

* chore: remove newline
2019-10-14 14:55:51 -07:00
Hardy e5863effe6 Add a example for union operator in the shell env (#16282)
In the current example, single quotes are used, but the union operator can  be confusing.
Incorrect:
`kubectl get pod -o=jsonpath='{.items[*]['metadata.name','spec.nodeName']}'`  
Correct:
`kubectl get pods -o=jsonpath="{.items[*]['metadata.name', 'status.capacity']}"`
2019-10-08 15:55:51 -07:00
Song Shukun 4e1ebaa7c8 Rephrase sentence in k8s.io/docs/reference/kubectl/conventions/ (#16732) 2019-10-07 20:45:11 -07:00
Ismail Alidzhikov 5af784afc0 Remove kubectl stop (#16677)
Signed-off-by: ialidzhikov <i.alidjikov@gmail.com>
2019-10-06 04:35:09 -07:00
Pengcheng Chen 657c976468 Fix indent issue in cheatsheet.md (#16574) 2019-09-27 14:22:43 -07:00
Melony QIN 62b279afbb add kubectl run deploy pod into specific namespace (#15825)
* add kubectl run deploy pod into specific namespace

* add my namespace
2019-09-27 14:04:42 -07:00
Ismail Alidzhikov 5f9fe16f28 Align cheatsheet comments (#16178)
Signed-off-by: ialidzhikov <i.alidjikov@gmail.com>
2019-09-27 13:29:36 -07:00
Deepika Pandhi 7bb1acf3dd removed longer version to fetch labels for pods #14778 (#16268)
* updated OR comments

* removed older long version to fetch labels for pods to use only kubectl get pods --show-labels
2019-09-27 13:03:37 -07:00
Pengcheng Chen 54af88fad2 Update the kubectl config command in cheatsheet.md (#16556)
`kubectl config view -o jsonpath='{.users[].name}' ` in the doc doesn't get the list of users as described in the comment actually.
To get the list of users, the json path should be `'{.users[].name}' `
2019-09-25 19:25:06 -07:00
Deepika Pandhi 3eb7612e88 Removed uninitialized flag reference from kubectl cheetsheet (#16485) 2019-09-22 20:21:22 -07:00
Alena Varkockova 3534a19a55 Fix links for kubectl commands (#16450)
* Fix links for kubectl commands

* Fix remaining links
2019-09-20 11:27:26 -07:00
Karen Bradshaw 234ff08588 update generated comp. files, 1.16 (#16339)
* update generated comp. files, 1.16

* update flags

* Update kubelet.md

* table updates
2019-09-17 09:16:25 -07:00
Melony QIN 7796f3cea6 add rollout history and back to specific revision (#15818)
add rollout history and back to specific revision
2019-08-15 20:36:32 -07:00
Zane Bitter 8344dda2f6 Use literals in jsonpath examples (#15775)
It's very difficult to figure out e.g. the correct quotes to use from
regular text that is subject to being converted for typographers quotes.
Use code literals instead to ensure that nothing is modified, and to
distinguish literals from accompanying text.

Signed-off-by: Zane Bitter <zbitter@redhat.com>
2019-08-11 17:53:10 -07:00
lyveng 306a6201b8 Fixed broken link to logging conventions in kubectl cheatsheet (#15699) 2019-08-06 17:12:54 -07:00
Melony QIN a17f259b8d update cheat sheet (#15677)
add sort by capacity
2019-08-05 20:11:53 -07:00
Tim Bannister 20e45f1331 Add concept page for Operators (#14458)
* Add concept page for Operator pattern

* Link to article about Operator best practices
2019-07-11 17:57:07 -07:00
devasat a90f783820 cheatsheet.md: fix command that queries for label version (#15355)
'rc' in the command is interpreted as pod name
2019-07-11 16:13:05 -07:00
Kohei Toyoda 0f1c2b7e68 update generator table for kubectl run (#15146) 2019-07-06 20:50:33 -07:00
Brian Grant 71e027895e Remove myself from review of all files except what-is-kubernetes and the deprecation policy. All of the lists of suggested reviewers need to be overhauled, but that's a separate task. (#15227) 2019-07-06 04:20:35 -07:00
zwwhdls 31fce9bee1 Fix kubectl reference table of '--generator' (#14983)
* fix `--generator` in `kubectl run` guide

* distinguish api group from kubectl command in reference table
2019-06-19 12:02:34 -07:00
Deepika Pandhi 658f5c498d Added --show-labels (#14779)
* updated OR comments

* updated comments from review for --show-labels
2019-06-18 15:36:32 -07:00
Renich Bon Ciric 2f456da350 Fix bad for in short options (#14253)
This one fixes issue #14211.

I just replaced `-o=parameter` instances with `-o parameter`.
2019-05-10 06:39:57 -07:00
rupeshk071 d281cb567a Update overview.md (#13725)
unknown flag: --include-extended-apis
2019-05-06 22:15:40 -07:00
codyc d1ceddba29 fixed indentation for kubectl config view (#14060)
fixed indentation for kubectl config view
2019-04-26 14:06:22 -07:00
codyc fe663ea841 Add reference and link to kubeconfig on kubectl page (#14059) 2019-04-26 14:02:28 -07:00
ismail yenigul 100de28f11 Delete all pods matching the egrep pattern (#13821)
* Delete all pods matching the egrep pattern

* replace egrep with awk to delete pods by a pattern

* Update content/en/docs/reference/kubectl/cheatsheet.md

Co-Authored-By: ismailyenigul <ismailyenigul@gmail.com>
2019-04-25 11:29:49 -07:00
Miguel Angel Medina Mondragon e0d2b86919 add log commands with label flag (#13804)
* add log commands with label flag

* style
2019-04-14 17:44:00 -07:00
AbdullahBM cc09428797 setting current context and finding running pod's YAML (#13665) 2019-04-08 18:03:04 -07:00
Tennis Smith b809bdcba0 Add 'get-contexts' (#13677)
Added `kubectl config get-contexts` for completeness
2019-04-08 18:01:04 -07:00
Roy Lenferink 24261ee01a Updated links on kubectl documentation page (#13579) 2019-04-02 11:25:20 -07:00
Qiming 8858299bfa Reference documentation for kube components (#13444) 2019-03-27 15:58:19 +08:00
Jim Angel 851ef58fa8 Official 1.14 Release Docs (#13174)
* Official documentation on Poseidon/Firmament, a new multi-scheduler support for K8S. (#11752)

* Added documentation about Poseidon-Firmament scheduler

* Fixed some style issues.

* Udpated the document as per the review comments.

* Fixed some typos and updated the document

* Updated the document as per the review comments.

* Document timeout attribute for kms-plugin. (#12158)

See 72540.

* Official documentation on Poseidon/Firmament, a new multi-scheduler  (#12343)

* Removed the old version of the Poseidon documentation. Incorrect location.

* Official documentation on Poseidon/Firmament, a new multi-scheduler support for K8S (#12069)

* Official documentation on Poseidon/Firmament, a new multi-scheduler support for K8S. (#11752)

* Added documentation about Poseidon-Firmament scheduler

* Fixed some style issues.

* Udpated the document as per the review comments.

* Fixed some typos and updated the document

* Updated the document as per the review comments.

* Updated the document as per review comments. Added config details.

* Updated the document as per the latest review comments. Fixed nits

* Made changes as per latest suggestions.

* Some more changes added.

* Updated as per suggestions.

* Changed the release process section.

* SIG Docs edits

Small edits to match style guidelines.

* add plus to feature state

* capitalization

* revert feature state shortcode

since this is a Kubernetes extension, not a direct feature, it shouldn't use the regular feature state tagging.

(cherry picked from commit 7730c1540b)

* Remove initializers from doc. It will be removed in 1.14 (#12331)

* kubeadm: Document CRI auto detection functionality (#12462)

Signed-off-by: Rostislav M. Georgiev <rostislavg@vmware.com>

* Minor doc change for GAing Pod DNS Config (#12514)

* Graduate ExpandInUsePersistentVolumes feature to beta (#10574)

* Rename 2018-11-07-grpc-load-balancing-with-linkerd.md.md file (#12594)

* Add dynamic percentage of node scoring to user docs (#12235)

* Add dynamic percentage of node scoring to user docs

* addressed review comments

* delete special symbol (#12445)

* Update documentation for VolumeSubpathEnvExpansion (#11843)

* Update documentation for VolumeSubpathEnvExpansion

* Address comments - improve descriptions

* Graduate Pod Priority and Preemption to GA (#12428)

* Added Instana links to the documentation (#12977)

* Added link to the Instana Kubernetes integration

* Added Instana link for services section

Added Instana and a link to the Kubernetes integration to the analytics services section and broadened the scope to APM, monitoring and analytics.

* Oxford comma /flex

* More Oxford commas, because they matter

* Update kubectl plugins to stable (#12847)

* documentation for CSI topology beta (#12889)

* Document changes to default RBAC discovery ClusterRole(Binding)s (#12888)

* Document changes to default RBAC discovery ClusterRole(Binding)s

Documentation for https://github.com/kubernetes/enhancements/issues/789 and https://github.com/kubernetes/kubernetes/pull/73807

* documentation review feedback

* CSI raw block to beta (#12931)

* Change incorrect string raw to block (#12926)

Fixes #12925

* Update documentation on node OS/arch labels (#12976)

These labels have been promoted to GA:
https://github.com/kubernetes/enhancements/issues/793

* local pv GA doc updates (#12915)

* Publish CRD OpenAPI Documentation (#12910)

* add documentation for CustomResourcePublishOpenAPI

* address comments

fix links, ordered lists, style and typo

* kubeadm: add document for upgrading from 1.13 to 1.14 (single CP and HA) (#13189)

* kubeadm: add document for upgrading from 1.13 to 1.14

- remove doc for upgrading 1.10 -> 1.11

* kubeadm: apply amends to upgrade-1.14 doc

* kubeadm: apply amends to upgrade-1.14 doc (part2)

* kubeadm: apply amends to upgrade-1.14 doc (part3)

* kubeadm: add note about "upgrade node experimental-control-plane"

+ add comment about `upgrade plan`

* kubeadm: add missing "You should see output similar to this"

* fix bullet indentation (#13214)

* mark PodReadinessGate GA (#12800)

* Update RuntimeClass documentation for beta (#13043)

* Update RuntimeClass documentation for beta

* Update feature gate & add upgrade section

* formatting fixes

* Highlight upgrade action required

* Address feedback

* CSI ephemeral volume alpha documentation (#10934)

* update kubectl documentation (#12867)

* update kubectl documentation

* add document for Secret/ConfigMap generators

* replace `kubectl create -f` by `kubectl apply -f`

* Add page for kustomization support in kubectl

* fix spelling errors and address comments

* Documentation for Windows GMSA feature (#12936)

* Documentation for Windows GMSA feature

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

* Enhancements to GMSA docs

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

* Fix links

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

* Fix GMSA link

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

* Add GMSA feature flag in feature flag list

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

* Relocate GMSA to container configuration

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

* Add example for container spec

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

* Remove changes in Windows index

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

* Update configure-gmsa.md

* Update configure-gmsa.md

* Update configure-gmsa.md

* Update configure-gmsa.md

* Rearrange the steps into two sections and other edits

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

* Fix links

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

* Add reference to script to generate GMSA YAMLs

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

* Some more clarifications for GMSA

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

* HugePages graduated to GA (#13004)

* HugePages graduated to GA

* fixing nit for build

* Docs for node PID limiting (https://github.com/kubernetes/kubernetes/pull/73651) (#12932)

* kubeadm: update the reference documentation for 1.14 (#12911)

* kubeadm: update list of generated files for 1.14

NOTE: PLACEHOLDERS! these files are generated by SIG Docs each
release, but we need them to pass the k/website PR CI.

- add join_phase* (new sub phases of join)
- add init_phase_upload-certs.md (new upload certs phase for init)
- remove alpha-preflight (now both init and join have this)

* kubeadm: update reference docs includes for 1.14

- remove includes from alpha.md
- add upload-certs to init-phase.md
- add join-phase.md and it's phases

* kubeadm: update the editorial content of join and init

- cleanup master->control-plane node
- add some notes about phases and join
- remove table about pre-pulling images
- remove outdated info about self-hosting

* kubeadm: update target release for v1alpha3 removal

1.14 -> 1.15

* kubeadm: copy edits for 1.14 reference docs (part1)

* kubeadm: use "shell" for code blocks

* kubeadm: update the 1.14 HA guide (#13191)

* kubeadm: update the 1.14 HA guide

* kubeadm: try to fix note/caution indent in HA page

* kubeadm: fix missing sudo and minor amends in HA doc

* kubeadm: apply latest amends to the HA doc for 1.14

* fixed a few missed merge conflicts

* Admission Webhook new features doc (#12938)

- kubernetes/kubernetes#74998
- kubernetes/kubernetes#74477
- kubernetes/kubernetes#74562

* Clarifications and fixes in GMSA doc (#13226)

* Clarifications and fixes in GMSA doc

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

* Update configure-gmsa.md

* Reformat to align headings and pre-reqs better

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

* Reformat to align headings and pre-reqs better

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

* Reformat to fix bullets

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

* Reword application of sample gmsa

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

* Update configure-gmsa.md

* Address feedback to use active voice

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

* Address feedback to use active voice

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

* RunAsGroup documentation for Progressing this to Beta (#12297)

* start serverside-apply documentation (#13077)

* start serverside-apply documentation

* add more concept info on server side apply

* Update api concepts

* Update api-concepts.md

* fix style issues

* Document CSI update (#12928)

* Document CSI update

* Finish CSI documentation

Also fix mistake with  ExpandInUsePersistentVolumes documented as beta

* Overall docs for CSI Migration feature (#12935)

* Placeholder docs for CSI Migration feature

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

* Address CR comments and update feature gates

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

* Add mappings for CSI plugins

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

* Add sections for AWS and GCE PD migration

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

* Add docs for Cinder and CSI Migration info

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

* Clarify scope to volumes with file system

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

* Change the format of EBS and Cinder CSI Migration sections to follow the GCE template

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

* Windows documentation updates for 1.14 (#12929)

* Updated the note to indicate doc work for 1.14

* first attempt at md export from gdoc

* simplifyig

* big attempt

* moving DRAFT windows content to PR for review

* moving content to PR in markdown for review

* updated note tags

* Delete windows-contributing.md

deleting this file as it is already ported to the github contributor guide

* fixed formatting in intro and cluster setup guide

* updating formatting for running containers guide

* rejiggered end of troubleshooting

* fixed minor typos

* Clarified the windows binary download step

* Update _index.md

making updates based on feedback

* Update _index.md

updating ovn-kubernetes docs

* Update _index.md

* Update _index.md

* updating relative docs links

updating all the links to be relative links to /docs

* Update _index.md

* Update _index.md

updates for windows services and ovn-kubernetes

* formatted for correct step numbering

* fix typos

* Update _index.md

updates for flannel PR in troubleshooting

* Update _index.md

* Update _index.md

updating a few sections like roadmap, services, troubleshooting/filing tickets

* Update _index.md

* Update _index.md

* Update _index.md

* Fixed a few whitespace issues

* Update _index.md

* Update _index.md

* Update _index.md

* add section on upgrading CoreDNS (#12909)

* documentation for kubelet resource metrics endpoint (#12934)

* windows docs updates for 1.14 (#13279)

* Delete sample-l2bridge-wincni-config.json

this file is not used anywhere

* Update _index.md

* Update _index.md

* Update _index.md

* Update _index.md

* Update _index.md

* Rename content/en/docs/getting-started-guides/windows/_index.md to content/en/docs/setup/windows/_index.md

moving to new location

* Delete flannel-master-kubectl-get-ds.png

* Delete flannel-master-kubeclt-get-pods.png

* Delete windows-docker-error.png

* Add files via upload

* Rename _index.md to add-windows-nodes.md

* Create _index.md

* Update _index.md

* Update add-windows-nodes.md

* Update add-windows-nodes.md

* Create user-guide-windows-nodes.md

* Create user-guide-windows-containers.md

* Update and rename add-windows-nodes.md to intro-windows-nodes.md

* Update user-guide-windows-containers.md

* Rename intro-windows-nodes.md to intro-windows-in-kubernetes.md

* Update user-guide-windows-nodes.md

* Update user-guide-windows-containers.md

* Update user-guide-windows-containers.md

* Update user-guide-windows-nodes.md

* Update user-guide-windows-containers.md

* Update _index.md

* Update intro-windows-in-kubernetes.md

* Update intro-windows-in-kubernetes.md

fixing the pause image

* Update intro-windows-in-kubernetes.md

changing tables from html to MD

* Update user-guide-windows-nodes.md

converting tables from HTML to MD

* Update intro-windows-in-kubernetes.md

* Update user-guide-windows-nodes.md

* Update user-guide-windows-nodes.md

* Update user-guide-windows-nodes.md

updating the numbering , even though it messes up the notes a little bit. Jim will file a ticket to follow up

* Update user-guide-windows-nodes.md

* update to windows docs for 1.14 (#13322)

* Update intro-windows-in-kubernetes.md

* Update intro-windows-in-kubernetes.md

* Update intro-windows-in-kubernetes.md

* Update intro-windows-in-kubernetes.md

* Update intro-windows-in-kubernetes.md

* Update user-guide-windows-containers.md

* Update user-guide-windows-nodes.md

* Update intro-windows-in-kubernetes.md (#13344)

* server side apply followup (#13321)

* change some parts of serverside apply docs in response to comments

* fix typos and wording

* Update config.toml (#13365)
2019-03-25 15:06:16 -07:00
chenrui 5a5f77db64 Fix relative links issue in English content (#13307)
* `http://kubernetes.io/docs/` -> `/docs/` in content/en folder

* `https://kubernetes.io/docs/` -> `/docs/` in content/en folder
2019-03-20 16:05:05 -07:00
Stephen Augustus f61ed1d130 reference/kubectl: Update resource types / short names (#13223)
Signed-off-by: Stephen Augustus <saugustus@vmware.com>
2019-03-20 15:49:05 -07:00
Dani Comnea ad77c02575 Add a note on how to delete kubectl config user name (#13257) 2019-03-19 11:12:23 -07:00
Dinuka Arseculeratne 9e06367354 Fixed issue with ```shell being displayed (#13144) 2019-03-12 16:10:39 -07:00