Compare commits

..

75 Commits

Author SHA1 Message Date
Barnabas Makonda 9100f06683 updated config.toml for 1.15 (#14989) 2019-06-19 20:48:48 -07:00
Jim Angel e4757a6dd4 Update config.toml (#13410) 2019-03-25 18:33:16 -07:00
Jim Angel c324c17e55 modified config.toml for 1.13 release (#11496)
1.13 + 4 latest releases supported by sig-docs.
2018-12-03 15:10:59 -08:00
Shuo Li bb90cf4f0d zh_trans_docs_concepts_index_1.11 (#10746)
* zh_trans_docs_concepts_index_1.11

* update trans
2018-11-10 20:02:39 -08:00
Zach Corleissen d8d41116f6 Update site config for l10n teams and 1.11 info (#10667)
Update OWNERS_ALIASES to be current

Fix OWNERS files syntax

Fix currentUrl

Fix currentUrl even more

Standardize value of currentUrl

Fix layout shortcode syntax
2018-10-23 15:56:53 -07:00
Takuya N 712f231b07 Relocate some yaml files to the proper directory (#10220) 2018-09-11 11:30:05 -07:00
Xianglin Gao f396ad33d8 fix the default k8s version in kubeadm (#9885)
Signed-off-by: Xianglin Gao <xianglin.gxl@alibaba-inc.com>
2018-08-17 07:42:10 -07:00
Hardik Dodiya e19980fd67 Update version for PriorityClass (#9321)
With K8s 1.11 it should be `scheduling.k8s.io/v1beta1`
2018-07-17 13:59:39 -07:00
Bobby (Babak) Salamat a706ae9bcd Add note about existing PriorityClasses (#9279)
* Add note about existing PriorityClasses

* Addressed the reviewer's comments
2018-07-04 01:15:25 -07:00
Kaitlyn Barnard 97eada0ebe Blog post for 1.11 release (#9254)
* 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
2018-06-27 13:54:21 -07:00
Misty Linville bae709ea49 Get TOML ready for 1.11 release 2018-06-27 13:07:24 -07:00
Liz 6d983c039f Add kubeadm upgrade docs for 1.11 (#9089)
* 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
2018-06-27 13:07:24 -07:00
Liz fd558f0d94 Documentation on setting node name with Kubeadm (#8925)
* Documentation on setting node name with Kubeadm

* copyedit
2018-06-27 13:07:24 -07:00
Bobby (Babak) Salamat 19a4e904f4 Update pod priority and preemption user docs (#9172)
* Update pod priority and preemption user docs

* Copyedit
2018-06-27 13:07:24 -07:00
Qiming bb2dd30e0c Document for service account projection (#9182)
This adds docs for the service account projection feature.

Xref: kubernetes/kubernetes#63819, kubernetes/community#1973
Closes: #9102
2018-06-27 13:07:24 -07:00
Qiming b566a04e34 Amend dynamic volume list docs (#9181)
The dynamic volume list feature has been documented but the feature gate
related was not there yet.

Closes: #9105
2018-06-27 13:07:24 -07:00
Qiming a0e638adf1 Mention 'KubeletPluginsWatcher' feature (#9177)
* 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
2018-06-27 13:07:24 -07:00
Qiming aa0f7a75c1 Document the Pod Ready++ feature (#9180)
Closes: #9107
Xref: kubernetes/kubernetes#64057
2018-06-27 13:07:24 -07:00
Chuck Ha 99e002aedc Updates HA kubeadm docs (#9066)
* 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
2018-06-27 13:07:24 -07:00
Jordan Liggitt fa7593380c client exec auth: updates for 1.11 (#9154) 2018-06-27 13:07:24 -07:00
Qiming cb820cebbd Update docs related to PersistentVolumeLabel admission control (#9109)
The said admission controller is disabled by default in 1.11
(kubernetes/kubernetes#64326) and scheduled to be removed in future
release.
2018-06-27 13:07:24 -07:00
Klaus Ma ae35800bda The Doc update for ScheduleDaemonSetPods (#8842)
Signed-off-by: Da K. Ma <klaus1982.cn@gmail.com>
2018-06-27 13:07:23 -07:00
Hemant Kumar 53ec6a99e8 Documentation for dynamic volume limits based on node type (#8871)
* 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
2018-06-27 13:07:23 -07:00
Qiming fa92e2fc96 Update DynamicKubeletConfig feature to beta (#9110)
xref: kubernetes/kubernetes#64275
2018-06-27 13:07:23 -07:00
Nikhita Raghunath 3678425e44 crd versioning doc: fix nits (#9142) 2018-06-27 13:07:23 -07:00
Steve Perry c255ca9aa1 Update kubectl component ref page for 1.11. (#9094)
* Update kubectl component ref page for 1.11.

* Add title. Replace stevepe with username.
2018-06-27 13:07:23 -07:00
Vladimir Vivien 1307dc3801 CSI documentation update for raw block volume support (#8927)
* CSI documetation update for raw block volume support

* minor edits for "CSI raw block volume support"

Some small grammar and style nits.

* minor CSIBlockVolume edits
2018-06-27 13:07:23 -07:00
Mehdy Bohlool 00b66727d5 CRD versioning Public Documentation (#8834)
* CRD versioning Public Documentation

* Copyedit

Signed-off-by: Misty Stanley-Jones <mistyhacks@google.com>

* Address feedback

* More rewrites

* Address feedback

* Update main CRD page in light of versioning

* Reorg CRD docs

* Further reorg

* Tweak title
2018-06-27 13:07:23 -07:00
Steve Perry c4c4064194 Update Federation API ref docs for 1.11. (#9064)
* Update Federation API ref docs for 1.11.

* Add titles.

* Update definitions.html
2018-06-27 13:07:23 -07:00
Steve Perry ac7717de03 Update Kubernetes API 1.11 ref docs (#8977)
* Update v1alpha1 to v1beta1.

* Adjust left nav for 1.11 ref docs.

* Trim list of old ref docs.
2018-06-27 13:07:23 -07:00
Qiming 657632393b kubectl reference docs for 1.11 (#9080) 2018-06-27 13:07:22 -07:00
Jan Chaloupka 26805bbcf6 Promote sysctls to Beta (#8804)
* Promote sysctls to Beta

* Copyedits

Signed-off-by: Misty Stanley-Jones <mistyhacks@google.com>

* Review comments

* Address feedback

* More feedback
2018-06-27 13:07:22 -07:00
Michael Taufen 4bd3e92b13 Clarification in dynamic Kubelet config doc (#9061) 2018-06-27 13:07:22 -07:00
Liz 45f7beb548 Documentation on lowercasing kubeadm init apiserver SANs (#9059)
* Documentation on lowercasing kubeadm init apiserver SANs

* fix shortcode to troubleshoot deploy (#9057)
2018-06-27 13:07:22 -07:00
Qiming b01ce412dd Reference doc for kube-components (release-1.11) (#9045)
* Reference doc for kube-components (release-1.11)

* Update cloud-controller-manager.md

* fix shortcode to troubleshoot deploy (#9057)
2018-06-27 13:07:22 -07:00
Qiming 9e69b33365 Reference doc for kubeadm (release-1.11) (#9044)
* Reference doc for kubeadm (release-1.11)

* fix shortcode to troubleshoot deploy (#9057)
2018-06-27 13:07:22 -07:00
Michael Taufen bf668921f4 update dynamic kubelet config docs for v1.11 (#8766)
* update dynamic kubelet config docs for v1.11

* Substantial copyedit

* Address feedback
2018-06-27 13:07:22 -07:00
Jennifer Rondeau 0c1970eaaf fix shortcode to troubleshoot deploy (#9057) 2018-06-27 13:07:22 -07:00
Solly Ross e6fecdf46b Note that Heapster is deprecated (#8827)
* Note that Heapster is deprecated

This notes that Heapster is deprecated, and migrates the relevant
docs to talk about metrics-server or other solutions by default.

* Copyedits and improvements

Signed-off-by: Misty Stanley-Jones <mistyhacks@google.com>

* Address feedback
2018-06-27 13:07:22 -07:00
Kevin Taylor 4d7c685007 VolumeSubpathEnvExpansion alpha feature (#8835) 2018-06-27 13:07:22 -07:00
Pengfei Ni d6b0282703 Add documentation for crictl (#8880)
* Add documentation for crictl

* Copyedit

Signed-off-by: Misty Stanley-Jones <mistyhacks@google.com>

* Final copyedit
2018-06-27 13:07:22 -07:00
Jordan Liggitt 6bbed16e3e PSP readOnly hostPath (#8898) 2018-06-27 13:07:22 -07:00
Lubomir I. Ivanov 903d7142cf dns-custom-namerserver: break down the page into mutliple sections (#8900)
* dns-custom-namerserver: break down the page into mutliple sections

This page is currently about kube-dns and is a bit outdated.
Introduce the heading `# Customizing kube-dns`.

Introduce a separate section about CoreDNS.

* Copyedits, fix headings for customizing DNS

Hey Lubomir,
I coypedited pretty heavily because this workflow is so much easier for docs and because I'm trying to help improve everything touching kubeadm as much as possible.

But there's one outstanding issue wrt headings and intro content: you can't add a heading 1 to a topic to do what you wanted to do. The page title in the front matter is rendered as a heading 1 and everything else has to start at heading 2. (We still need to doc this better in the docs contributing content, I know.)

Instead, I think we need to rewrite the top-of-page intro content to explain better the relationship between kube-dns and CoreDNS. I'm happy to write something, but I thought I'd push this commit first so you can see what I'm doing.

Hope it's all clear -- ping here or on Slack with any questions ~ Jennifer

* Interim fix for talking about CoreDNS

* Fix CoreDNS details
2018-06-27 13:07:22 -07:00
Jordan Liggitt 1c4406ab30 NodeRestriction admission prevents kubelet taint removal (#8911) 2018-06-27 13:07:22 -07:00
Andrew Lytvynov 4cc5461662 Update exec plugin docs with TLS credentials (#8826)
* Update exec plugin docs with TLS credentials

kubernetes/kubernetes#61803 implements TLS client credential support for
1.11.

* Copyedit

* More copyedits for clarification

* Additional copyedit

* Change token->credential
2018-06-27 13:07:22 -07:00
Hemant Kumar d711cb722d Add docs for volume expansion and online resizing (#8896)
* Add docs for volume expansion going beta

* Copyedit

* Address feedback
2018-06-27 13:07:22 -07:00
Nikhita Raghunath ec62317b24 Update CRD subresources doc for 1.11 (#8918) 2018-06-27 13:07:21 -07:00
Lubomir I. Ivanov 8f39d37336 administer-cluster/coredns: include more changes (#8985)
It was requested that for this page a couple of methods
should be outlined:
- manual installation for CoreDNS explained at the Kubernetes
section of the GitHub project for CoreDNS
- installation and upgrade via kubeadm

Make the above changes and also add a section "About CoreDNS".

This commit also lowercases a section title.
2018-06-27 13:07:21 -07:00
Lubomir I. Ivanov 8c8e0a9e27 kubeadm-config: include new commands (#8862)
Add notes and includes for these new commands in 1.11:
- kubeadm config print-default
- kubeadm config migrate
- kubeadm config images list
- kubeadm config images pull

Include placeholder generated files for the above.
2018-06-27 13:07:21 -07:00
Lubomir I. Ivanov 381d615826 kubeadm-init: update the example for the MasterConfiguration (#8958)
- include godocs link for MasterConfiguration
- include example MasterConfiguration
- add note that `kubeadm config print-default` can be used
2018-06-27 13:07:21 -07:00
Lubomir I. Ivanov eeb70f67a3 kubeadm-upgrade: add the 'node [config]' sub-command (#8960)
- Add includes for the generated pages
- Include placeholder generated pages
2018-06-27 13:07:21 -07:00
Misty Stanley-Jones 25ec1ab443 Fix typo 'fiber channel' (#8957)
Signed-off-by: Misty Stanley-Jones <mistyhacks@google.com>
2018-06-27 13:07:21 -07:00
Jan Šafránek c43dedaaab Update block device support for 1.11 (#8895)
* Update block device support for 1.11

* Copyedits
2018-06-27 13:07:21 -07:00
Lubomir I. Ivanov 56b6d68396 kubeadm: update implementation-details.md about CoreDNS (#8829)
- Replace examples from kube-dns to CoreDNS
- Add notes about the CoreDNS feature gate status in 1.11
- Add note that the service name for CoreDNS is also
called `kube-dns`
2018-06-27 13:07:21 -07:00
Lubomir I. Ivanov b8b374cb4a kubeadm: update info about CoreDNS in kubeadm-init.md (#8728)
Add info to install kube-dns instead of CoreDNS, as CoreDNS
is the default DNS server in 1.11.

Add notes that kubeadm config images can be used to list and pull
the required images in 1.11.
2018-06-27 13:07:21 -07:00
Lion-Wei 1821a94879 declare ipvs ga (#8850) 2018-06-27 13:07:21 -07:00
Jennifer Rondeau 6ce80b3353 fix shortcode, add placeholder files to fix deploy failures (#8874) 2018-06-27 13:07:21 -07:00
Qiming 6f3a3b5bfc Mark ExpandPersistentVolumes feature to beta (#8778)
* Update version selector for 1.11

* Mark ExpandPersistentVolumes Beta

xref: kubernetes/kubernetes#64288
2018-06-27 13:07:21 -07:00
Juan Vallejo 7aeb1a2ae2 update 1.11 --server-print info (#8870)
* update 1.11 --server-print info

* Copyedit
2018-06-27 13:07:21 -07:00
Lubomir I. Ivanov cac04327ea independent: update CoreDNS mentions for kubeadm (#8753)
Give CoreDNS instead of kube-dns examples in:
- docs/setup/independent/create-cluster-kubeadm.md
- docs/setup/independent/troubleshooting-kubeadm.md
2018-06-27 13:07:21 -07:00
Lubomir I. Ivanov f57085d519 kubeadm-upgrade: include new command kubeadm upgrade diff (#8617)
Also:
- Include note that this was added in 1.11.
- Modify the note about upgrade guidance.
2018-06-27 13:07:21 -07:00
Andrew Sy Kim 86dcbc9f19 Update cloud controller manager docs to beta 1.11 (#8756)
* Update cloud controller manager docs to beta 1.11

* Use Hugo shortcode for feature state
2018-06-27 13:07:21 -07:00
Lubomir I. Ivanov 3819dc732c kubeadm-alpha: CoreDNS related changes (#8727)
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
2018-06-27 13:07:21 -07:00
Lubomir I. Ivanov d87adaba27 coredns: update notes in administer-cluster/coredns.md (#8697)
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.
2018-06-27 13:07:21 -07:00
Nikhita Raghunath 18f8bf969c Update CRD Subresources for 1.11 (#8519) 2018-06-27 13:07:21 -07:00
Xianglin Gao 7b39ed7185 Update the doc about extra volume in kubeadm config (#8453)
Signed-off-by: Xianglin Gao <xianglin.gxl@alibaba-inc.com>
2018-06-27 13:07:21 -07:00
Qiming fbf5c26fe5 Remove docs related to in-tree support to GPU (#8294)
* 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>
2018-06-27 13:07:21 -07:00
Qiming 88e0fbaf06 Remove InitialResources from admission controllers (#8293)
The feature (was experimental) is dropped in 1.11.

xref: kubernetes/kubernetes#58784
2018-06-27 13:07:21 -07:00
Qiming fa23024678 Remove KUBE_API_VERSIONS doc (#8292)
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
2018-06-27 13:07:21 -07:00
Pavel Pospisil 8bf514918d Bring StorageObjectInUseProtection feature to GA (#8159)
* 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.
2018-06-27 13:07:21 -07:00
Qiming f377f9a171 CRIContainerLogRotation is Beta in 1.11 (#8665)
* Seperate priority and preemption (#8144)

* CRIContainerLogRotation is Beta in 1.11

xref: kubernetes/kubernetes#64046
2018-06-27 13:07:20 -07:00
Qiming c786f99d04 StorageObjectInUseProtection is GA (#8291)
* Feature gate: StorageObjectInUseProtection is GA

Update feature gate reference for 1.11

* Trivial commit to re-trigger Netlify
2018-06-27 13:07:20 -07:00
Misty Stanley-Jones f607448723 Update version selector for 1.11 2018-06-27 13:07:20 -07:00
Klaus Ma 9b4e698be6 Doc about PID pressure condition. (#8211)
* Doc about PID pressure condition.

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

* "so" -> "too"
2018-06-27 13:07:20 -07:00
Harry Zhang ca2914e08e Seperate priority and preemption (#8144) 2018-06-27 13:07:20 -07:00
16 changed files with 2203 additions and 687 deletions
+3 -12
View File
@@ -1,19 +1,10 @@
# Reviewers can /lgtm /approve but not sufficient for auto-merge without an
# approver
reviewers:
- zhangxiaoyu-zidif
- xiangpengzhao
- stewart-yu
- Rajakavitha1
- sig-docs-en-reviews
# Approvers have all the ability of reviewers but their /approve makes
# auto-merge happen if a /lgtm exists, or vice versa, or they can do both
# No need for approvers to also be listed as reviewers
approvers:
- heckj
- bradamant3
- bradtopol
- steveperry-53
- zacharysarah
- chenopis
- mistyhacks
- tengqm
- sig-docs-en-owners
+85 -9
View File
@@ -41,9 +41,11 @@ aliases:
- chrislovecnm
- mfburnett
sig-azure: #Microsoft Azure
- slack
- colemickens
- jdumars
- andyzhangx
- feiskyer
- justaugustus
- karataliu
- khenidak
sig-big-data: #GH: sig-big-data-pr-reviews
- foxish
sig-cli: #Team: CLI; GH: sig-cli-pr-reviews; e.g. kubectl
@@ -61,11 +63,25 @@ aliases:
- smarterclayton
- soltysh
- sttts
sig-cluster-lifecycle: #GH: sig-cluster-lifecycle-pr-reviews
sig-cluster-lifecycle-kubeadm-approvers: # Approving changes to kubeadm documentation
- timothysc
- lukemarsden
- luxas
- roberthbailey
- fabriziopandini
- fabriziopandini
sig-cluster-lifecycle-kubeadm-reviewers: # Reviewing kubeadm documentation
- timothysc
- lukemarsden
- luxas
- roberthbailey
- fabriziopandini
- kad
- xiangpengzhao
- stealthybox
- liztio
- chuckha
- detiber
- dixudx
sig-cluster-ops:
- zehicle
- jdumars
@@ -81,12 +97,71 @@ aliases:
- apelisse
- grodrigues3
- spxtr
sig-docs: #Team: documentation; GH: sig-docs-pr-reviews
sig-docs: #Team: documentation; GH: sig-docs-maintainers
- bradamant3
- steveperry-53
- zacharysarah
- bradtopol
- heckj
- chenopis
- jaredbhatti
- kbarnard10
- mistyhacks
- ryanmcginnis
- steveperry-53
- tengqm
- tfogo
- xiangpengzhao
- zacharysarah
- zhangxiaoyu-zidif
- zparnold
sig-docs-en-owners: #Team: Documentation; GH: sig-docs-en-owners
- bradamant3
- bradtopol
- chenopis
- jaredbhatti
- kbarnard10
- mistyhacks
- ryanmcginnis
- steveperry-53
- stewart-yu
- tengqm
- tfogo
- zacharysarah
- zparnold
sig-docs-en-reviews: #Team: Documentation; GH: sig-docs-pr-reviews
- jimangel
- rajakavitha1
- stewart-yu
- xiangpengzhao
- zhangxiaoyu
sig-docs-ja-owners: #Team: Japanese docs localization; GH: sig-docs-ja-owners
- cstoku
- nasa9084
- tnir
sig-docs-ja-reviews: #Team: Japanese docs PR reviews; GH:sig-docs-ja-reviews
- cstoku
- makocchi-git
- MasayaAoyama
- nasa9084
- tnir
sig-docs-ko-owners: #Team Korean docs localization; GH: sig-docs-ko-owners
- ClaudiaJKang
- gochist
sig-docs-ko-reviews: #Team Korean docs reviews; GH: sig-docs-ko-reviews
- ClaudiaJKang
- gochist
- ianychoi
sig-docs-zh-owners: #Team Chinese docs localization; GH: sig-docs-zh-owners
- dchen1107
- haibinxie
- hanjiayao
- lichuqiang
- tengqm
- xiangpengzhao
- zhangxiaoyu-zidif
sig-docs-zh-reviews: #Team Chinese docs reviews; GH: sig-docs-zh-reviews
- idealhack
- tengqm
- xiangpengzhao
- zhangxiaoyu-zidif
sig-federation: #Team: Federation; e.g. Federated Clusters
- csbell
sig-gcp: #Google Cloud Platform; GH: sig-gcp-pr-reviews
@@ -197,3 +272,4 @@ aliases:
- floreks
sig-windows:
- michmike
+90 -44
View File
@@ -7,7 +7,7 @@ enableRobotsTXT = true
disableKinds = ["taxonomy", "taxonomyTerm"]
ignoreFiles = [ "^OWNERS$", "README.md", "^node_modules$" ]
ignoreFiles = [ "^OWNERS$", "README[-]+[a-z]*\\.md", "^node_modules$", "content/en/docs/doc-contributor-tools" ]
contentDir = "content/en"
@@ -19,6 +19,12 @@ pygmentsUseClasses = false
# See https://help.farbox.com/pygments.html
pygmentsStyle = "emacs"
# Enable Git variables like commit, lastmod
enableGitInfo = true
# Norwegian ("no") is sometimes but not currently used for testing.
disableLanguages = ["no"]
[blackfriday]
hrefTargetBlank = true
fractions = false
@@ -27,71 +33,93 @@ fractions = false
date = ["date", ":filename", "publishDate", "lastmod"]
[permalinks]
blog = "/:section/:year/:month/:day/:slug/"
blog = "/:section/:year/:month/:day/:slug/"
# Be explicit about the output formats. We (currently) only want an RSS feed for the home page.
[outputs]
home = [ "HTML", "RSS"]
home = [ "HTML", "RSS", "HEADERS" ]
page = [ "HTML"]
section = [ "HTML"]
# Add a "text/netlify" media type for auto-generating the _headers file
[mediaTypes]
[mediaTypes."text/netlify"]
delimiter = ""
[outputFormats]
[outputFormats.RSS]
baseName = "feed"
# _headers file output (uses the template at layouts/index.headers)
[outputFormats.HEADERS]
mediatype = "text/netlify"
baseName = "_headers"
isPlainText = true
notAlternative = true
[params]
time_format_blog = "Monday, January 02, 2006"
description = "Production-Grade Container Orchestration"
showedit = true
latest = "v1.11"
latest = "v1.15"
fullversion = "v1.11.0"
fullversion = "v1.11.10"
version = "v1.11"
githubbranch = "master"
docsbranch = "master"
deprecated = false
githubbranch = "v1.11.10"
docsbranch = "release-1.11"
deprecated = true
currentUrl = "https://kubernetes.io/docs/home/"
nextUrl = "http://kubernetes-io-vnext-staging.netlify.com/"
nextUrl = "https://kubernetes-io-vnext-staging.netlify.com/"
githubWebsiteRepo = "github.com/kubernetes/website"
githubWebsiteRaw = "raw.githubusercontent.com/kubernetes/website"
[[params.versions]]
fullversion = "v1.11.0"
fullversion = "v1.15.0"
version = "v1.15"
githubbranch = "v1.15.0"
docsbranch = "release-1.15"
url = "https://kubernetes.io"
[params.pushAssets]
css = [
"callouts",
"styles",
"custom-jekyll/tags"
]
js = [
"custom-jekyll/tags",
"script"
]
[[params.versions]]
fullversion = "v1.14.3"
version = "v1.14"
githubbranch = "v1.14.3"
docsbranch = "release-1.14"
url = "https://v1-14.docs.kubernetes.io"
[[params.versions]]
fullversion = "v1.13.7"
version = "v1.13"
githubbranch = "v1.13.7"
docsbranch = "release-1.13"
url = "https://v1-13.docs.kubernetes.io"
[[params.versions]]
fullversion = "v1.12.9"
version = "v1.12"
githubbranch = "v1.12.9"
docsbranch = "release-1.12"
url = "https://v1-12.docs.kubernetes.io"
[[params.versions]]
fullversion = "v1.11.10"
version = "v1.11"
githubbranch = "v1.11.0"
githubbranch = "v1.11.10"
docsbranch = "release-1.11"
url = "https://kubernetes.io"
[[params.versions]]
fullversion = "v1.10.3"
version = "v1.10"
githubbranch = "v1.10.3"
docsbranch = "release-1.10"
url = "https://kubernetes.io"
[[params.versions]]
fullversion = "v1.9.7"
version = "v1.9"
githubbranch = "v1.9.7"
docsbranch = "release-1.9"
url = "https://v1-9.docs.kubernetes.io"
[[params.versions]]
fullversion = "v1.8.4"
version = "v1.8"
githubbranch = "v1.8.4"
docsbranch = "release-1.8"
url = "https://v1-8.docs.kubernetes.io"
[[params.versions]]
fullversion = "v1.7.6"
version = "v1.7"
githubbranch = "v1.7.6"
docsbranch = "release-1.7"
url = "https://v1-7.docs.kubernetes.io"
url = "https://v1-11.docs.kubernetes.io"
# Language definitions.
@@ -102,11 +130,29 @@ description = "Production-Grade Container Orchestration"
languageName ="English"
# Weight used for sorting.
weight = 1
[languages.cn]
[languages.zh]
title = "Kubernetes"
description = "Production-Grade Container Orchestration"
languageName ="Chinese"
languageName = "中文 Chinese"
weight = 2
contentDir = "content/cn"
contentDir = "content/zh"
[languages.ko]
title = "Kubernetes"
description = "Production-Grade Container Orchestration"
languageName = "한국어 Korean"
weight = 3
contentDir = "content/ko"
[languages.no]
title = "Kubernetes"
description = "Production-Grade Container Orchestration"
languageName ="Norsk"
weight = 4
contentDir = "content/no"
[languages.no.params]
time_format_blog = "02.01.2006"
# A list of language codes to look for untranslated content, ordered from left to right.
language_alternatives = ["en"]
+11
View File
@@ -0,0 +1,11 @@
# This is the directory for English source content.
# Teams and members are visible at https://github.com/orgs/kubernetes/teams.
reviewers:
- sig-docs-en-reviews
approvers:
- sig-docs-en-owners
labels:
- language/en
@@ -111,12 +111,27 @@ object for each such mapping that they want.
PriorityClass also has two optional fields: `globalDefault` and `description`.
The `globalDefault` field indicates that the value of this PriorityClass should
be used for Pods without a `priorityClassName`. Only one PriorityClass with
`globalDefault` set to true can exist in the system. If there is no PriorityClass
`globalDefault` set to true should exist in the system. If there is more than one
PriorityClass with `globalDefault` set to true, the value of the smallest
of those PriorityClasses is used as the default priority. If there is no PriorityClass
with `globalDefault` set, the priority of Pods with no `priorityClassName` is zero.
The `description` field is an arbitrary string. It is meant to tell users of
the cluster when they should use this PriorityClass.
Kubernetes comes with two predefined PriorityClasses: `system-node-critical`, and
`system-cluster-critical`. The former has the highest priority and is used for critical
system Pods that must run on all or most of the nodes and should never
be preempted. The latter is used for system critical Pods that must always
run in a cluster, but they can be terminated on one node and started on a
different node.
{{< note >}}
**Note**: You should never use these PriorityClasses that are dedicated to
system components for non-system Pods. Otherwise, Pods with such high priorities
might preempt system critical components, causing disruption of cluster services.
{{< /note >}}
### Notes about PodPriority and existing clusters
- If you upgrade your existing cluster and enable this feature, the priority
of your existing Pods is effectively zero.
@@ -132,13 +147,13 @@ that use the name of the deleted PriorityClass.
### Example PriorityClass
```yaml
apiVersion: scheduling.k8s.io/v1alpha1
apiVersion: scheduling.k8s.io/v1beta1
kind: PriorityClass
metadata:
name: high-priority
value: 1000000
globalDefault: false
description: "This priority class should be used for XYZ service pods only."
description: "This priority class should be used for XYZ service Pods only."
```
## Pod priority
@@ -242,7 +257,7 @@ preceding question must be yes. If the answer is no, the Node is not considered
for preemption.
{{< /note >}}
If a pending Pod has inter-pod affinity to one or more of the lower-priority Pods
If a pending Pod has inter-Pod affinity to one or more of the lower-priority Pods
on the Node, the inter-Pod affinity rule cannot be satisfied in the absence of those
lower-priority Pods. In this case, the scheduler does not preempt any Pods on the
Node. Instead, it looks for another Node. The scheduler might find a suitable Node
File diff suppressed because it is too large Load Diff
@@ -90,7 +90,7 @@ kubeadm init [flags]
</tr>
<tr>
<td colspan="2">--kubernetes-version string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Default: "stable-1.10"</td>
<td colspan="2">--kubernetes-version string&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Default: "stable-1.11"</td>
</tr>
<tr>
<td></td><td style="line-height: 130%; word-wrap: break-word;">Choose a specific Kubernetes version for the control plane.</td>
+11
View File
@@ -0,0 +1,11 @@
# This is the localization project for Japanese.
# Teams and members are visible at https://github.com/orgs/kubernetes/teams.
reviewers:
- sig-docs-ja-reviews
approvers:
- sig-docs-ja-owners
labels:
- language/ja
+11
View File
@@ -0,0 +1,11 @@
# This is the localization project for Korean.
# Teams and members are visible at https://github.com/orgs/kubernetes/teams.
reviewers:
- sig-docs-ko-reviews
approvers:
- sig-docs-ko-owners
labels:
- language/ko
+11
View File
@@ -0,0 +1,11 @@
# This is the localization project for Chinese.
# Teams and members are visible at https://github.com/orgs/kubernetes/teams.
reviewers:
- sig-docs-zh-reviews
approvers:
- sig-docs-zh-owners
labels:
- language/zh
+117
View File
@@ -0,0 +1,117 @@
<!-- ---
title: Concepts
main_menu: true
content_template: templates/concept
weight: 40
--- -->
---
title: 概念
main_menu: true
content_template: templates/concept
weight: 40
---
{{% capture overview %}}
<!-- The Concepts section helps you learn about the parts of the Kubernetes system and the abstractions Kubernetes uses to represent your cluster, and helps you obtain a deeper understanding of how Kubernetes works. -->
概念部分可以帮助你了解 Kubernetes 的各个组成部分以及 Kubernetes 用来表示集群的一些抽象概念,并帮助你更加深入的理解 Kubernetes 是如何工作的。
<!-- ## Overview -->
## 概述
<!-- To work with Kubernetes, you use *Kubernetes API objects* to describe your cluster's *desired state*: what applications or other workloads you want to run, what container images they use, the number of replicas, what network and disk resources you want to make available, and more. You set your desired state by creating objects using the Kubernetes API, typically via the command-line interface, `kubectl`. You can also use the Kubernetes API directly to interact with the cluster and set or modify your desired state. -->
要使用 Kubernetes,你需要用 *Kubernetes API 对象*来描述集群的*预期状态(desired state)*:包括你需要运行的应用或者负载,它们使用的镜像、副本数,以及所需网络和磁盘资源等等。你可以使用命令行工具 `kubectl` 来调用 Kubernetes API 创建对象,通过所创建的这些对象来配置预期状态。你也可以直接调用 Kubernetes API 和集群进行交互,设置或者修改预期状态。
<!-- Once you've set your desired state, the *Kubernetes Control Plane* works to make the cluster's current state match the desired state. To do so, Kubernetes performs a variety of tasks automatically--such as starting or restarting containers, scaling the number of replicas of a given application, and more. The Kubernetes Control Plane consists of a collection of processes running on your cluster: -->
一旦你设置了你所需的目标状态,*Kubernetes 控制面(control plane)* 会促成集群的当前状态符合其预期状态。为此,Kubernetes 会自动执行各类任务,比如运行或者重启容器、调整给定应用的副本数等等。Kubernetes 控制面由一组运行在集群上的进程组成:
<!-- * The **Kubernetes Master** is a collection of three processes that run on a single node in your cluster, which is designated as the master node. Those processes are: [kube-apiserver](/docs/admin/kube-apiserver/), [kube-controller-manager](/docs/admin/kube-controller-manager/) and [kube-scheduler](/docs/admin/kube-scheduler/).
* Each individual non-master node in your cluster runs two processes:
* **[kubelet](/docs/admin/kubelet/)**, which communicates with the Kubernetes Master.
* **[kube-proxy](/docs/admin/kube-proxy/)**, a network proxy which reflects Kubernetes networking services on each node. -->
* **Kubernetes 主控组件(Master** 包含三个进程,都运行在集群中的某个节上,通常这个节点被称为 master 节点。这些进程包括:[kube-apiserver](/docs/admin/kube-apiserver/)、[kube-controller-manager](/docs/admin/kube-controller-manager/)和[kube-scheduler](/docs/admin/kube-scheduler/)。
* 集群中的每个非 master 节点都运行两个进程:
* **[kubelet](/docs/admin/kubelet/)**,和 Kubernetes 主控组件通信。
* **[kube-proxy](/docs/admin/kube-proxy/)**,一种网络代理,将 Kubernetes 的网络服务代理到每个节点上。
<!-- ## Kubernetes Objects -->
## Kubernetes 对象
<!-- Kubernetes contains a number of abstractions that represent the state of your system: deployed containerized applications and workloads, their associated network and disk resources, and other information about what your cluster is doing. These abstractions are represented by objects in the Kubernetes API; see the [Kubernetes Objects overview](/docs/concepts/abstractions/overview/) for more details. -->
Kubernetes 包含若干抽象用来表示系统状态,包括:已部署的容器化应用和负载、与它们相关的网络和磁盘资源以及有关集群正在运行的其他操作的信息。这些抽象使用 Kubernetes API 对象来表示。参阅 [Kubernetes对象概述](/docs/concepts/abstractions/overview/)以了解详细信息。
<!-- The basic Kubernetes objects include: -->
基本的 Kubernetes 对象包括:
* [Pod](/docs/concepts/workloads/pods/pod-overview/)
* [Service](/docs/concepts/services-networking/service/)
* [Volume](/docs/concepts/storage/volumes/)
* [Namespace](/docs/concepts/overview/working-with-objects/namespaces/)
<!-- In addition, Kubernetes contains a number of higher-level abstractions called Controllers. Controllers build upon the basic objects, and provide additional functionality and convenience features. They include: -->
另外,Kubernetes 包含大量的被称作*控制器(controllers)*的高级抽象。控制器基于基本对象构建并提供额外的功能和方便使用的特性。具体包括:
* [ReplicaSet](/docs/concepts/workloads/controllers/replicaset/)
* [Deployment](/docs/concepts/workloads/controllers/deployment/)
* [StatefulSet](/docs/concepts/workloads/controllers/statefulset/)
* [DaemonSet](/docs/concepts/workloads/controllers/daemonset/)
* [Job](/docs/concepts/workloads/controllers/jobs-run-to-completion/)
<!-- ## Kubernetes Control Plane -->
## Kubernetes 控制面
<!-- The various parts of the Kubernetes Control Plane, such as the Kubernetes Master and kubelet processes, govern how Kubernetes communicates with your cluster. The Control Plane maintains a record of all of the Kubernetes Objects in the system, and runs continuous control loops to manage those objects' state. At any given time, the Control Plane's control loops will respond to changes in the cluster and work to make the actual state of all the objects in the system match the desired state that you provided. -->
关于 Kubernetes 控制平面的各个部分,(如 Kubernetes 主控组件和 kubelet 进程,管理着 Kubernetes 如何与你的集群进行通信。控制平面维护着系统中所有的 Kubernetes 对象的状态记录,并且通过连续的控制循环来管理这些对象的状态。在任一的给定时间点,控制面的控制环都能响应集群中的变化,并且让系统中所有对象的实际状态与你提供的预期状态相匹配。
<!-- For example, when you use the Kubernetes API to create a Deployment object, you provide a new desired state for the system. The Kubernetes Control Plane records that object creation, and carries out your instructions by starting the required applications and scheduling them to cluster nodes--thus making the cluster's actual state match the desired state. -->
比如, 当你通过 Kubernetes API 创建一个 Deployment 对象,你就为系统增加了一个新的目标状态。Kubernetes 控制平面记录着对象的创建,并启动必要的应用然后将它们调度至集群某个节点上来执行你的指令,以此来保持集群的实际状态和目标状态的匹配。
<!-- ### Kubernetes Master -->
### Kubernetes Master 节点
<!-- The Kubernetes master is responsible for maintaining the desired state for your cluster. When you interact with Kubernetes, such as by using the `kubectl` command-line interface, you're communicating with your cluster's Kubernetes master. -->
Kubernetes master 节点负责维护集群的目标状态。当你要与 Kubernetes 通信时,使用如 `kubectl` 的命令行工具,就可以直接与 Kubernetes master 节点进行通信。
<!-- > The "master" refers to a collection of processes managing the cluster state. Typically these processes are all run on a single node in the cluster, and this node is also referred to as the master. The master can also be replicated for availability and redundancy. -->
> "master" 是指管理集群状态的一组进程的集合。通常这些进程都跑在集群中一个单独的节点上,并且这个节点被称为 master 节点。master 节点也可以扩展副本数,来获取更好的性能及冗余。
<!-- ### Kubernetes Nodes -->
### Kubernetes Node 节点
<!-- The nodes in a cluster are the machines (VMs, physical servers, etc) that run your applications and cloud workflows. The Kubernetes master controls each node; you'll rarely interact with nodes directly. -->
集群中的 node 节点(虚拟机、物理机等等)都是用来运行你的应用和云工作流的机器。Kubernetes master 节点控制所有 node 节点;你很少需要和 node 节点进行直接通信。
<!-- #### Object Metadata -->
#### 对象元数据
* [注释](/docs/concepts/overview/working-with-objects/annotations/)
<!-- ### what's next -->
### 下一步
<!-- If you would like to write a concept page, see
[Using Page Templates](/docs/home/contribute/page-templates/)
for information about the concept page type and the concept template. -->
如果你想编写一个概念页面,请参阅[使用页面模板](/docs/home/contribute/page-templates/)获取更多有关概念页面类型和概念模板的信息。
+1 -1
View File
@@ -4,7 +4,7 @@
<div class="content deprecation-warning">
<h3>
Documentation for Kubernetes {{ .Page.Param "version" }} is no longer actively maintained. The version you are currently viewing is a static snapshot.
For up-to-date documentation, see the <a href="{{ .Params.currentUrl }}">latest</a> version.
For up-to-date documentation, see the <a href="{{ .Site.Params.currentUrl }}">latest</a> version.
</h3>
</div>
</main>
+1 -1
View File
@@ -24,7 +24,7 @@ Imported docs must follow these guidelines:
From within this directory, run the following command:
```
+./update-imported-docs-[linux|macos] <config.yaml>
./update-imported-docs <config.yaml>
```
The output should look similar to the following:
+2 -2
View File
@@ -4,5 +4,5 @@ repos:
branch: master
gen-absolute-links: true
files:
- src: CHANGELOG-1.11.md
dst: content/en/docs/imported/release/notes.md
- src: CHANGELOG-1.10.md
dst: docs/imported/release/notes.md