diff --git a/OWNERS_ALIASES b/OWNERS_ALIASES index 3013808bc0ba3..8306837cf42bc 100644 --- a/OWNERS_ALIASES +++ b/OWNERS_ALIASES @@ -122,6 +122,7 @@ aliases: - Fale - mattiaperi sig-docs-ja-owners: # Admins for Japanese content + - bells17 - inductor - nasa9084 sig-docs-ja-reviews: # PR reviews for Japanese content diff --git a/assets/images/k8s-10th-birthday.svg b/assets/images/k8s-10th-birthday.svg new file mode 100644 index 0000000000000..e77831e9e3ee5 --- /dev/null +++ b/assets/images/k8s-10th-birthday.svg @@ -0,0 +1,676 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/static/js/sortable-table.js b/assets/js/sortable-table.js similarity index 100% rename from static/js/sortable-table.js rename to assets/js/sortable-table.js diff --git a/assets/scss/_base.scss b/assets/scss/_base.scss index 64e84295ff476..b5176c9a1fe97 100644 --- a/assets/scss/_base.scss +++ b/assets/scss/_base.scss @@ -477,7 +477,8 @@ section#cncf { } // OCEAN NODES -#oceanNodes { +#oceanNodes, .td-home .k8s-overview { + padding-top: $ocean-nodes-padding-Y; padding-bottom: $ocean-nodes-padding-Y; diff --git a/assets/scss/_custom.scss b/assets/scss/_custom.scss index cebb62033dca6..aedf1c676410c 100644 --- a/assets/scss/_custom.scss +++ b/assets/scss/_custom.scss @@ -1413,4 +1413,101 @@ div.alert > em.javascript-required { cursor: pointer; text-align: right; padding: 0.2rem; +} + +// Special style for Kubernetes' 10th birthday +section.k8s-birthday-override { + background: #dae9f9; // Kubernetes light blue + + > .k8s-birthday-wrapper { + display: flex; + flex-direction: row; + justify-content: center; + align-items: center; + align-content: flex-end; + gap: 2rem; + + img.birthday-banner { + max-height: 20rem; + max-width: 100vw; + margin-left: auto; + margin-right: auto; + aspect-ratio: 1; + flex-grow: 1; + } + p { + flex-grow: 4; + text-align: center; + color: $blue; + font-size: 2.5em; + padding-bottom: 2.5rem; + margin: 1em; + } + } + + div.k8s-birthday-override.revert-to-previous { + form { + display: block; + max-width: clamp(20rem, 30%, 100vw); + margin-left: auto; + padding-bottom: 0.5rem; + } + text-align: right; + label { + color: $blue; + padding-left: 1.2em; + padding-right: 1.2em; + text-decoration: underline; + font-size: 1.5rem; + } + input { + accent-color: $blue; + border-color: $blue; + visibility: hidden; + } + } + + div.k8s-birthday-override.revert-to-previous:has(input:not(:checked)) { + display: initial; + } + + &:has(input:checked) { + display: none; + } +} + +@media screen and (max-width: 900px) { + section.k8s-birthday-override > .k8s-birthday-wrapper { + flex-wrap: wrap; + } +} + +@media screen and (max-width: 900px) { + section.k8s-birthday-override > .k8s-birthday-wrapper { + gap: 0.2rem; + align-content: center; + p { + font-size: initial; + min-width: 80vw; + } + img.birthday-banner { + min-height: initial; + } + label { + font-size: 1.2rem; + } + } +} +@media screen and (max-aspect-ratio: 9/15) { + gap: 0.4rem; +} + +@media screen and (min-width: 1281px) { + img.birthday-banner { + min-height: clamp(480px, 25rem, 100vh); + } +} +section.k8s-birthday-override:has(div.k8s-birthday-override.revert-to-previous input:not(:checked)) + section { + display: none; + visibility: hidden; } \ No newline at end of file diff --git a/assets/scss/_desktop.scss b/assets/scss/_desktop.scss index abff764d2ff65..101faca5afb7f 100644 --- a/assets/scss/_desktop.scss +++ b/assets/scss/_desktop.scss @@ -23,7 +23,7 @@ $video-section-height: 550px; } } - #oceanNodes { + #oceanNodes, .td-home .k8s-overview { .main-section { position: relative; diff --git a/assets/scss/_tablet.scss b/assets/scss/_tablet.scss index 58149a7dc2eba..03d18bd910627 100644 --- a/assets/scss/_tablet.scss +++ b/assets/scss/_tablet.scss @@ -66,7 +66,7 @@ $feature-box-div-width: 45%; } } - #oceanNodes { + #oceanNodes, .td-home .k8s-overview { h3 { text-align: left; margin-bottom: 18px; diff --git a/content/de/docs/concepts/architecture/cgroups.md b/content/de/docs/concepts/architecture/cgroups.md index 41158f908e247..da420d4bd44d4 100644 --- a/content/de/docs/concepts/architecture/cgroups.md +++ b/content/de/docs/concepts/architecture/cgroups.md @@ -30,7 +30,7 @@ cgroup v2 bietet einige Verbesserungen gegenüber cgroup v1, zum Beispiel folgen - Einheitliche Erfassung für verschiedene Arten der Speicherzuteilung (Netzwerkspeicher, Kernelspeicher, usw.) - Erfassung nicht-unmittelbarer Ressourcenänderungen wie "page cache write backs" -Manche Kubernetes Funktionen verwenden ausschließlich cgroup v2 für erweitertes Ressourcenmanagement und Isolierung. Die [MemoryQoS](/blog/2021/11/26/qos-memory-resources/) Funktion, zum Beispiel, verbessert Speicher QoS und setzt dabei auf cgroup v2 Primitives. +Manche Kubernetes Funktionen verwenden ausschließlich cgroup v2 für erweitertes Ressourcenmanagement und Isolierung. Die [MemoryQoS](/docs/concepts/workloads/pods/pod-qos/#memory-qos-with-cgroup-v2) Funktion, zum Beispiel, verbessert Speicher QoS und setzt dabei auf cgroup v2 Primitives. ## cgroup v2 verwenden {#cgroupv2-verwenden} diff --git a/content/en/_index.html b/content/en/_index.html index 55575df2012e9..16ca5813c6de4 100644 --- a/content/en/_index.html +++ b/content/en/_index.html @@ -8,8 +8,9 @@ {{< site-searchbar >}} -{{< blocks/section id="oceanNodes" >}} -{{% blocks/feature image="flower" %}} + +{{< blocks/section class="k8s-overview" >}} +{{% blocks/feature image="flower" id="feature-primary" %}} [Kubernetes]({{< relref "/docs/concepts/overview/" >}}), also known as K8s, is an open source system for automating deployment, scaling, and management of containerized applications. It groups containers that make up an application into logical units for easy management and discovery. Kubernetes builds upon [15 years of experience of running production workloads at Google](http://queue.acm.org/detail.cfm?id=2898444), combined with best-of-breed ideas and practices from the community. diff --git a/content/en/blog/_posts/2015-04-00-Kubernetes-Release-0150.md b/content/en/blog/_posts/2015-04-00-Kubernetes-Release-0150.md index 0373053fa0026..207cfc18880ea 100644 --- a/content/en/blog/_posts/2015-04-00-Kubernetes-Release-0150.md +++ b/content/en/blog/_posts/2015-04-00-Kubernetes-Release-0150.md @@ -48,37 +48,37 @@ Release Notes: To download, please visit https://github.com/GoogleCloudPlatform/kubernetes/releases/tag/v0.15.0 -[1]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6098 "Enabling v1beta3 api version by default in master" -[2]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6182 "Implement multi-port Services" -[3]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6505 "Docker multi-node" -[4]: https://github.com/GoogleCloudPlatform/kubernetes/pull/5442 "Getting started guide for Mesos on Google Cloud Platform" -[5]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6237 "example ansible setup repo" -[6]: https://github.com/GoogleCloudPlatform/kubernetes/pull/5270 "Controller framework" -[7]: https://github.com/GoogleCloudPlatform/kubernetes/pull/5473 "Add DeltaFIFO (a controller framework piece)" -[8]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6380 "Configure the kubelet to use HTTPS (take 2)" -[9]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6338 "Return a typed error for config validation, and make errors simple" -[10]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6190 "Add client cert authentication" -[11]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6207 "Add a limit to the number of in-flight requests that a server processes." -[12]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6355 "Added rate limiting to pod deleting" -[13]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6150 "Implement Balanced Resource Allocation (BRA) algorithm as a PriorityFunction in scheduler package." -[14]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6396 "Enable log collection from master." -[15]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6497 "Pod log subresource" -[16]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6368 "Add basic latency metrics to scheduler." -[17]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6409 "Add latency metrics to REST client" -[18]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6221 "Run etcd 2.0.5 in a pod" -[19]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6334 "Add an nginx docker image for use on the master." -[20]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6326 "Create Docker images for master components " -[21]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6270 "Updates for gcloud 0.9.54" -[22]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6011 "Fix AWS region vs zone" -[23]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6091 "Record event when image GC fails." -[24]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6203 "Add a QPS limiter to the kubernetes client." -[25]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6196 "Parallelize architectures in both the building and packaging phases of `make release`" -[26]: https://github.com/GoogleCloudPlatform/kubernetes/pull/5506 "add iscsi volume plugin" -[27]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6174 "implement glusterfs volume plugin" -[28]: https://github.com/GoogleCloudPlatform/kubernetes/pull/5138 "AWS EBS volume support" -[29]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6331 "Update heapster version to v0.10.0" -[30]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6544 "Build etcd image (version 2.0.9), and upgrade kubernetes cluster to the new version" -[31]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6426 "Update Kibana to v1.2 which paramaterizes location of Elasticsearch" -[32]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6123 "Fix bug in kube-proxy of not updating iptables rules if a service's public IPs change" -[33]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6200 "Retry kube-addons creation if kube-addons creation fails." -[34]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6727 "pkg/proxy: panic if run out of fd" +[1]: https://github.com/kubernetes/kubernetes/pull/6098 "Enabling v1beta3 api version by default in master" +[2]: https://github.com/kubernetes/kubernetes/pull/6182 "Implement multi-port Services" +[3]: https://github.com/kubernetes/kubernetes/pull/6505 "Docker multi-node" +[4]: https://github.com/kubernetes/kubernetes/pull/5442 "Getting started guide for Mesos on Google Cloud Platform" +[5]: https://github.com/kubernetes/kubernetes/pull/6237 "example ansible setup repo" +[6]: https://github.com/kubernetes/kubernetes/pull/5270 "Controller framework" +[7]: https://github.com/kubernetes/kubernetes/pull/5473 "Add DeltaFIFO (a controller framework piece)" +[8]: https://github.com/kubernetes/kubernetes/pull/6380 "Configure the kubelet to use HTTPS (take 2)" +[9]: https://github.com/kubernetes/kubernetes/pull/6338 "Return a typed error for config validation, and make errors simple" +[10]: https://github.com/kubernetes/kubernetes/pull/6190 "Add client cert authentication" +[11]: https://github.com/kubernetes/kubernetes/pull/6207 "Add a limit to the number of in-flight requests that a server processes." +[12]: https://github.com/kubernetes/kubernetes/pull/6355 "Added rate limiting to pod deleting" +[13]: https://github.com/kubernetes/kubernetes/pull/6150 "Implement Balanced Resource Allocation (BRA) algorithm as a PriorityFunction in scheduler package." +[14]: https://github.com/kubernetes/kubernetes/pull/6396 "Enable log collection from master." +[15]: https://github.com/kubernetes/kubernetes/pull/6497 "Pod log subresource" +[16]: https://github.com/kubernetes/kubernetes/pull/6368 "Add basic latency metrics to scheduler." +[17]: https://github.com/kubernetes/kubernetes/pull/6409 "Add latency metrics to REST client" +[18]: https://github.com/kubernetes/kubernetes/pull/6221 "Run etcd 2.0.5 in a pod" +[19]: https://github.com/kubernetes/kubernetes/pull/6334 "Add an nginx docker image for use on the master." +[20]: https://github.com/kubernetes/kubernetes/pull/6326 "Create Docker images for master components " +[21]: https://github.com/kubernetes/kubernetes/pull/6270 "Updates for gcloud 0.9.54" +[22]: https://github.com/kubernetes/kubernetes/pull/6011 "Fix AWS region vs zone" +[23]: https://github.com/kubernetes/kubernetes/pull/6091 "Record event when image GC fails." +[24]: https://github.com/kubernetes/kubernetes/pull/6203 "Add a QPS limiter to the kubernetes client." +[25]: https://github.com/kubernetes/kubernetes/pull/6196 "Parallelize architectures in both the building and packaging phases of `make release`" +[26]: https://github.com/kubernetes/kubernetes/pull/5506 "add iscsi volume plugin" +[27]: https://github.com/kubernetes/kubernetes/pull/6174 "implement glusterfs volume plugin" +[28]: https://github.com/kubernetes/kubernetes/pull/5138 "AWS EBS volume support" +[29]: https://github.com/kubernetes/kubernetes/pull/6331 "Update heapster version to v0.10.0" +[30]: https://github.com/kubernetes/kubernetes/pull/6544 "Build etcd image (version 2.0.9), and upgrade kubernetes cluster to the new version" +[31]: https://github.com/kubernetes/kubernetes/pull/6426 "Update Kibana to v1.2 which paramaterizes location of Elasticsearch" +[32]: https://github.com/kubernetes/kubernetes/pull/6123 "Fix bug in kube-proxy of not updating iptables rules if a service's public IPs change" +[33]: https://github.com/kubernetes/kubernetes/pull/6200 "Retry kube-addons creation if kube-addons creation fails." +[34]: https://github.com/kubernetes/kubernetes/pull/6727 "pkg/proxy: panic if run out of fd" diff --git a/content/en/blog/_posts/2015-05-00-Kubernetes-Release-0170.md b/content/en/blog/_posts/2015-05-00-Kubernetes-Release-0170.md index 0859edc059d94..ad6fd5f1b4710 100644 --- a/content/en/blog/_posts/2015-05-00-Kubernetes-Release-0170.md +++ b/content/en/blog/_posts/2015-05-00-Kubernetes-Release-0170.md @@ -311,310 +311,306 @@ Release Notes: To download, please visit https://github.com/GoogleCloudPlatform/kubernetes/releases/tag/v0.17.0 - -Simple theme. Powered by [Blogger][385]. - -[ ![][327] ][386] + [1]: http://kubernetes.io/images/nav_logo.svg [2]: http://kubernetes.io/docs/ [3]: https://kubernetes.io/blog/ -[4]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8065 "Remove old salt configs" -[5]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8069 "Kubelet: minor cleanups" -[6]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7940 "update example/walkthrough to v1beta3" -[7]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7946 "update example/rethinkdb to v1beta3" -[8]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7917 "verify the v1beta3 yaml files all work; merge the yaml files" -[9]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7258 "update examples/cassandra to api v1beta3" -[10]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7899 "update service.json in persistent-volume example to v1beta3" -[11]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7864 "update mysql-wordpress example to use v1beta3 API" -[12]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7848 "Update examples/meteor to use API v1beta3" -[13]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7872 "update node-selector example to API v1beta3" -[14]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7824 "update logging-demo to use API v1beta3; modify the way to access Elasticsearch and Kibana services" -[15]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7619 "Convert the skydns rc to use v1beta3 and add a health check to it" -[16]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7728 "update the hazelcast example to API version v1beta3" -[17]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7515 "Fix YAML parsing for v1beta3 objects in the kubelet for file/http" -[18]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7502 "Updated kubectl cluster-info to show v1beta3 addresses" -[19]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7980 "kubelet: Fix racy kubelet tests." -[20]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8079 "kubelet/container: Move prober.ContainerCommandRunner to container." -[21]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6127 "Kubelet: set host field in the pending pod status" -[22]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6442 "Fix the kubelet node watch" -[23]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6607 "Kubelet: recreate mirror pod if the static pod changes" -[24]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7749 "Kubelet: record the timestamp correctly in the runtime cache" -[25]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7729 "Kubelet: wait until container runtime is up" -[26]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7674 "Kubelet: replace DockerManager with the Runtime interface" -[27]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7301 "Kubelet: filter out terminated pods in SyncPods" -[28]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7048 "Kubelet: parallelize cleaning up containers in unwanted pods" -[29]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7952 "kubelet: Add container runtime option for rkt." -[30]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7916 "kubelet/rkt: Remove build label." -[31]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7327 "kubelet/metrics: Move instrumented_docker.go to dockertools." -[32]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7599 "kubelet/rkt: Add GetPods() for rkt." -[33]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7605 "kubelet/rkt: Add KillPod() and GetPodStatus() for rkt." -[34]: https://github.com/GoogleCloudPlatform/kubernetes/pull/4755 "pkg/kubelet: Fix logging." -[35]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6491 "kubelet: Refactor RunInContainer/ExecInContainer/PortForward." -[36]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6609 "kubelet/DockerManager: Fix returning empty error from GetPodStatus()." -[37]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6634 "kubelet: Move pod infra container image setting to dockertools." -[38]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6653 "kubelet/fake_docker_client: Use self's PID instead of 42 in testing." -[39]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6778 "kubelet/dockertool: Move Getpods() to DockerManager." -[40]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6776 "kubelet/dockertools: Add puller interfaces in the containerManager." -[41]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6608 "kubelet: Introduce PodInfraContainerChanged()." -[42]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6795 "kubelet/container: Replace DockerCache with RuntimeCache." -[43]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6844 "kubelet: Clean up computePodContainerChanges." -[44]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7009 "kubelet: Refactor prober." -[45]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7466 "kubelet/container: Update the runtime interface." -[46]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7477 "kubelet: Refactor isPodRunning() in runonce.go" -[47]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7465 "kubelet/rkt: Add basic rkt runtime routines." -[48]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7555 "kubelet/rkt: Add podInfo." -[49]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7488 "kubelet/container: Add GetContainerLogs to runtime interface." -[50]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7543 "kubelet/rkt: Add routines for converting kubelet pod to rkt pod." -[51]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7589 "kubelet/rkt: Add RunPod() for rkt." -[52]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7553 "kubelet/rkt: Add RunInContainer()/ExecInContainer()/PortForward()." -[53]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7613 "kubelet/container: Move ShouldContainerBeRestarted() to runtime." -[54]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7611 "kubelet/rkt: Add SyncPod() to rkt." -[55]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6794 "Kubelet: persist restart count of a container" -[56]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7951 "kubelet/container: Move pty*.go to container runtime package." -[57]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7900 "kubelet: Add container runtime option for rkt." -[58]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7803 "kubelet/rkt: Add docker prefix to image string." -[59]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7849 "kubelet/rkt: Inject dependencies to rkt." -[60]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7859 "kubelet/rkt: Remove dependencies on rkt.store" -[61]: https://github.com/GoogleCloudPlatform/kubernetes/pull/2387 "Kubelet talks securely to apiserver" -[62]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7592 "Rename EnvVarSource.FieldPath -> FieldRef and add example" -[63]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7741 "Add containerized option to kubelet binary" -[64]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7948 "Ease building kubelet image" -[65]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7854 "Remove unnecessary bind-mount from dockerized kubelet run" -[66]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7798 "Add ability to dockerize kubelet in local cluster" -[67]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7797 "Create docker image for kubelet" -[68]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7343 "Security context - types, kubelet, admission" -[69]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7743 "Kubelet: Add rkt as a runtime option" -[70]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7746 "Fix kubelet's docker RunInContainer implementation " -[71]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8018 "AWS: Don't try to copy gce_keys in jenkins e2e job" -[72]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7992 "AWS: Copy some new properties from config-default => config.test" -[73]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7928 "AWS: make it possible to disable minion public ip assignment" -[74]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7667 "update AWS CloudFormation template and cloud-configs" -[75]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7736 "AWS: Fix variable naming that meant not all tokens were written" -[76]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7678 "AWS: Change apiserver to listen on 443 directly, not through nginx" -[77]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6606 "AWS: Improving getting existing VPC and subnet" -[78]: https://github.com/GoogleCloudPlatform/kubernetes/pull/5138 "AWS EBS volume support" -[79]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8089 "Introduce an 'svc' segment for DNS search" -[80]: https://github.com/GoogleCloudPlatform/kubernetes/pull/5707 "Adds ability to define a prefix for etcd paths" -[81]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7973 "Add kubectl log --previous support to view last terminated container log" -[82]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8083 "Add a flag to disable legacy APIs" -[83]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7971 "make the dockerkeyring handle mutiple matching credentials" -[84]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8078 "Convert Fluentd to Cloud Logging pod specs to YAML" -[85]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7704 "Use etcd to allocate PortalIPs instead of in-mem" -[86]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8064 "eliminate auth-path" -[87]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7981 "Record failure reasons for image pulling" -[88]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7869 "Rate limit replica creation" -[89]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7995 "Upgrade to Kibana 4 for cluster logging" -[90]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8049 "Added name to kube-dns service" -[91]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7919 "Fix validation by moving it into the resource builder." -[92]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8050 "Add cache with multiple shards to decrease lock contention" -[93]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8039 "Delete status from displayable resources" -[94]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8044 "Refactor volume interfaces to receive pod instead of ObjectReference" -[95]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7565 "fix kube-down for provider gke" -[96]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7786 "Service port names are required for multi-port" -[97]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8051 "Increase disk size for kubernetes master." -[98]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7774 "expose: Load input object for increased safety" -[99]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7896 "Improments to conversion methods generator" -[100]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7557 "Added displaying external IPs to kubectl cluster-info" -[101]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8037 "Add missing Errorf formatting directives" -[102]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7567 "WIP: Add startup code to apiserver to migrate etcd keys" -[103]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8021 "Use error type from docker go-client instead of string" -[104]: https://github.com/GoogleCloudPlatform/kubernetes/pull/8024 "Accurately get hardware cpu count in Vagrantfile." -[105]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7921 "Stop setting a GKE specific version of the kubeconfig file" -[106]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7950 "Make the API server deal with HEAD requests via the service proxy" -[107]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7983 "GlusterFS Critical Bug Resolved - Removing warning in README" -[108]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7967 "Don't use the first token `uname -n` as the hostname" -[109]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7982 "Call kube-down in test-teardown for vagrant." -[110]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6235 "defaults_tests: verify defaults when converting to an API object" -[111]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7910 "Use the full hostname for mirror pod name." -[112]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7657 "Removes RunPod in the Runtime interface" -[113]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7533 "Clean up dockertools/manager.go and add more unit tests" -[114]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7525 "Adapt pod killing and cleanup for generic container runtime" -[115]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7198 "Fix pod filtering in replication controller" -[116]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7116 "Print container statuses in `kubectl get pods`" -[117]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6992 "Prioritize deleting the non-running pods when reducing replicas" -[118]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6872 "Fix locking issue in pod manager" -[119]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6655 "Limit the number of concurrent tests in integration.go" -[120]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7931 "Fix typos in different config comments" -[121]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7929 "Update cAdvisor dependency." -[122]: https://github.com/GoogleCloudPlatform/kubernetes/pull/5498 "Ubuntu-distro: deprecate & merge ubuntu single node work to ubuntu cluster node stuff" -[123]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7935 "Add control variables to Jenkins E2E script" -[124]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7932 "Check node status as part of validate-cluster.sh." -[125]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7821 "Add old endpoint cleanup function" -[126]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7620 "Support recovery from in the middle of a rename." -[127]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7715 "Update Exec and Portforward client to use pod subresource" -[128]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7564 "Added NFS to PV structs" -[129]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7904 "Fix environment variable error in Vagrant docs" -[130]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7616 "Adds a simple release-note builder that scrapes the GitHub API for recent PRs" -[131]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7668 "Scheduler ignores nodes that are in a bad state" -[132]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7863 "Set GOMAXPROCS for etcd" -[133]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7556 "Auto-generated conversion methods calling one another" -[134]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7445 "Bring up a kuberenetes cluster using coreos image as worker nodes" -[135]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7410 "Godep: Add godep for rkt." -[136]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7870 "Add volumeGetter to rkt." -[137]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7897 "Update cAdvisor dependency." -[138]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7822 "DNS: expose 53/TCP" -[139]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7763 "Set NodeReady=False when docker is dead" -[140]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7857 "Ignore latency metrics for events" -[141]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7792 "SecurityContext admission clean up" -[142]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7832 "Support manually-created and generated conversion functions" -[143]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7833 "Add latency metrics for etcd operations" -[144]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7885 "Update errors_test.go" -[145]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7861 "Change signature of container runtime PullImage to allow pull w/ secret" -[146]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7873 "Fix bug in Service documentation: incorrect location of "selector" in JSON" -[147]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7876 "Fix controller-manager manifest for providers that don't specify CLUSTER_IP_RANGE" -[148]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7867 "Fix controller unittests" -[149]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7751 "Enable GCM and GCL instead of InfluxDB on GCE" -[150]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7862 "Remove restriction that cluster-cidr be a class-b" -[151]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7591 "Fix OpenShift example" -[152]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7718 "API Server - pass path name in context of create request for subresource" -[153]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7575 "Rolling Updates: Add support for --rollback." -[154]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7820 "Update to container-vm-v20150505 (Also updates GCE to Docker 1.6)" -[155]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7830 "Fix metric label" -[156]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7838 "Fix v1beta1 typos in v1beta2 conversions" -[157]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7764 "skydns: use the etcd-2.x native syntax, enable IANA attributed ports." -[158]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7794 "Added port 6443 to kube-proxy default IP address for api-server" -[159]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7834 "Added client header info for authentication doc." -[160]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7827 "Clean up safe_format_and_mount spam in the startup logs" -[161]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7829 "Set allocate_node_cidrs to be blank by default." -[162]: https://github.com/GoogleCloudPlatform/kubernetes/pull/5246 "Make nodecontroller configure nodes' pod IP ranges" -[163]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7799 "Fix sync problems in #5246" -[164]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7823 "Fix event doc link" -[165]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7776 "Cobra update and bash completions fix" -[166]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7675 "Fix kube2sky flakes. Fix tools.GetEtcdVersion to work with etcd > 2.0.7" -[167]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7154 "Change kube2sky to use token-system-dns secret, point at https endpoint ..." -[168]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7468 "replica: serialize created-by reference" -[169]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7702 "Inject mounter into volume plugins" -[170]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6973 "bringing CoreOS cloud-configs up-to-date (against 0.15.x and latest OS' alpha) " -[171]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7787 "Update kubeconfig-file doc." -[172]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7780 "Throw an API error when deleting namespace in termination" -[173]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7773 "Fix command field PodExecOptions" -[174]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7785 "Start ImageManager housekeeping in Run()." -[175]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7769 "fix DeepCopy to properly support runtime.EmbeddedObject" -[176]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7273 "fix master service endpoint system for multiple masters" -[177]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7757 "Add genbashcomp to KUBE_TEST_TARGETS" -[178]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7669 "Change the cloud provider TCPLoadBalancerExists function to GetTCPLoadBalancer..." -[179]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7772 "Add containerized option to kubelet binary" -[180]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7779 "Fix swagger spec" -[181]: https://github.com/GoogleCloudPlatform/kubernetes/issues/7750 "Hyperkube image requires root certificates to work with cloud-providers (at least AWS)" -[182]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7755 "FIX: Issue #7750 - Hyperkube docker image needs certificates to connect to cloud-providers" -[183]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7752 "Add build labels to rkt" -[184]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7672 "Check license boilerplate for python files" -[185]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7705 "Reliable updates in rollingupdate" -[186]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7650 "Don't exit abruptly if there aren't yet any minions right after the cluster is created." -[187]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7742 "Make changes suggested in #7675" -[188]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7357 "A guide to set up kubernetes multiple nodes cluster with flannel on fedora" -[189]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7760 "Setup generators in factory" -[190]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7737 "Reduce usage of time.After" -[191]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7735 "Remove node status from "componentstatuses" call." -[192]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7614 "React to failure by growing the remaining clusters" -[193]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7725 "Fix typo in runtime_cache.go" -[194]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7740 "Update non-GCE Salt distros to 1.6.0, fallback to ContainerVM Docker version on GCE" -[195]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7744 "Skip SaltStack install if it's already installed" -[196]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7712 "Expose pod name as a label on containers." -[197]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7732 "Log which SSH key is used in e2e SSH test" -[198]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7649 "Add a central simple getting started guide with kubernetes guide." -[199]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7443 "Explicitly state the lack of support for 'Requests' for the purposes of scheduling" -[200]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7721 "Select IPv4-only from host interfaces" -[201]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7723 "Metrics tests can't run on Mac" -[202]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7727 "Add step to API changes doc for swagger regen" -[203]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7703 "Add NsenterMounter mount implementation" -[204]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7509 "add StringSet.HasAny" -[205]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6941 "Add an integration test that checks for the metrics we expect to be exported from the master" -[206]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7722 "Minor bash update found by shellcheck.net" -[207]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7536 "Add --hostport to run-container." -[208]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7659 "Have rkt implement the container Runtime interface" -[209]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7629 "Change the order the different versions of API are registered " -[210]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7699 "expose: Create objects in a generic way" -[211]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7643 "Requeue rc if a single get/put retry on status.Replicas fails" -[212]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7316 "logs for master components" -[213]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7522 "cloudproviders: add ovirt getting started guide" -[214]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7671 "Make rkt-install a oneshot." -[215]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7665 "Provide container_runtime flag to Kubelet in CoreOS." -[216]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7654 "Boilerplate speedup" -[217]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7700 "Log host for failed pod in Density test" -[218]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7655 "Removes spurious quotation mark" -[219]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7694 "Add kubectl_label to custom functions in bash completion" -[220]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7696 "Enable profiling in kube-controller" -[221]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7690 "Set vagrant test cluster default NUM_MINIONS=2" -[222]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7695 "Add metrics to measure cache hit ratio" -[223]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7662 "Change IP to IP(S) in service columns for kubectl get" -[224]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7076 "annotate required flags for bash_completions" -[225]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7685 "(minor) Add pgrep debugging to etcd error" -[226]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7676 "Fixed nil pointer issue in describe when volume is unbound" -[227]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7691 "Removed unnecessary closing bracket" -[228]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7432 "Added TerminationGracePeriod field to PodSpec and grace-period flag to kubectl stop" -[229]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7689 "Fix boilerplate in test/e2e/scale.go" -[230]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7628 "Update expiration timeout based on observed latencies" -[231]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7644 "Output generated conversion functions/names" -[232]: https://github.com/GoogleCloudPlatform/kubernetes/issues/7645 "Move the scale tests into a separate file" -[233]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7646 "Moved the Scale tests into a scale file. #7645" -[234]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7609 "Truncate GCE load balancer names to 63 chars" -[235]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7603 "Add SyncPod() and remove Kill/Run InContainer()." -[236]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7663 "Merge release 0.16 to master" -[237]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7637 "Update license boilerplate for examples/rethinkdb" -[238]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7268 "First part of improved rolling update, allow dynamic next replication controller generation." -[239]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7638 "Add license boilerplate to examples/phabricator" -[240]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7597 "Use generic copyright holder name in license boilerplate" -[241]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7633 "Retry incrementing quota if there is a conflict" -[242]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7568 "Remove GetContainers from Runtime interface" -[243]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7578 "Add image-related methods to DockerManager" -[244]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7586 "Remove more docker references in kubelet" -[245]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7601 "Add KillContainerInPod in DockerManager" -[246]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7652 "Kubelet: Add container runtime option." -[247]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7626 "bump heapster to v0.11.0 and grafana to v0.7.0" -[248]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7593 "Build github.com/onsi/ginkgo/ginkgo as a part of the release" -[249]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7490 "Do not automatically decode runtime.RawExtension" -[250]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7500 "Update changelog." -[251]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7610 "Add SyncPod() to DockerManager and use it in Kubelet" -[252]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7602 "Build: Push .md5 and .sha1 files for every file we push to GCS" -[253]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7540 "Fix rolling update --image " -[254]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7636 "Update license boilerplate for docs/man/md2man-all.sh" -[255]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7632 "Include shell license boilerplate in examples/k8petstore" -[256]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7277 "Add --cgroup_parent flag to Kubelet to set the parent cgroup for pods" -[257]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7209 "change the current dir to the config dir" -[258]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7158 "Set Weave To 0.9.0 And Update Etcd Configuration For Azure" -[259]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7467 "Augment describe to search for matching things if it doesn't match the original resource." -[260]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7559 "Add a simple cache for objects stored in etcd." -[261]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7549 "Rkt gc" -[262]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7550 "Rkt pull" -[263]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6400 "Implement Mount interface using mount(8) and umount(8)" -[264]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7588 "Trim Fleuntd tag for Cloud Logging" -[265]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7569 "GCE CoreOS cluster - set master name based on variable" -[266]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7535 "Capitalization of KubeProxyVersion wrong in JSON" -[267]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7530 "Make nodes report their external IP rather than the master's." -[268]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7539 "Trim cluster log tags to pod name and container name" -[269]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7541 "Handle conversion of boolean query parameters with a value of "false"" -[270]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7532 "Add image-related methods to Runtime interface." -[271]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7560 "Test whether auto-generated conversions weren't manually edited" -[272]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7484 "Mention :latest behavior for image version tag" -[273]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7487 "readinessProbe calls livenessProbe.Exec.Command which cause "invalid memory address or nil pointer dereference"." -[274]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7520 "Add RuntimeHooks to abstract Kubelet logic" -[275]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7546 "Expose URL() on Request to allow building URLs" -[276]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7288 "Add a simple cache for objects stored in etcd" -[277]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7431 "Prepare for chaining autogenerated conversion methods " -[278]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7353 "Increase maxIdleConnection limit when creating etcd client in apiserver." -[279]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7354 "Improvements to generator of conversion methods." -[280]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7107 "Code to automatically generate conversion methods" -[281]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7407 "Support recovery for anonymous roll outs" -[282]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7527 "Bump kube2sky to 1.2. Point it at https endpoint (3rd try)." -[283]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7526 "cluster/gce/coreos: Add metadata-service in node.yaml" -[284]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7480 "Move ComputePodChanges to the Docker runtime" -[285]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7510 "Cobra rebase" -[286]: https://github.com/GoogleCloudPlatform/kubernetes/pull/6718 "Adding system oom events from kubelet" -[287]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7479 "Move Prober to its own subpackage" -[288]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7513 "Fix parallel-e2e.sh to work on my macbook (bash v3.2)" -[289]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7449 "Move network plugin TearDown to DockerManager" -[290]: https://github.com/GoogleCloudPlatform/kubernetes/issues/7498 "CoreOS Getting Started Guide not working" -[291]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7499 "Fixes #7498 - CoreOS Getting Started Guide had invalid cloud config" -[292]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7504 "Fix invalid character '"' after object key:value pair" -[293]: https://github.com/GoogleCloudPlatform/kubernetes/issues/7317 "GlusterFS Volume Plugin deletes the contents of the mounted volume upon Pod deletion" -[294]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7503 "Fixed kubelet deleting data from volumes on stop (#7317)." -[295]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7482 "Fixing hooks/description to catch API fields without description tags" -[296]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7457 "cadvisor is obsoleted so kubelet service does not require it." -[297]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7408 "Set the default namespace for events to be "default"" -[298]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7446 "Fix typo in namespace conversion" -[299]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7419 "Convert Secret registry to use update/create strategy, allow filtering by Type" -[300]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7102 "Use pod namespace when looking for its GlusterFS endpoints." -[301]: https://github.com/GoogleCloudPlatform/kubernetes/pull/7427 "Fixed name of kube-proxy path in deployment scripts." -[ +[4]: https://github.com/kubernetes/kubernetes/pull/8065 "Remove old salt configs" +[5]: https://github.com/kubernetes/kubernetes/pull/8069 "Kubelet: minor cleanups" +[6]: https://github.com/kubernetes/kubernetes/pull/7940 "update example/walkthrough to v1beta3" +[7]: https://github.com/kubernetes/kubernetes/pull/7946 "update example/rethinkdb to v1beta3" +[8]: https://github.com/kubernetes/kubernetes/pull/7917 "verify the v1beta3 yaml files all work; merge the yaml files" +[9]: https://github.com/kubernetes/kubernetes/pull/7258 "update examples/cassandra to api v1beta3" +[10]: https://github.com/kubernetes/kubernetes/pull/7899 "update service.json in persistent-volume example to v1beta3" +[11]: https://github.com/kubernetes/kubernetes/pull/7864 "update mysql-wordpress example to use v1beta3 API" +[12]: https://github.com/kubernetes/kubernetes/pull/7848 "Update examples/meteor to use API v1beta3" +[13]: https://github.com/kubernetes/kubernetes/pull/7872 "update node-selector example to API v1beta3" +[14]: https://github.com/kubernetes/kubernetes/pull/7824 "update logging-demo to use API v1beta3; modify the way to access Elasticsearch and Kibana services" +[15]: https://github.com/kubernetes/kubernetes/pull/7619 "Convert the skydns rc to use v1beta3 and add a health check to it" +[16]: https://github.com/kubernetes/kubernetes/pull/7728 "update the hazelcast example to API version v1beta3" +[17]: https://github.com/kubernetes/kubernetes/pull/7515 "Fix YAML parsing for v1beta3 objects in the kubelet for file/http" +[18]: https://github.com/kubernetes/kubernetes/pull/7502 "Updated kubectl cluster-info to show v1beta3 addresses" +[19]: https://github.com/kubernetes/kubernetes/pull/7980 "kubelet: Fix racy kubelet tests." +[20]: https://github.com/kubernetes/kubernetes/pull/8079 "kubelet/container: Move prober.ContainerCommandRunner to container." +[21]: https://github.com/kubernetes/kubernetes/pull/6127 "Kubelet: set host field in the pending pod status" +[22]: https://github.com/kubernetes/kubernetes/pull/6442 "Fix the kubelet node watch" +[23]: https://github.com/kubernetes/kubernetes/pull/6607 "Kubelet: recreate mirror pod if the static pod changes" +[24]: https://github.com/kubernetes/kubernetes/pull/7749 "Kubelet: record the timestamp correctly in the runtime cache" +[25]: https://github.com/kubernetes/kubernetes/pull/7729 "Kubelet: wait until container runtime is up" +[26]: https://github.com/kubernetes/kubernetes/pull/7674 "Kubelet: replace DockerManager with the Runtime interface" +[27]: https://github.com/kubernetes/kubernetes/pull/7301 "Kubelet: filter out terminated pods in SyncPods" +[28]: https://github.com/kubernetes/kubernetes/pull/7048 "Kubelet: parallelize cleaning up containers in unwanted pods" +[29]: https://github.com/kubernetes/kubernetes/pull/7952 "kubelet: Add container runtime option for rkt." +[30]: https://github.com/kubernetes/kubernetes/pull/7916 "kubelet/rkt: Remove build label." +[31]: https://github.com/kubernetes/kubernetes/pull/7327 "kubelet/metrics: Move instrumented_docker.go to dockertools." +[32]: https://github.com/kubernetes/kubernetes/pull/7599 "kubelet/rkt: Add GetPods() for rkt." +[33]: https://github.com/kubernetes/kubernetes/pull/7605 "kubelet/rkt: Add KillPod() and GetPodStatus() for rkt." +[34]: https://github.com/kubernetes/kubernetes/pull/4755 "pkg/kubelet: Fix logging." +[35]: https://github.com/kubernetes/kubernetes/pull/6491 "kubelet: Refactor RunInContainer/ExecInContainer/PortForward." +[36]: https://github.com/kubernetes/kubernetes/pull/6609 "kubelet/DockerManager: Fix returning empty error from GetPodStatus()." +[37]: https://github.com/kubernetes/kubernetes/pull/6634 "kubelet: Move pod infra container image setting to dockertools." +[38]: https://github.com/kubernetes/kubernetes/pull/6653 "kubelet/fake_docker_client: Use self's PID instead of 42 in testing." +[39]: https://github.com/kubernetes/kubernetes/pull/6778 "kubelet/dockertool: Move Getpods() to DockerManager." +[40]: https://github.com/kubernetes/kubernetes/pull/6776 "kubelet/dockertools: Add puller interfaces in the containerManager." +[41]: https://github.com/kubernetes/kubernetes/pull/6608 "kubelet: Introduce PodInfraContainerChanged()." +[42]: https://github.com/kubernetes/kubernetes/pull/6795 "kubelet/container: Replace DockerCache with RuntimeCache." +[43]: https://github.com/kubernetes/kubernetes/pull/6844 "kubelet: Clean up computePodContainerChanges." +[44]: https://github.com/kubernetes/kubernetes/pull/7009 "kubelet: Refactor prober." +[45]: https://github.com/kubernetes/kubernetes/pull/7466 "kubelet/container: Update the runtime interface." +[46]: https://github.com/kubernetes/kubernetes/pull/7477 "kubelet: Refactor isPodRunning() in runonce.go" +[47]: https://github.com/kubernetes/kubernetes/pull/7465 "kubelet/rkt: Add basic rkt runtime routines." +[48]: https://github.com/kubernetes/kubernetes/pull/7555 "kubelet/rkt: Add podInfo." +[49]: https://github.com/kubernetes/kubernetes/pull/7488 "kubelet/container: Add GetContainerLogs to runtime interface." +[50]: https://github.com/kubernetes/kubernetes/pull/7543 "kubelet/rkt: Add routines for converting kubelet pod to rkt pod." +[51]: https://github.com/kubernetes/kubernetes/pull/7589 "kubelet/rkt: Add RunPod() for rkt." +[52]: https://github.com/kubernetes/kubernetes/pull/7553 "kubelet/rkt: Add RunInContainer()/ExecInContainer()/PortForward()." +[53]: https://github.com/kubernetes/kubernetes/pull/7613 "kubelet/container: Move ShouldContainerBeRestarted() to runtime." +[54]: https://github.com/kubernetes/kubernetes/pull/7611 "kubelet/rkt: Add SyncPod() to rkt." +[55]: https://github.com/kubernetes/kubernetes/pull/6794 "Kubelet: persist restart count of a container" +[56]: https://github.com/kubernetes/kubernetes/pull/7951 "kubelet/container: Move pty*.go to container runtime package." +[57]: https://github.com/kubernetes/kubernetes/pull/7900 "kubelet: Add container runtime option for rkt." +[58]: https://github.com/kubernetes/kubernetes/pull/7803 "kubelet/rkt: Add docker prefix to image string." +[59]: https://github.com/kubernetes/kubernetes/pull/7849 "kubelet/rkt: Inject dependencies to rkt." +[60]: https://github.com/kubernetes/kubernetes/pull/7859 "kubelet/rkt: Remove dependencies on rkt.store" +[61]: https://github.com/kubernetes/kubernetes/pull/2387 "Kubelet talks securely to apiserver" +[62]: https://github.com/kubernetes/kubernetes/pull/7592 "Rename EnvVarSource.FieldPath -> FieldRef and add example" +[63]: https://github.com/kubernetes/kubernetes/pull/7741 "Add containerized option to kubelet binary" +[64]: https://github.com/kubernetes/kubernetes/pull/7948 "Ease building kubelet image" +[65]: https://github.com/kubernetes/kubernetes/pull/7854 "Remove unnecessary bind-mount from dockerized kubelet run" +[66]: https://github.com/kubernetes/kubernetes/pull/7798 "Add ability to dockerize kubelet in local cluster" +[67]: https://github.com/kubernetes/kubernetes/pull/7797 "Create docker image for kubelet" +[68]: https://github.com/kubernetes/kubernetes/pull/7343 "Security context - types, kubelet, admission" +[69]: https://github.com/kubernetes/kubernetes/pull/7743 "Kubelet: Add rkt as a runtime option" +[70]: https://github.com/kubernetes/kubernetes/pull/7746 "Fix kubelet's docker RunInContainer implementation " +[71]: https://github.com/kubernetes/kubernetes/pull/8018 "AWS: Don't try to copy gce_keys in jenkins e2e job" +[72]: https://github.com/kubernetes/kubernetes/pull/7992 "AWS: Copy some new properties from config-default => config.test" +[73]: https://github.com/kubernetes/kubernetes/pull/7928 "AWS: make it possible to disable minion public ip assignment" +[74]: https://github.com/kubernetes/kubernetes/pull/7667 "update AWS CloudFormation template and cloud-configs" +[75]: https://github.com/kubernetes/kubernetes/pull/7736 "AWS: Fix variable naming that meant not all tokens were written" +[76]: https://github.com/kubernetes/kubernetes/pull/7678 "AWS: Change apiserver to listen on 443 directly, not through nginx" +[77]: https://github.com/kubernetes/kubernetes/pull/6606 "AWS: Improving getting existing VPC and subnet" +[78]: https://github.com/kubernetes/kubernetes/pull/5138 "AWS EBS volume support" +[79]: https://github.com/kubernetes/kubernetes/pull/8089 "Introduce an 'svc' segment for DNS search" +[80]: https://github.com/kubernetes/kubernetes/pull/5707 "Adds ability to define a prefix for etcd paths" +[81]: https://github.com/kubernetes/kubernetes/pull/7973 "Add kubectl log --previous support to view last terminated container log" +[82]: https://github.com/kubernetes/kubernetes/pull/8083 "Add a flag to disable legacy APIs" +[83]: https://github.com/kubernetes/kubernetes/pull/7971 "make the dockerkeyring handle mutiple matching credentials" +[84]: https://github.com/kubernetes/kubernetes/pull/8078 "Convert Fluentd to Cloud Logging pod specs to YAML" +[85]: https://github.com/kubernetes/kubernetes/pull/7704 "Use etcd to allocate PortalIPs instead of in-mem" +[86]: https://github.com/kubernetes/kubernetes/pull/8064 "eliminate auth-path" +[87]: https://github.com/kubernetes/kubernetes/pull/7981 "Record failure reasons for image pulling" +[88]: https://github.com/kubernetes/kubernetes/pull/7869 "Rate limit replica creation" +[89]: https://github.com/kubernetes/kubernetes/pull/7995 "Upgrade to Kibana 4 for cluster logging" +[90]: https://github.com/kubernetes/kubernetes/pull/8049 "Added name to kube-dns service" +[91]: https://github.com/kubernetes/kubernetes/pull/7919 "Fix validation by moving it into the resource builder." +[92]: https://github.com/kubernetes/kubernetes/pull/8050 "Add cache with multiple shards to decrease lock contention" +[93]: https://github.com/kubernetes/kubernetes/pull/8039 "Delete status from displayable resources" +[94]: https://github.com/kubernetes/kubernetes/pull/8044 "Refactor volume interfaces to receive pod instead of ObjectReference" +[95]: https://github.com/kubernetes/kubernetes/pull/7565 "fix kube-down for provider gke" +[96]: https://github.com/kubernetes/kubernetes/pull/7786 "Service port names are required for multi-port" +[97]: https://github.com/kubernetes/kubernetes/pull/8051 "Increase disk size for kubernetes master." +[98]: https://github.com/kubernetes/kubernetes/pull/7774 "expose: Load input object for increased safety" +[99]: https://github.com/kubernetes/kubernetes/pull/7896 "Improments to conversion methods generator" +[100]: https://github.com/kubernetes/kubernetes/pull/7557 "Added displaying external IPs to kubectl cluster-info" +[101]: https://github.com/kubernetes/kubernetes/pull/8037 "Add missing Errorf formatting directives" +[102]: https://github.com/kubernetes/kubernetes/pull/7567 "WIP: Add startup code to apiserver to migrate etcd keys" +[103]: https://github.com/kubernetes/kubernetes/pull/8021 "Use error type from docker go-client instead of string" +[104]: https://github.com/kubernetes/kubernetes/pull/8024 "Accurately get hardware cpu count in Vagrantfile." +[105]: https://github.com/kubernetes/kubernetes/pull/7921 "Stop setting a GKE specific version of the kubeconfig file" +[106]: https://github.com/kubernetes/kubernetes/pull/7950 "Make the API server deal with HEAD requests via the service proxy" +[107]: https://github.com/kubernetes/kubernetes/pull/7983 "GlusterFS Critical Bug Resolved - Removing warning in README" +[108]: https://github.com/kubernetes/kubernetes/pull/7967 "Don't use the first token `uname -n` as the hostname" +[109]: https://github.com/kubernetes/kubernetes/pull/7982 "Call kube-down in test-teardown for vagrant." +[110]: https://github.com/kubernetes/kubernetes/pull/6235 "defaults_tests: verify defaults when converting to an API object" +[111]: https://github.com/kubernetes/kubernetes/pull/7910 "Use the full hostname for mirror pod name." +[112]: https://github.com/kubernetes/kubernetes/pull/7657 "Removes RunPod in the Runtime interface" +[113]: https://github.com/kubernetes/kubernetes/pull/7533 "Clean up dockertools/manager.go and add more unit tests" +[114]: https://github.com/kubernetes/kubernetes/pull/7525 "Adapt pod killing and cleanup for generic container runtime" +[115]: https://github.com/kubernetes/kubernetes/pull/7198 "Fix pod filtering in replication controller" +[116]: https://github.com/kubernetes/kubernetes/pull/7116 "Print container statuses in `kubectl get pods`" +[117]: https://github.com/kubernetes/kubernetes/pull/6992 "Prioritize deleting the non-running pods when reducing replicas" +[118]: https://github.com/kubernetes/kubernetes/pull/6872 "Fix locking issue in pod manager" +[119]: https://github.com/kubernetes/kubernetes/pull/6655 "Limit the number of concurrent tests in integration.go" +[120]: https://github.com/kubernetes/kubernetes/pull/7931 "Fix typos in different config comments" +[121]: https://github.com/kubernetes/kubernetes/pull/7929 "Update cAdvisor dependency." +[122]: https://github.com/kubernetes/kubernetes/pull/5498 "Ubuntu-distro: deprecate & merge ubuntu single node work to ubuntu cluster node stuff" +[123]: https://github.com/kubernetes/kubernetes/pull/7935 "Add control variables to Jenkins E2E script" +[124]: https://github.com/kubernetes/kubernetes/pull/7932 "Check node status as part of validate-cluster.sh." +[125]: https://github.com/kubernetes/kubernetes/pull/7821 "Add old endpoint cleanup function" +[126]: https://github.com/kubernetes/kubernetes/pull/7620 "Support recovery from in the middle of a rename." +[127]: https://github.com/kubernetes/kubernetes/pull/7715 "Update Exec and Portforward client to use pod subresource" +[128]: https://github.com/kubernetes/kubernetes/pull/7564 "Added NFS to PV structs" +[129]: https://github.com/kubernetes/kubernetes/pull/7904 "Fix environment variable error in Vagrant docs" +[130]: https://github.com/kubernetes/kubernetes/pull/7616 "Adds a simple release-note builder that scrapes the GitHub API for recent PRs" +[131]: https://github.com/kubernetes/kubernetes/pull/7668 "Scheduler ignores nodes that are in a bad state" +[132]: https://github.com/kubernetes/kubernetes/pull/7863 "Set GOMAXPROCS for etcd" +[133]: https://github.com/kubernetes/kubernetes/pull/7556 "Auto-generated conversion methods calling one another" +[134]: https://github.com/kubernetes/kubernetes/pull/7445 "Bring up a kuberenetes cluster using coreos image as worker nodes" +[135]: https://github.com/kubernetes/kubernetes/pull/7410 "Godep: Add godep for rkt." +[136]: https://github.com/kubernetes/kubernetes/pull/7870 "Add volumeGetter to rkt." +[137]: https://github.com/kubernetes/kubernetes/pull/7897 "Update cAdvisor dependency." +[138]: https://github.com/kubernetes/kubernetes/pull/7822 "DNS: expose 53/TCP" +[139]: https://github.com/kubernetes/kubernetes/pull/7763 "Set NodeReady=False when docker is dead" +[140]: https://github.com/kubernetes/kubernetes/pull/7857 "Ignore latency metrics for events" +[141]: https://github.com/kubernetes/kubernetes/pull/7792 "SecurityContext admission clean up" +[142]: https://github.com/kubernetes/kubernetes/pull/7832 "Support manually-created and generated conversion functions" +[143]: https://github.com/kubernetes/kubernetes/pull/7833 "Add latency metrics for etcd operations" +[144]: https://github.com/kubernetes/kubernetes/pull/7885 "Update errors_test.go" +[145]: https://github.com/kubernetes/kubernetes/pull/7861 "Change signature of container runtime PullImage to allow pull w/ secret" +[146]: https://github.com/kubernetes/kubernetes/pull/7873 "Fix bug in Service documentation: incorrect location of `selector` in JSON" +[147]: https://github.com/kubernetes/kubernetes/pull/7876 "Fix controller-manager manifest for providers that don't specify CLUSTER_IP_RANGE" +[148]: https://github.com/kubernetes/kubernetes/pull/7867 "Fix controller unittests" +[149]: https://github.com/kubernetes/kubernetes/pull/7751 "Enable GCM and GCL instead of InfluxDB on GCE" +[150]: https://github.com/kubernetes/kubernetes/pull/7862 "Remove restriction that cluster-cidr be a class-b" +[151]: https://github.com/kubernetes/kubernetes/pull/7591 "Fix OpenShift example" +[152]: https://github.com/kubernetes/kubernetes/pull/7718 "API Server - pass path name in context of create request for subresource" +[153]: https://github.com/kubernetes/kubernetes/pull/7575 "Rolling Updates: Add support for --rollback." +[154]: https://github.com/kubernetes/kubernetes/pull/7820 "Update to container-vm-v20150505 (Also updates GCE to Docker 1.6)" +[155]: https://github.com/kubernetes/kubernetes/pull/7830 "Fix metric label" +[156]: https://github.com/kubernetes/kubernetes/pull/7838 "Fix v1beta1 typos in v1beta2 conversions" +[157]: https://github.com/kubernetes/kubernetes/pull/7764 "skydns: use the etcd-2.x native syntax, enable IANA attributed ports." +[158]: https://github.com/kubernetes/kubernetes/pull/7794 "Added port 6443 to kube-proxy default IP address for api-server" +[159]: https://github.com/kubernetes/kubernetes/pull/7834 "Added client header info for authentication doc." +[160]: https://github.com/kubernetes/kubernetes/pull/7827 "Clean up safe_format_and_mount spam in the startup logs" +[161]: https://github.com/kubernetes/kubernetes/pull/7829 "Set allocate_node_cidrs to be blank by default." +[162]: https://github.com/kubernetes/kubernetes/pull/5246 "Make nodecontroller configure nodes' pod IP ranges" +[163]: https://github.com/kubernetes/kubernetes/pull/7799 "Fix sync problems in #5246" +[164]: https://github.com/kubernetes/kubernetes/pull/7823 "Fix event doc link" +[165]: https://github.com/kubernetes/kubernetes/pull/7776 "Cobra update and bash completions fix" +[166]: https://github.com/kubernetes/kubernetes/pull/7675 "Fix kube2sky flakes. Fix tools.GetEtcdVersion to work with etcd > 2.0.7" +[167]: https://github.com/kubernetes/kubernetes/pull/7154 "Change kube2sky to use token-system-dns secret, point at https endpoint ..." +[168]: https://github.com/kubernetes/kubernetes/pull/7468 "replica: serialize created-by reference" +[169]: https://github.com/kubernetes/kubernetes/pull/7702 "Inject mounter into volume plugins" +[170]: https://github.com/kubernetes/kubernetes/pull/6973 "bringing CoreOS cloud-configs up-to-date (against 0.15.x and latest OS' alpha) " +[171]: https://github.com/kubernetes/kubernetes/pull/7787 "Update kubeconfig-file doc." +[172]: https://github.com/kubernetes/kubernetes/pull/7780 "Throw an API error when deleting namespace in termination" +[173]: https://github.com/kubernetes/kubernetes/pull/7773 "Fix command field PodExecOptions" +[174]: https://github.com/kubernetes/kubernetes/pull/7785 "Start ImageManager housekeeping in Run()." +[175]: https://github.com/kubernetes/kubernetes/pull/7769 "fix DeepCopy to properly support runtime.EmbeddedObject" +[176]: https://github.com/kubernetes/kubernetes/pull/7273 "fix master service endpoint system for multiple masters" +[177]: https://github.com/kubernetes/kubernetes/pull/7757 "Add genbashcomp to KUBE_TEST_TARGETS" +[178]: https://github.com/kubernetes/kubernetes/pull/7669 "Change the cloud provider TCPLoadBalancerExists function to GetTCPLoadBalancer..." +[179]: https://github.com/kubernetes/kubernetes/pull/7772 "Add containerized option to kubelet binary" +[180]: https://github.com/kubernetes/kubernetes/pull/7779 "Fix swagger spec" +[181]: https://github.com/kubernetes/kubernetes/issues/7750 "Hyperkube image requires root certificates to work with cloud-providers (at least AWS)" +[182]: https://github.com/kubernetes/kubernetes/pull/7755 "FIX: Issue #7750 - Hyperkube docker image needs certificates to connect to cloud-providers" +[183]: https://github.com/kubernetes/kubernetes/pull/7752 "Add build labels to rkt" +[184]: https://github.com/kubernetes/kubernetes/pull/7672 "Check license boilerplate for python files" +[185]: https://github.com/kubernetes/kubernetes/pull/7705 "Reliable updates in rollingupdate" +[186]: https://github.com/kubernetes/kubernetes/pull/7650 "Don't exit abruptly if there aren't yet any minions right after the cluster is created." +[187]: https://github.com/kubernetes/kubernetes/pull/7742 "Make changes suggested in #7675" +[188]: https://github.com/kubernetes/kubernetes/pull/7357 "A guide to set up kubernetes multiple nodes cluster with flannel on fedora" +[189]: https://github.com/kubernetes/kubernetes/pull/7760 "Setup generators in factory" +[190]: https://github.com/kubernetes/kubernetes/pull/7737 "Reduce usage of time.After" +[191]: https://github.com/kubernetes/kubernetes/pull/7735 "Remove node status from `componentstatuses` call." +[192]: https://github.com/kubernetes/kubernetes/pull/7614 "React to failure by growing the remaining clusters" +[193]: https://github.com/kubernetes/kubernetes/pull/7725 "Fix typo in runtime_cache.go" +[194]: https://github.com/kubernetes/kubernetes/pull/7740 "Update non-GCE Salt distros to 1.6.0, fallback to ContainerVM Docker version on GCE" +[195]: https://github.com/kubernetes/kubernetes/pull/7744 "Skip SaltStack install if it's already installed" +[196]: https://github.com/kubernetes/kubernetes/pull/7712 "Expose pod name as a label on containers." +[197]: https://github.com/kubernetes/kubernetes/pull/7732 "Log which SSH key is used in e2e SSH test" +[198]: https://github.com/kubernetes/kubernetes/pull/7649 "Add a central simple getting started guide with kubernetes guide." +[199]: https://github.com/kubernetes/kubernetes/pull/7443 "Explicitly state the lack of support for 'Requests' for the purposes of scheduling" +[200]: https://github.com/kubernetes/kubernetes/pull/7721 "Select IPv4-only from host interfaces" +[201]: https://github.com/kubernetes/kubernetes/pull/7723 "Metrics tests can't run on Mac" +[202]: https://github.com/kubernetes/kubernetes/pull/7727 "Add step to API changes doc for swagger regen" +[203]: https://github.com/kubernetes/kubernetes/pull/7703 "Add NsenterMounter mount implementation" +[204]: https://github.com/kubernetes/kubernetes/pull/7509 "add StringSet.HasAny" +[205]: https://github.com/kubernetes/kubernetes/pull/6941 "Add an integration test that checks for the metrics we expect to be exported from the master" +[206]: https://github.com/kubernetes/kubernetes/pull/7722 "Minor bash update found by shellcheck.net" +[207]: https://github.com/kubernetes/kubernetes/pull/7536 "Add --hostport to run-container." +[208]: https://github.com/kubernetes/kubernetes/pull/7659 "Have rkt implement the container Runtime interface" +[209]: https://github.com/kubernetes/kubernetes/pull/7629 "Change the order the different versions of API are registered " +[210]: https://github.com/kubernetes/kubernetes/pull/7699 "expose: Create objects in a generic way" +[211]: https://github.com/kubernetes/kubernetes/pull/7643 "Requeue rc if a single get/put retry on status.Replicas fails" +[212]: https://github.com/kubernetes/kubernetes/pull/7316 "logs for master components" +[213]: https://github.com/kubernetes/kubernetes/pull/7522 "cloudproviders: add ovirt getting started guide" +[214]: https://github.com/kubernetes/kubernetes/pull/7671 "Make rkt-install a oneshot." +[215]: https://github.com/kubernetes/kubernetes/pull/7665 "Provide container_runtime flag to Kubelet in CoreOS." +[216]: https://github.com/kubernetes/kubernetes/pull/7654 "Boilerplate speedup" +[217]: https://github.com/kubernetes/kubernetes/pull/7700 "Log host for failed pod in Density test" +[218]: https://github.com/kubernetes/kubernetes/pull/7655 "Removes spurious quotation mark" +[219]: https://github.com/kubernetes/kubernetes/pull/7694 "Add kubectl_label to custom functions in bash completion" +[220]: https://github.com/kubernetes/kubernetes/pull/7696 "Enable profiling in kube-controller" +[221]: https://github.com/kubernetes/kubernetes/pull/7690 "Set vagrant test cluster default NUM_MINIONS=2" +[222]: https://github.com/kubernetes/kubernetes/pull/7695 "Add metrics to measure cache hit ratio" +[223]: https://github.com/kubernetes/kubernetes/pull/7662 "Change IP to IP(S) in service columns for kubectl get" +[224]: https://github.com/kubernetes/kubernetes/pull/7076 "annotate required flags for bash_completions" +[225]: https://github.com/kubernetes/kubernetes/pull/7685 "(minor) Add pgrep debugging to etcd error" +[226]: https://github.com/kubernetes/kubernetes/pull/7676 "Fixed nil pointer issue in describe when volume is unbound" +[227]: https://github.com/kubernetes/kubernetes/pull/7691 "Removed unnecessary closing bracket" +[228]: https://github.com/kubernetes/kubernetes/pull/7432 "Added TerminationGracePeriod field to PodSpec and grace-period flag to kubectl stop" +[229]: https://github.com/kubernetes/kubernetes/pull/7689 "Fix boilerplate in test/e2e/scale.go" +[230]: https://github.com/kubernetes/kubernetes/pull/7628 "Update expiration timeout based on observed latencies" +[231]: https://github.com/kubernetes/kubernetes/pull/7644 "Output generated conversion functions/names" +[232]: https://github.com/kubernetes/kubernetes/issues/7645 "Move the scale tests into a separate file" +[233]: https://github.com/kubernetes/kubernetes/pull/7646 "Moved the Scale tests into a scale file. #7645" +[234]: https://github.com/kubernetes/kubernetes/pull/7609 "Truncate GCE load balancer names to 63 chars" +[235]: https://github.com/kubernetes/kubernetes/pull/7603 "Add SyncPod() and remove Kill/Run InContainer()." +[236]: https://github.com/kubernetes/kubernetes/pull/7663 "Merge release 0.16 to master" +[237]: https://github.com/kubernetes/kubernetes/pull/7637 "Update license boilerplate for examples/rethinkdb" +[238]: https://github.com/kubernetes/kubernetes/pull/7268 "First part of improved rolling update, allow dynamic next replication controller generation." +[239]: https://github.com/kubernetes/kubernetes/pull/7638 "Add license boilerplate to examples/phabricator" +[240]: https://github.com/kubernetes/kubernetes/pull/7597 "Use generic copyright holder name in license boilerplate" +[241]: https://github.com/kubernetes/kubernetes/pull/7633 "Retry incrementing quota if there is a conflict" +[242]: https://github.com/kubernetes/kubernetes/pull/7568 "Remove GetContainers from Runtime interface" +[243]: https://github.com/kubernetes/kubernetes/pull/7578 "Add image-related methods to DockerManager" +[244]: https://github.com/kubernetes/kubernetes/pull/7586 "Remove more docker references in kubelet" +[245]: https://github.com/kubernetes/kubernetes/pull/7601 "Add KillContainerInPod in DockerManager" +[246]: https://github.com/kubernetes/kubernetes/pull/7652 "Kubelet: Add container runtime option." +[247]: https://github.com/kubernetes/kubernetes/pull/7626 "bump heapster to v0.11.0 and grafana to v0.7.0" +[248]: https://github.com/kubernetes/kubernetes/pull/7593 "Build github.com/onsi/ginkgo/ginkgo as a part of the release" +[249]: https://github.com/kubernetes/kubernetes/pull/7490 "Do not automatically decode runtime.RawExtension" +[250]: https://github.com/kubernetes/kubernetes/pull/7500 "Update changelog." +[251]: https://github.com/kubernetes/kubernetes/pull/7610 "Add SyncPod() to DockerManager and use it in Kubelet" +[252]: https://github.com/kubernetes/kubernetes/pull/7602 "Build: Push .md5 and .sha1 files for every file we push to GCS" +[253]: https://github.com/kubernetes/kubernetes/pull/7540 "Fix rolling update --image " +[254]: https://github.com/kubernetes/kubernetes/pull/7636 "Update license boilerplate for docs/man/md2man-all.sh" +[255]: https://github.com/kubernetes/kubernetes/pull/7632 "Include shell license boilerplate in examples/k8petstore" +[256]: https://github.com/kubernetes/kubernetes/pull/7277 "Add --cgroup_parent flag to Kubelet to set the parent cgroup for pods" +[257]: https://github.com/kubernetes/kubernetes/pull/7209 "change the current dir to the config dir" +[258]: https://github.com/kubernetes/kubernetes/pull/7158 "Set Weave To 0.9.0 And Update Etcd Configuration For Azure" +[259]: https://github.com/kubernetes/kubernetes/pull/7467 "Augment describe to search for matching things if it doesn't match the original resource." +[260]: https://github.com/kubernetes/kubernetes/pull/7559 "Add a simple cache for objects stored in etcd." +[261]: https://github.com/kubernetes/kubernetes/pull/7549 "Rkt gc" +[262]: https://github.com/kubernetes/kubernetes/pull/7550 "Rkt pull" +[263]: https://github.com/kubernetes/kubernetes/pull/6400 "Implement Mount interface using mount(8) and umount(8)" +[264]: https://github.com/kubernetes/kubernetes/pull/7588 "Trim Fleuntd tag for Cloud Logging" +[265]: https://github.com/kubernetes/kubernetes/pull/7569 "GCE CoreOS cluster - set master name based on variable" +[266]: https://github.com/kubernetes/kubernetes/pull/7535 "Capitalization of KubeProxyVersion wrong in JSON" +[267]: https://github.com/kubernetes/kubernetes/pull/7530 "Make nodes report their external IP rather than the master's." +[268]: https://github.com/kubernetes/kubernetes/pull/7539 "Trim cluster log tags to pod name and container name" +[269]: https://github.com/kubernetes/kubernetes/pull/7541 "Handle conversion of boolean query parameters with a value of `false`" +[270]: https://github.com/kubernetes/kubernetes/pull/7532 "Add image-related methods to Runtime interface." +[271]: https://github.com/kubernetes/kubernetes/pull/7560 "Test whether auto-generated conversions weren't manually edited" +[272]: https://github.com/kubernetes/kubernetes/pull/7484 "Mention :latest behavior for image version tag" +[273]: https://github.com/kubernetes/kubernetes/pull/7487 "readinessProbe calls livenessProbe.Exec.Command which cause `invalid memory address or nil pointer dereference`." +[274]: https://github.com/kubernetes/kubernetes/pull/7520 "Add RuntimeHooks to abstract Kubelet logic" +[275]: https://github.com/kubernetes/kubernetes/pull/7546 "Expose URL() on Request to allow building URLs" +[276]: https://github.com/kubernetes/kubernetes/pull/7288 "Add a simple cache for objects stored in etcd" +[277]: https://github.com/kubernetes/kubernetes/pull/7431 "Prepare for chaining autogenerated conversion methods " +[278]: https://github.com/kubernetes/kubernetes/pull/7353 "Increase maxIdleConnection limit when creating etcd client in apiserver." +[279]: https://github.com/kubernetes/kubernetes/pull/7354 "Improvements to generator of conversion methods." +[280]: https://github.com/kubernetes/kubernetes/pull/7107 "Code to automatically generate conversion methods" +[281]: https://github.com/kubernetes/kubernetes/pull/7407 "Support recovery for anonymous roll outs" +[282]: https://github.com/kubernetes/kubernetes/pull/7527 "Bump kube2sky to 1.2. Point it at https endpoint (3rd try)." +[283]: https://github.com/kubernetes/kubernetes/pull/7526 "cluster/gce/coreos: Add metadata-service in node.yaml" +[284]: https://github.com/kubernetes/kubernetes/pull/7480 "Move ComputePodChanges to the Docker runtime" +[285]: https://github.com/kubernetes/kubernetes/pull/7510 "Cobra rebase" +[286]: https://github.com/kubernetes/kubernetes/pull/6718 "Adding system oom events from kubelet" +[287]: https://github.com/kubernetes/kubernetes/pull/7479 "Move Prober to its own subpackage" +[288]: https://github.com/kubernetes/kubernetes/pull/7513 "Fix parallel-e2e.sh to work on my macbook (bash v3.2)" +[289]: https://github.com/kubernetes/kubernetes/pull/7449 "Move network plugin TearDown to DockerManager" +[290]: https://github.com/kubernetes/kubernetes/issues/7498 "CoreOS Getting Started Guide not working" +[291]: https://github.com/kubernetes/kubernetes/pull/7499 "Fixes #7498 - CoreOS Getting Started Guide had invalid cloud config" +[292]: https://github.com/kubernetes/kubernetes/pull/7504 "Fix invalid character " after object key:value pair" +[293]: https://github.com/kubernetes/kubernetes/issues/7317 "GlusterFS Volume Plugin deletes the contents of the mounted volume upon Pod deletion" +[294]: https://github.com/kubernetes/kubernetes/pull/7503 "Fixed kubelet deleting data from volumes on stop (#7317)." +[295]: https://github.com/kubernetes/kubernetes/pull/7482 "Fixing hooks/description to catch API fields without description tags" +[296]: https://github.com/kubernetes/kubernetes/pull/7457 "cadvisor is obsoleted so kubelet service does not require it." +[297]: https://github.com/kubernetes/kubernetes/pull/7408 "Set the default namespace for events to be "default"" +[298]: https://github.com/kubernetes/kubernetes/pull/7446 "Fix typo in namespace conversion" +[299]: https://github.com/kubernetes/kubernetes/pull/7419 "Convert Secret registry to use update/create strategy, allow filtering by Type" +[300]: https://github.com/kubernetes/kubernetes/pull/7102 "Use pod namespace when looking for its GlusterFS endpoints." +[301]: https://github.com/kubernetes/kubernetes/pull/7427 "Fixed name of kube-proxy path in deployment scripts." diff --git a/content/en/blog/_posts/2015-11-00-Kubernetes-1-1-Performance-Upgrades-Improved-Tooling-And-A-Growing-Community.md b/content/en/blog/_posts/2015-11-00-Kubernetes-1-1-Performance-Upgrades-Improved-Tooling-And-A-Growing-Community.md index 953504df01494..7cb02e0f60539 100644 --- a/content/en/blog/_posts/2015-11-00-Kubernetes-1-1-Performance-Upgrades-Improved-Tooling-And-A-Growing-Community.md +++ b/content/en/blog/_posts/2015-11-00-Kubernetes-1-1-Performance-Upgrades-Improved-Tooling-And-A-Growing-Community.md @@ -10,7 +10,7 @@ evergreen: true Since the Kubernetes 1.0 release in July, we’ve seen tremendous adoption by companies building distributed systems to manage their container clusters. We’re also been humbled by the rapid growth of the community who help make Kubernetes better everyday. We have seen commercial offerings such as Tectonic by CoreOS and RedHat Atomic Host emerge to deliver deployment and support of Kubernetes. And a growing ecosystem has added Kubernetes support including tool vendors such as Sysdig and Project Calico. -With the help of hundreds of contributors, we’re proud to announce the availability of Kubernetes 1.1, which offers major performance upgrades, improved tooling, and new features that make applications even easier to build and deploy. +With the help of hundreds of contributors, we’re proud to announce the availability of Kubernetes 1.1, which offers major performance upgrades, improved tooling, and new features that make applications even easier to build and deploy. Some of the work we’d like to highlight includes: @@ -32,9 +32,9 @@ Some of the work we’d like to highlight includes: -Today, we’re also proud to mark the inaugural Kubernetes conference, [KubeCon](https://kubecon.io/), where some 400 community members along with dozens of vendors are in attendance supporting the Kubernetes project. +Today, we’re also proud to mark the inaugural Kubernetes conference, [KubeCon](https://kubecon.io/), where some 400 community members along with dozens of vendors are in attendance supporting the Kubernetes project. -We’d love to highlight just a few of the many partners making Kubernetes better: +We’d love to highlight just a few of the many partners making Kubernetes better: > “We are betting our major product, Tectonic – which enables any company to deploy, manage and secure its containers anywhere – on Kubernetes because we believe it is the future of the data center. The release of Kubernetes 1.1 is another major milestone that will create more widespread adoption of distributed systems and containers, and puts us on a path that will inevitably lead to a whole new generation of products and services.” – Alex Polvi, CEO, CoreOS. @@ -42,15 +42,12 @@ We’d love to highlight just a few of the many partners making Kubernetes bette > “The tremendous customer demand we’re seeing to run containers at scale with Kubernetes is a critical element driving growth in our professional services business at Redapt. As a trusted advisor, it’s great to have a tool like Kubernetes in our tool belt to help our customers achieve their objectives.” – Paul Welch, SR VP Cloud Solutions, Redapt -> - -As we mentioned above, we would love your help: +As we mentioned above, we would love your help: - Get involved with the Kubernetes project on [GitHub](https://github.com/kubernetes/kubernetes)  - Connect with the community on [Slack](http://slack.kubernetes.io/) - Follow us on Twitter [@Kubernetesio](https://twitter.com/kubernetesio) for latest updates  -- Post questions (or answer questions) on Stackoverflow  +- Post questions (or answer questions) on StackOverflow - Get started running, deploying, and using Kubernetes [guides](/docs/tutorials/kubernetes-basics/); -But, most of all, just let us know how you are transforming your business using Kubernetes, and how we can help you do it even faster. Thank you for your support! - +But, most of all, just let us know how you are transforming your business using Kubernetes, and how we can help you do it even faster. Thank you for your support! diff --git a/content/en/blog/_posts/2017-01-00-Fission-Serverless-Functions-As-Service-For-Kubernetes.md b/content/en/blog/_posts/2017-01-00-Fission-Serverless-Functions-As-Service-For-Kubernetes.md index fb86e683c08d4..7f53d19cb13eb 100644 --- a/content/en/blog/_posts/2017-01-00-Fission-Serverless-Functions-As-Service-For-Kubernetes.md +++ b/content/en/blog/_posts/2017-01-00-Fission-Serverless-Functions-As-Service-For-Kubernetes.md @@ -3,9 +3,9 @@ title: " Fission: Serverless Functions as a Service for Kubernetes " date: 2017-01-30 slug: fission-serverless-functions-as-service-for-kubernetes url: /blog/2017/01/Fission-Serverless-Functions-As-Service-For-Kubernetes +author: > + Soam Vasani (Platform9 Systems) --- -_Editor's note: Today’s post is by Soam Vasani, Software Engineer at Platform9 Systems, talking about a new open source Serverless Function (FaaS) framework for Kubernetes._  - [Fission](https://github.com/fission/fission) is a Functions as a Service (FaaS) / Serverless function framework built on Kubernetes. Fission allows you to easily create HTTP services on Kubernetes from functions. It works at the source level and abstracts away container images (in most cases). It also simplifies the Kubernetes learning curve, by enabling you to make useful services without knowing much about Kubernetes. @@ -127,6 +127,3 @@ Fission is open source and developed in the open by [Platform9 Systems](http://p - Connect with the community on [Slack](http://slack.k8s.io/) - Follow us on Twitter [@Kubernetesio](https://twitter.com/kubernetesio) for latest updates - - -_--Soam Vasani, Software Engineer, Platform9 Systems_ diff --git a/content/en/blog/_posts/2017-01-00-How-We-Run-Kubernetes-In-Kubernetes-Kubeception.md b/content/en/blog/_posts/2017-01-00-How-We-Run-Kubernetes-In-Kubernetes-Kubeception.md index 49ccc4ce45a37..df0b8e4603042 100644 --- a/content/en/blog/_posts/2017-01-00-How-We-Run-Kubernetes-In-Kubernetes-Kubeception.md +++ b/content/en/blog/_posts/2017-01-00-How-We-Run-Kubernetes-In-Kubernetes-Kubeception.md @@ -3,9 +3,10 @@ title: " How we run Kubernetes in Kubernetes aka Kubeception " date: 2017-01-20 slug: how-we-run-kubernetes-in-kubernetes-kubeception url: /blog/2017/01/How-We-Run-Kubernetes-In-Kubernetes-Kubeception +author: > + Hector Fernandez (Giant Swarm) + Puja Abbassi (Giant Swarm) --- -_Editor's note: Today’s post is by the team at Giant Swarm, showing how they run Kubernetes in Kubernetes._ - [Giant Swarm](https://giantswarm.io/)’s container infrastructure started out with the goal to be an easy way for developers to deploy containerized microservices. Our first generation was extensively using [fleet](https://github.com/coreos/fleet) as a base layer for our infrastructure components as well as for scheduling user containers. In order to give our users a more powerful way to manage their containers we introduced Kubernetes into our stack in early 2016. However, as we needed a quick way to flexibly spin up and manage different users’ Kubernetes clusters resiliently we kept the underlying fleet layer. @@ -119,6 +120,3 @@ This setup is still in its early days and our roadmap is planning for improvemen Most importantly, we are working on making the inner Kubernetes clusters a third party resource that can then be managed by a custom controller. The result would be much like the [Operator concept by CoreOS](https://coreos.com/blog/introducing-operators.html). And to ensure that the community at large can benefit from this project we will be open sourcing this in the near future. - - -_-- Hector Fernandez, Software Engineer & Puja Abbassi, Developer Advocate, Giant Swarm_ diff --git a/content/en/blog/_posts/2017-01-00-Kubernetes-Ux-Survey-Infographic.md b/content/en/blog/_posts/2017-01-00-Kubernetes-Ux-Survey-Infographic.md index ddea9bbe91a8a..4e0e149ae2ca8 100644 --- a/content/en/blog/_posts/2017-01-00-Kubernetes-Ux-Survey-Infographic.md +++ b/content/en/blog/_posts/2017-01-00-Kubernetes-Ux-Survey-Infographic.md @@ -3,9 +3,9 @@ title: " Kubernetes UX Survey Infographic " date: 2017-01-09 slug: kubernetes-ux-survey-infographic url: /blog/2017/01/Kubernetes-Ux-Survey-Infographic +author: > + Dan Romlein (UX Designer) --- -_Editor's note: Today’s post is by Dan Romlein, UX Designer at Apprenda and member of the SIG-UI, sharing UX survey results from the Kubernetes community. _ - The following infographic summarizes the findings of a survey that the team behind [Dashboard](https://github.com/kubernetes/dashboard), the official web UI for Kubernetes, sent during KubeCon in November 2016. Following the KubeCon launch of the survey, it was promoted on Twitter and various Slack channels over a two week period and generated over 100 responses. We’re delighted with the data it provides us to now make feature and roadmap decisions more in-line with the needs of you, our users. **Satisfaction with Dashboard** diff --git a/content/en/blog/_posts/2017-01-00-Running-Mongodb-On-Kubernetes-With-Statefulsets.md b/content/en/blog/_posts/2017-01-00-Running-Mongodb-On-Kubernetes-With-Statefulsets.md index 6682d54df1a85..6c4c0eb9a5e33 100644 --- a/content/en/blog/_posts/2017-01-00-Running-Mongodb-On-Kubernetes-With-Statefulsets.md +++ b/content/en/blog/_posts/2017-01-00-Running-Mongodb-On-Kubernetes-With-Statefulsets.md @@ -3,8 +3,9 @@ title: " Running MongoDB on Kubernetes with StatefulSets " date: 2017-01-30 slug: running-mongodb-on-kubernetes-with-statefulsets url: /blog/2017/01/Running-Mongodb-On-Kubernetes-With-Statefulsets +author: > + Sandeep Dinesh (Google Cloud Platform) --- -_Editor's note: Today’s post is by Sandeep Dinesh, Developer Advocate, Google Cloud Platform, showing how to run a database in a container._ {{% warning %}} This post is several years old. The code examples need changes to work on a current Kubernetes cluster. @@ -260,4 +261,3 @@ Happy Hacking! For more cool Kubernetes and Container blog posts, follow me on [Twitter](https://twitter.com/sandeepdinesh) and [Medium](https://medium.com/@SandeepDinesh). -_--Sandeep Dinesh, Developer Advocate, Google Cloud Platform._ diff --git a/content/en/blog/_posts/2017-01-00-Scaling-Kubernetes-Deployments-With-Policy-Base-Networking.md b/content/en/blog/_posts/2017-01-00-Scaling-Kubernetes-Deployments-With-Policy-Base-Networking.md index 3318aabd17d34..04bc2c3f8cb67 100644 --- a/content/en/blog/_posts/2017-01-00-Scaling-Kubernetes-Deployments-With-Policy-Base-Networking.md +++ b/content/en/blog/_posts/2017-01-00-Scaling-Kubernetes-Deployments-With-Policy-Base-Networking.md @@ -3,9 +3,9 @@ title: " Scaling Kubernetes deployments with Policy-Based Networking " date: 2017-01-19 slug: scaling-kubernetes-deployments-with-policy-base-networking url: /blog/2017/01/Scaling-Kubernetes-Deployments-With-Policy-Base-Networking +author: > + Harmeet Sahni (Nuage Networks) --- -_Editor's note: Today’s post is by Harmeet Sahni, Director of Product Management, at Nuage Networks, writing about their contributions to Kubernetes and insights on policy-based networking.  _ - Although it’s just been eighteen-months since Kubernetes 1.0 was released, we’ve seen Kubernetes emerge as the leading container orchestration platform for deploying distributed applications. One of the biggest reasons for this is the vibrant open source community that has developed around it. The large number of Kubernetes contributors come from diverse backgrounds means we, and the community of users, are assured that we are investing in an open platform. Companies like Google (Container Engine), Red Hat (OpenShift), and CoreOS (Tectonic) are developing their own commercial offerings based on Kubernetes. This is a good thing since it will lead to more standardization and offer choice to the users.  **Networking requirements for Kubernetes applications** @@ -54,5 +54,3 @@ Being able to monitor the traffic flowing between Kubernetes Pods is very useful Even though we started working on our integration with Kubernetes over a year ago, it feels we are just getting started. We have always felt that this is a truly open community and we want to be an integral part of it. You can find out more about our Kubernetes integration on our [GitHub page](https://github.com/nuagenetworks/nuage-kubernetes). - -_--Harmeet Sahni, Director of Product Management, Nuage Networks_ diff --git a/content/en/blog/_posts/2017-01-00-Stronger-Foundation-For-Creating-And-Managing-Kubernetes-Clusters.md b/content/en/blog/_posts/2017-01-00-Stronger-Foundation-For-Creating-And-Managing-Kubernetes-Clusters.md index b1cd384fca322..2058cfa4592cb 100644 --- a/content/en/blog/_posts/2017-01-00-Stronger-Foundation-For-Creating-And-Managing-Kubernetes-Clusters.md +++ b/content/en/blog/_posts/2017-01-00-Stronger-Foundation-For-Creating-And-Managing-Kubernetes-Clusters.md @@ -3,9 +3,9 @@ title: " A Stronger Foundation for Creating and Managing Kubernetes Clusters " date: 2017-01-12 slug: stronger-foundation-for-creating-and-managing-kubernetes-clusters url: /blog/2017/01/Stronger-Foundation-For-Creating-And-Managing-Kubernetes-Clusters +author: > + [Lucas Käldström](https://twitter.com/kubernetesonarm) (independent) --- -_Editor's note: Today’s post is by Lucas Käldström an independent Kubernetes maintainer and SIG-Cluster-Lifecycle member, sharing what the group has been building and what’s upcoming. _ - Last time you heard from us was in September, when we announced [kubeadm](https://kubernetes.io/blog/2016/09/how-we-made-kubernetes-easy-to-install). The work on making kubeadm a first-class citizen in the Kubernetes ecosystem has continued and evolved. Some of us also met before KubeCon and had a very productive meeting where we talked about what the scopes for our SIG, kubeadm, and kops are.  **Continuing to Define SIG-Cluster-Lifecycle** @@ -100,6 +100,3 @@ In short, we're excited on the roadmap ahead in bringing a lot of these improvem Thank you for all the feedback and contributions. I hope this has given you some insight in what we’re doing and encouraged you to join us at our meetings to say hi! - - -_-- [Lucas Käldström](https://twitter.com/kubernetesonarm), Independent Kubernetes maintainer and SIG-Cluster-Lifecycle member_ diff --git a/content/en/blog/_posts/2017-02-00-Caas-The-Foundation-For-Next-Gen-Paas.md b/content/en/blog/_posts/2017-02-00-Caas-The-Foundation-For-Next-Gen-Paas.md index 66c810591b393..863f8d277c738 100644 --- a/content/en/blog/_posts/2017-02-00-Caas-The-Foundation-For-Next-Gen-Paas.md +++ b/content/en/blog/_posts/2017-02-00-Caas-The-Foundation-For-Next-Gen-Paas.md @@ -3,12 +3,9 @@ title: " Containers as a Service, the foundation for next generation PaaS " date: 2017-02-21 slug: caas-the-foundation-for-next-gen-paas url: /blog/2017/02/Caas-The-Foundation-For-Next-Gen-Paas +author: > + [Brendan Burns](https://twitter.com/brendandburns) (Microsoft) --- - -_Today’s post is by Brendan Burns, Partner Architect, at Microsoft & Kubernetes co-founder._ - - - Containers are revolutionizing the way that people build, package and deploy software. But what is often overlooked is how they are revolutionizing the way that people build the software that builds, packages and deploys software. (it’s ok if you have to read that sentence twice…) Today, and in a talk at [Container World](https://tmt.knect365.com/container-world/) tomorrow, I’m taking a look at how container orchestrators like Kubernetes form the foundation for next generation platform as a service (PaaS). In particular, I’m interested in how cloud container as a service (CaaS) platforms like [Azure Container Service](https://azure.microsoft.com/en-us/services/container-service/), [Google Container Engine](https://cloud.google.com/container-engine/) and [others](/docs/getting-started-guides/#hosted-solutions) are becoming the new infrastructure layer that PaaS is built upon. To see this, it’s important to consider the set of services that have traditionally been provided by PaaS platforms: @@ -36,13 +33,6 @@ I’m thrilled to see how containers and container as a service is changing the - - -_--[Brendan Burns](https://twitter.com/brendandburns), Partner Architect, at Microsoft and co-founder of Kubernetes_ - - - - - Get involved with the Kubernetes project on [GitHub](https://github.com/kubernetes/kubernetes) - Post questions (or answer questions) on [Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes) - [Download](http://get.k8s.io/) Kubernetes diff --git a/content/en/blog/_posts/2017-02-00-Highly-Available-Kubernetes-Clusters.md b/content/en/blog/_posts/2017-02-00-Highly-Available-Kubernetes-Clusters.md index 6d8a4a8a8bde4..1ae6f7dc5ad63 100644 --- a/content/en/blog/_posts/2017-02-00-Highly-Available-Kubernetes-Clusters.md +++ b/content/en/blog/_posts/2017-02-00-Highly-Available-Kubernetes-Clusters.md @@ -3,6 +3,8 @@ title: " Highly Available Kubernetes Clusters " date: 2017-02-02 slug: highly-available-kubernetes-clusters url: /blog/2017/02/Highly-Available-Kubernetes-Clusters +author: > + Jerzy Szczepkowski (Google) --- Today’s post shows how to set-up a reliable, highly available distributed Kubernetes cluster. The support for running such clusters on Google Compute Engine (GCE) was added as an alpha feature in [Kubernetes 1.5 release](https://kubernetes.io/blog/2016/12/kubernetes-1-5-supporting-production-workloads/). @@ -325,6 +327,3 @@ We have shown how, by adding worker node pools and master replicas, a Highly Ava - Connect with the community on [Slack](http://slack.k8s.io/) - Follow us on Twitter [@Kubernetesio](https://twitter.com/kubernetesio) for latest updates - - -_--Jerzy Szczepkowski, Software Engineer, Google_ diff --git a/content/en/blog/_posts/2017-02-00-Postgresql-Clusters-Kubernetes-Statefulsets.md b/content/en/blog/_posts/2017-02-00-Postgresql-Clusters-Kubernetes-Statefulsets.md index 63569bb4b4890..30acb383355f9 100644 --- a/content/en/blog/_posts/2017-02-00-Postgresql-Clusters-Kubernetes-Statefulsets.md +++ b/content/en/blog/_posts/2017-02-00-Postgresql-Clusters-Kubernetes-Statefulsets.md @@ -3,6 +3,8 @@ title: " Deploying PostgreSQL Clusters using StatefulSets " date: 2017-02-24 slug: postgresql-clusters-kubernetes-statefulsets url: /blog/2017/02/Postgresql-Clusters-Kubernetes-Statefulsets +author: > + Jeff McCormick ([Crunchy Data](http://crunchydata.com/)) --- _Editor’s note: Today’s guest post is by Jeff McCormick, a developer at Crunchy Data, showing how to build a PostgreSQL cluster using the new Kubernetes StatefulSet feature._ @@ -306,7 +308,3 @@ The container is designed to create a subdirectory on that path using the pod ho StatefulSets is an exciting feature added to Kubernetes for container builders that are implementing clustering. The ordinal values assigned to the set provide a very simple mechanism to make clustering decisions when deploying a PostgreSQL cluster. - - - -_--Jeff McCormick, Developer, [Crunchy Data](http://crunchydata.com/)_ diff --git a/content/en/blog/_posts/2017-02-00-Run-Deep-Learning-With-Paddlepaddle-On-Kubernetes.md b/content/en/blog/_posts/2017-02-00-Run-Deep-Learning-With-Paddlepaddle-On-Kubernetes.md index bae95f2c0d3a6..3e76f543dfd37 100644 --- a/content/en/blog/_posts/2017-02-00-Run-Deep-Learning-With-Paddlepaddle-On-Kubernetes.md +++ b/content/en/blog/_posts/2017-02-00-Run-Deep-Learning-With-Paddlepaddle-On-Kubernetes.md @@ -3,12 +3,11 @@ title: " Run Deep Learning with PaddlePaddle on Kubernetes " date: 2017-02-08 slug: run-deep-learning-with-paddlepaddle-on-kubernetes url: /blog/2017/02/Run-Deep-Learning-With-Paddlepaddle-On-Kubernetes +author: > + Yi Wang ([Baidu Research](http://research.baidu.com/)), + Xiang Li ([CoreOS](https://coreos.com/)) --- -_Editor's note: Today's post is a joint post from the deep learning team at Baidu and the etcd team at CoreOS._ - - - **[![](https://3.bp.blogspot.com/-Mwn3FU9hffI/WJk8QBxA6SI/AAAAAAAAA8w/AS5QoMdPTN8bL9jnixlsCXzj1IfYerhRQCLcB/s200/baidu_research_logo_rgb.png)](https://3.bp.blogspot.com/-Mwn3FU9hffI/WJk8QBxA6SI/AAAAAAAAA8w/AS5QoMdPTN8bL9jnixlsCXzj1IfYerhRQCLcB/s1600/baidu_research_logo_rgb.png)** @@ -159,9 +158,6 @@ Another potential improvement is better PaddlePaddle job configuration. Our expe PaddlePaddle trainers can utilize multiple GPUs to accelerate computations. GPU is not a first class resource in Kubernetes yet. We have to manage GPUs semi-manually. We would love to work with Kubernetes community to improve GPU support to ensure PaddlePaddle runs the best on Kubernetes. -_--Yi Wang, [Baidu Research](http://research.baidu.com/) and Xiang Li, [CoreOS](https://coreos.com/)_ - - - [Download](http://get.k8s.io/) Kubernetes - Get involved with the Kubernetes project on [GitHub](https://github.com/kubernetes/kubernetes) diff --git a/content/en/blog/_posts/2017-03-00-Advanced-Scheduling-In-Kubernetes.md b/content/en/blog/_posts/2017-03-00-Advanced-Scheduling-In-Kubernetes.md index 722b1e59b0356..3f6a2306b3072 100644 --- a/content/en/blog/_posts/2017-03-00-Advanced-Scheduling-In-Kubernetes.md +++ b/content/en/blog/_posts/2017-03-00-Advanced-Scheduling-In-Kubernetes.md @@ -3,6 +3,9 @@ title: " Advanced Scheduling in Kubernetes " date: 2017-03-31 slug: advanced-scheduling-in-kubernetes url: /blog/2017/03/Advanced-Scheduling-In-Kubernetes +author: > + Ian Lewis (Google), + David Oppenheimer (Google) --- _Editor’s note: this post is part of a [series of in-depth articles](https://kubernetes.io/blog/2017/03/five-days-of-kubernetes-1-6) on what's new in Kubernetes 1.6_ @@ -227,6 +230,3 @@ Share your voice at our weekly [community meeting](https://github.com/kubernetes Many thanks for your contributions. - - -_--Ian Lewis, Developer Advocate, and David Oppenheimer, Software Engineer, Google_ diff --git a/content/en/blog/_posts/2017-03-00-Dynamic-Provisioning-And-Storage-Classes-Kubernetes.md b/content/en/blog/_posts/2017-03-00-Dynamic-Provisioning-And-Storage-Classes-Kubernetes.md index d8893fff0e1bd..83cfafd8b6108 100644 --- a/content/en/blog/_posts/2017-03-00-Dynamic-Provisioning-And-Storage-Classes-Kubernetes.md +++ b/content/en/blog/_posts/2017-03-00-Dynamic-Provisioning-And-Storage-Classes-Kubernetes.md @@ -3,6 +3,10 @@ title: " Dynamic Provisioning and Storage Classes in Kubernetes " date: 2017-03-29 slug: dynamic-provisioning-and-storage-classes-kubernetes url: /blog/2017/03/Dynamic-Provisioning-And-Storage-Classes-Kubernetes +author: > + Saad Ali (Google), + Michelle Au (Google), + Matthew De Lio (Google) --- _Editor’s note: this post is part of a [series of in-depth articles](https://kubernetes.io/blog/2017/03/five-days-of-kubernetes-1-6) on what's new in Kubernetes 1.6_ @@ -203,8 +207,6 @@ Yes, you can assign a StorageClass to an existing PV by editing the appropriate **What happens if I delete a PersistentVolumeClaim (PVC)?** If the volume was dynamically provisioned, then the default reclaim policy is set to “delete”. This means that, by default, when the PVC is deleted, the underlying PV and storage asset will also be deleted. If you want to retain the data stored on the volume, then you must change the reclaim policy from “delete” to “retain” after the PV is provisioned. -_--Saad Ali & Michelle Au, Software Engineers, and Matthew De Lio, Product Manager, Google_ - - Post questions (or answer questions) on [Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes) - Join the community portal for advocates on [K8sPort](http://k8sport.org/) diff --git a/content/en/blog/_posts/2017-03-00-K8Sport-Engaging-The-Kubernetes-Community.md b/content/en/blog/_posts/2017-03-00-K8Sport-Engaging-The-Kubernetes-Community.md index 721d1363c824d..78229a99d471f 100644 --- a/content/en/blog/_posts/2017-03-00-K8Sport-Engaging-The-Kubernetes-Community.md +++ b/content/en/blog/_posts/2017-03-00-K8Sport-Engaging-The-Kubernetes-Community.md @@ -3,8 +3,9 @@ title: " The K8sPort: Engaging Kubernetes Community One Activity at a Time " date: 2017-03-24 slug: k8sport-engaging-the-kubernetes-community url: /blog/2017/03/K8Sport-Engaging-The-Kubernetes-Community +author: > + Ryan Quackenbush (Apprenda) --- -_Editor's note: Today’s post is by Ryan Quackenbush, Advocacy Programs Manager at Apprenda, showing a new community portal for Kubernetes advocates: the K8sPort._ The [**K8sPort**](http://k8sport.org/) is a hub designed to help you, the Kubernetes community, earn credit for the hard work you’re putting forth in making this one of the most successful open source projects ever. Back at KubeCon Seattle in November, I [presented](https://youtu.be/LwViH5eLoOI) a lightning talk of a preview of K8sPort. @@ -43,9 +44,3 @@ If you’re interested in joining the advocacy hub, please join us at [k8sport.o For a quick walkthrough on K8sPort authentication and the hub itself, see this quick demo, below. - - - - - -_--Ryan Quackenbush, Advocacy Programs Manager, Apprenda_ diff --git a/content/en/blog/_posts/2017-03-00-Kubernetes-1-6-Multi-User-Multi-Workloads-At-Scale.md b/content/en/blog/_posts/2017-03-00-Kubernetes-1-6-Multi-User-Multi-Workloads-At-Scale.md index ab44cdb4c408e..5ea0dd35c4c7c 100644 --- a/content/en/blog/_posts/2017-03-00-Kubernetes-1-6-Multi-User-Multi-Workloads-At-Scale.md +++ b/content/en/blog/_posts/2017-03-00-Kubernetes-1-6-Multi-User-Multi-Workloads-At-Scale.md @@ -3,8 +3,12 @@ title: " Kubernetes 1.6: Multi-user, Multi-workloads at Scale " date: 2017-03-28 slug: kubernetes-1.6-multi-user-multi-workloads-at-scale url: /blog/2017/03/Kubernetes-1-6-Multi-User-Multi-Workloads-At-Scale +author: > + Aparna Sinha (Google) --- -Today we’re announcing the release of Kubernetes 1.6. +_This article is by Aparna Sinha on behalf of the Kubernetes 1.6 release team._ + +Today we’re announcing the release of Kubernetes 1.6. In this release the community’s focus is on scale and automation, to help you deploy multiple workloads to multiple users on a cluster. We are announcing that 5,000 node clusters are supported. We moved dynamic storage provisioning to _stable_. Role-based access control ([RBAC](/docs/reference/access-authn-authz/rbac/)), [kubefed](/docs/tutorials/federation/set-up-cluster-federation-kubefed/), [kubeadm](/docs/getting-started-guides/kubeadm/), and several scheduling features are moving to _beta_. We have also added intelligent defaults throughout to enable greater automation out of the box. @@ -106,7 +110,4 @@ Share your voice at our weekly [community meeting](https://github.com/kubernetes Many thanks for your contributions and advocacy! - -_-- Aparna Sinha, Senior Product Manager, Kubernetes, Google_ - _**PS: read this [series of in-depth articles](https://kubernetes.io/blog/2017/03/five-days-of-kubernetes-1-6) on what's new in Kubernetes 1.6**_ diff --git a/content/en/blog/_posts/2017-03-00-Scalability-Updates-In-Kubernetes-1-6.md b/content/en/blog/_posts/2017-03-00-Scalability-Updates-In-Kubernetes-1-6.md index 4f9b28f40e345..bd211665d67d0 100644 --- a/content/en/blog/_posts/2017-03-00-Scalability-Updates-In-Kubernetes-1-6.md +++ b/content/en/blog/_posts/2017-03-00-Scalability-Updates-In-Kubernetes-1-6.md @@ -3,6 +3,8 @@ title: " Scalability updates in Kubernetes 1.6: 5,000 node and 150,000 pod clust date: 2017-03-30 slug: scalability-updates-in-kubernetes-1.6 url: /blog/2017/03/Scalability-Updates-In-Kubernetes-1-6 +author: > + Wojciech Tyczynski (Google) --- _Editor’s note: this post is part of a [series of in-depth articles](https://kubernetes.io/blog/2017/03/five-days-of-kubernetes-1-6) on what's new in Kubernetes 1.6_ @@ -80,9 +82,5 @@ If you are interested in scalability and performance, please join our community - Join our Special Interest Group, [SIG-Scalability](https://github.com/kubernetes/community/blob/master/sig-scalability/README.md), which meets every Thursday at 9:00 AM PST Thanks for the support and contributions! Read more in-depth posts on what's new in Kubernetes 1.6 [here](https://kubernetes.io/blog/2017/03/five-days-of-kubernetes-1-6). -_-- Wojciech Tyczynski, Software Engineer, Google_ - - - [1] We are investigating why 5000-node clusters have better startup time than 2000-node clusters. The current theory is that it is related to running 5000-node experiments using 64-core master and 2000-node experiments using 32-core master. diff --git a/content/en/blog/_posts/2017-04-00-Configuring-Private-Dns-Zones-Upstream-Nameservers-Kubernetes.md b/content/en/blog/_posts/2017-04-00-Configuring-Private-Dns-Zones-Upstream-Nameservers-Kubernetes.md index c95216d423ed0..9bfdd1270d8c0 100644 --- a/content/en/blog/_posts/2017-04-00-Configuring-Private-Dns-Zones-Upstream-Nameservers-Kubernetes.md +++ b/content/en/blog/_posts/2017-04-00-Configuring-Private-Dns-Zones-Upstream-Nameservers-Kubernetes.md @@ -3,6 +3,9 @@ title: " Configuring Private DNS Zones and Upstream Nameservers in Kubernetes " date: 2017-04-04 slug: configuring-private-dns-zones-upstream-nameservers-kubernetes url: /blog/2017/04/Configuring-Private-Dns-Zones-Upstream-Nameservers-Kubernetes +author: > + Bowei Du (Google), + Matthew DeLio (Google) --- _Editor’s note: this post is part of a [series of in-depth articles](https://kubernetes.io/blog/2017/03/five-days-of-kubernetes-1-6) on what's new in Kubernetes 1.6_ @@ -138,13 +141,6 @@ If you’d like to contribute or simply help provide feedback and drive the road Thanks for your support and contributions. Read more in-depth posts on what's new in Kubernetes 1.6 [here](https://kubernetes.io/blog/2017/03/five-days-of-kubernetes-1-6). - - - -_--Bowei Du, Software Engineer and Matthew DeLio, Product Manager, Google_ - - - - Post questions (or answer questions) on [Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes) - Join the community portal for advocates on [K8sPort](http://k8sport.org/) - Get involved with the Kubernetes project on [GitHub](https://github.com/kubernetes/kubernetes) diff --git a/content/en/blog/_posts/2017-04-00-Multi-Stage-Canary-Deployments-With-Kubernetes-In-The-Cloud-Onprem.md b/content/en/blog/_posts/2017-04-00-Multi-Stage-Canary-Deployments-With-Kubernetes-In-The-Cloud-Onprem.md index f46e9aac0c85a..7a362201a7d1a 100644 --- a/content/en/blog/_posts/2017-04-00-Multi-Stage-Canary-Deployments-With-Kubernetes-In-The-Cloud-Onprem.md +++ b/content/en/blog/_posts/2017-04-00-Multi-Stage-Canary-Deployments-With-Kubernetes-In-The-Cloud-Onprem.md @@ -3,9 +3,9 @@ title: " How Bitmovin is Doing Multi-Stage Canary Deployments with Kubernetes in date: 2017-04-21 slug: multi-stage-canary-deployments-with-kubernetes-in-the-cloud-onprem url: /blog/2017/04/Multi-Stage-Canary-Deployments-With-Kubernetes-In-The-Cloud-Onprem +author: > + Daniel Hoelbling-Inzko (Bitmovin) --- -_Editor's Note: Today’s post is by Daniel Hoelbling-Inzko, Infrastructure Architect at Bitmovin, a company that provides services that transcode digital video and audio to streaming formats, sharing insights about their use of Kubernetes._ - Running a large scale video encoding infrastructure on multiple public clouds is tough. At [Bitmovin](http://bitmovin.com/), we have been doing it successfully for the last few years, but from an engineering perspective, it’s neither been enjoyable nor particularly fun. So obviously, one of the main things that really sold us on using Kubernetes, was it’s common abstraction from the different supported cloud providers and the well thought out programming interface it provides. More importantly, the Kubernetes project did not settle for the lowest common denominator approach. Instead, they added the necessary abstract concepts that are required and useful to run containerized workloads in a cloud and then did all the hard work to map these concepts to the different cloud providers and their offerings. @@ -206,11 +206,6 @@ To summarize this post - by migrating our infrastructure to Kubernetes, Bitmovin We want to thank the Kubernetes community for the incredible job they have done with the project. The velocity at which the project moves is just breathtaking! Maintaining such a high level of quality and robustness in such a diverse environment is really astonishing. - -_--Daniel Hoelbling-Inzko, Infrastructure Architect, Bitmovin_ - - - - Post questions (or answer questions) on [Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes) - Join the community portal for advocates on [K8sPort](http://k8sport.org/) - Get involved with the Kubernetes project on [GitHub](https://github.com/kubernetes/kubernetes) diff --git a/content/en/blog/_posts/2017-04-00-Rbac-Support-In-Kubernetes.md b/content/en/blog/_posts/2017-04-00-Rbac-Support-In-Kubernetes.md index ad6461ef920bb..4966f21b30908 100644 --- a/content/en/blog/_posts/2017-04-00-Rbac-Support-In-Kubernetes.md +++ b/content/en/blog/_posts/2017-04-00-Rbac-Support-In-Kubernetes.md @@ -3,6 +3,10 @@ title: " RBAC Support in Kubernetes " date: 2017-04-06 slug: rbac-support-in-kubernetes url: /blog/2017/04/Rbac-Support-In-Kubernetes +author: > + Jacob Simpson (Google), + Greg Castle (Google), + CJ Cullen (Google) --- _Editor’s note: this post is part of a [series of in-depth articles](https://kubernetes.io/blog/2017/03/five-days-of-kubernetes-1-6) on what's new in Kubernetes 1.6_ @@ -116,14 +120,6 @@ Thanks for your support and contributions. Read more in-depth posts on what's ne - - -_-- Jacob Simpson, Greg Castle & CJ Cullen, Software Engineers at Google_ - - - - - - Post questions (or answer questions) on [Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes) - Join the community portal for advocates on [K8sPort](http://k8sport.org/) - Get involved with the Kubernetes project on [GitHub](https://github.com/kubernetes/kubernetes) diff --git a/content/en/blog/_posts/2017-05-00-Draft-Kubernetes-Container-Development.md b/content/en/blog/_posts/2017-05-00-Draft-Kubernetes-Container-Development.md index 8ce932878f38b..92518661be59d 100644 --- a/content/en/blog/_posts/2017-05-00-Draft-Kubernetes-Container-Development.md +++ b/content/en/blog/_posts/2017-05-00-Draft-Kubernetes-Container-Development.md @@ -3,9 +3,9 @@ title: " Draft: Kubernetes container development made easy " date: 2017-05-31 slug: draft-kubernetes-container-development url: /blog/2017/05/Draft-Kubernetes-Container-Development +author: > + Brendan Burns (Microsoft Azure) --- -_Today's post is by __Brendan Burns, Director of Engineering at Microsoft Azure and Kubernetes co-founder._ - About a month ago Microsoft announced the acquisition of Deis to expand our expertise in containers and Kubernetes. Today, I’m excited to announce a new open source project derived from this newly expanded Azure team: Draft. While by now the strengths of Kubernetes for deploying and managing applications at scale are well understood. The process of developing a new application for Kubernetes is still too hard. It’s harder still if you are new to containers, Kubernetes, or developing cloud applications. @@ -182,15 +182,6 @@ Now when we run curl http://$SERVICE\_IP, our first app has been deployed and up We hope this gives you a sense for everything that Draft can do to streamline development for Kubernetes. Happy drafting! - -_--Brendan Burns, Director of Engineering, Microsoft Azure_ - - - - - - - - Post questions (or answer questions) on [Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes) - Join the community portal for advocates on [K8sPort](http://k8sport.org/) - Follow us on Twitter [@Kubernetesio](https://twitter.com/kubernetesio) for latest updates diff --git a/content/en/blog/_posts/2017-05-00-Kubernetes-Monitoring-Guide.md b/content/en/blog/_posts/2017-05-00-Kubernetes-Monitoring-Guide.md index c5f114707275e..90c731ad40f60 100644 --- a/content/en/blog/_posts/2017-05-00-Kubernetes-Monitoring-Guide.md +++ b/content/en/blog/_posts/2017-05-00-Kubernetes-Monitoring-Guide.md @@ -3,10 +3,9 @@ title: " Kubernetes: a monitoring guide " date: 2017-05-19 slug: kubernetes-monitoring-guide url: /blog/2017/05/Kubernetes-Monitoring-Guide +author: > + Jean-Mathieu Saponaro (Datadog) --- -_Today’s post is by Jean-Mathieu Saponaro, Research & Analytics Engineer at Datadog, discussing what Kubernetes changes for monitoring, and how you can prepare to properly monitor a containerized infrastructure orchestrated by Kubernetes._ - - Container technologies are taking the infrastructure world by storm. While containers solve or simplify infrastructure management processes, they also introduce significant complexity in terms of orchestration. That’s where Kubernetes comes to our rescue. Just like a conductor directs an orchestra, [Kubernetes](/docs/concepts/overview/what-is-kubernetes/) oversees our ensemble of containers—starting, stopping, creating, and destroying them automatically to keep our applications humming along. Kubernetes makes managing a containerized infrastructure much easier by creating levels of abstractions such as [pods](/docs/concepts/workloads/pods/pod/) and [services](/docs/concepts/services-networking/service/). We no longer have to worry about where applications are running or if they have enough resources to work properly. But that doesn’t change the fact that, in order to ensure good performance, we need to monitor our applications, the containers running them, and Kubernetes itself. @@ -73,11 +72,6 @@ Using Kubernetes drastically simplifies container management. But it requires us   - -_--Jean-Mathieu Saponaro, Research & Analytics Engineer, Datadog_ - - - - Get involved with the Kubernetes project on [GitHub](https://github.com/kubernetes/kubernetes)  - Post questions (or answer questions) on [Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes)  - Connect with the community on [Slack](http://slack.k8s.io/) diff --git a/content/en/blog/_posts/2017-05-00-Kubernetes-Security-Process-Explained.md b/content/en/blog/_posts/2017-05-00-Kubernetes-Security-Process-Explained.md index 59c061657148b..ce138d36bbea2 100644 --- a/content/en/blog/_posts/2017-05-00-Kubernetes-Security-Process-Explained.md +++ b/content/en/blog/_posts/2017-05-00-Kubernetes-Security-Process-Explained.md @@ -3,10 +3,10 @@ title: " Dancing at the Lip of a Volcano: The Kubernetes Security Process - Expl date: 2017-05-18 slug: kubernetes-security-process-explained url: /blog/2017/05/Kubernetes-Security-Process-Explained +author: > + Brandon Philips (CoreOS), + Jess Frazelle (Google) --- -_Editor's note: Today’s post is by  __Jess Frazelle of Google and Brandon Philips of CoreOS about the Kubernetes security disclosures and response policy.__  _ - - Software running on servers underpins ever growing amounts of the world's commerce, communications, and physical infrastructure. And nearly all of these systems are connected to the internet; which means vital security updates must be applied rapidly. As software developers and IT professionals, we often find ourselves dancing on the edge of a volcano: we may either fall into magma induced oblivion from a security vulnerability exploited before we can fix it, or we may slide off the side of the mountain because of an inadequate process to address security vulnerabilities.  The Kubernetes community believes that we can help teams restore their footing on this volcano with a foundation built on Kubernetes. And the bedrock of this foundation requires a process for quickly acknowledging, patching, and releasing security updates to an ever growing community of Kubernetes users.  @@ -26,10 +26,7 @@ As we [continue to harden Kubernetes](https://lwn.net/Articles/720215/), the sec As a thank you to the Kubernetes community, a special 25 percent discount to CoreOS Fest is available using k8s25code or via this special [25 percent off link](https://coreosfest17.eventbrite.com/?discount=k8s25code) to register today for CoreOS Fest 2017.  -_--Brandon Philips of CoreOS and Jess Frazelle of Google_ - - - + - Post questions (or answer questions) on [Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes) - Join the community portal for advocates on [K8sPort](http://k8sport.org/) - Follow us on Twitter [@Kubernetesio](https://twitter.com/kubernetesio) for latest updates diff --git a/content/en/blog/_posts/2017-05-00-Kubespray-Ansible-Collaborative-Kubernetes-Ops.md b/content/en/blog/_posts/2017-05-00-Kubespray-Ansible-Collaborative-Kubernetes-Ops.md index c6e4007d9a223..7db028c7f3cac 100644 --- a/content/en/blog/_posts/2017-05-00-Kubespray-Ansible-Collaborative-Kubernetes-Ops.md +++ b/content/en/blog/_posts/2017-05-00-Kubespray-Ansible-Collaborative-Kubernetes-Ops.md @@ -3,8 +3,9 @@ title: " Kubespray Ansible Playbooks foster Collaborative Kubernetes Ops " date: 2017-05-19 slug: kubespray-ansible-collaborative-kubernetes-ops url: /blog/2017/05/Kubespray-Ansible-Collaborative-Kubernetes-Ops +author: > + Rob Hirschfeld (RackN) --- -_Today’s guest post is by Rob Hirschfeld, co-founder of open infrastructure automation project, Digital Rebar and co-chair of the SIG Cluster Ops.  _ **Why Kubespray?** @@ -107,11 +108,6 @@ With Kubespray and Digital Rebar as a repeatable base, extensions get much faste If this is interesting, please engage with us in the [Cluster Ops SIG](https://github.com/kubernetes/community/tree/master/sig-cluster-ops), [Kubespray](https://github.com/kubernetes-incubator/kubespray) or [Digital Rebar](http://rebar.digital/) communities.  -_-- Rob Hirschfeld, co-founder of RackN and co-chair of the Cluster Ops SIG_ - - - - - Get involved with the Kubernetes project on [GitHub](https://github.com/kubernetes/kubernetes) - Post questions (or answer questions) on [Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes) diff --git a/content/en/blog/_posts/2017-06-00-Kubernetes-1-7-Security-Hardening-Stateful-Application-Extensibility-Updates.md b/content/en/blog/_posts/2017-06-00-Kubernetes-1-7-Security-Hardening-Stateful-Application-Extensibility-Updates.md index e80f557011aaf..8e1e32d9cfb66 100644 --- a/content/en/blog/_posts/2017-06-00-Kubernetes-1-7-Security-Hardening-Stateful-Application-Extensibility-Updates.md +++ b/content/en/blog/_posts/2017-06-00-Kubernetes-1-7-Security-Hardening-Stateful-Application-Extensibility-Updates.md @@ -3,8 +3,13 @@ title: " Kubernetes 1.7: Security Hardening, Stateful Application Updates and Ex date: 2017-06-30 slug: kubernetes-1.7-security-hardening-stateful-application-extensibility-updates url: /blog/2017/06/Kubernetes-1-7-Security-Hardening-Stateful-Application-Extensibility-Updates +author: > + Aparna Sinha (Google), + Ihor Dvoretskyi (Mirantis) --- -Today we’re announcing Kubernetes 1.7, a milestone release that adds security, storage and extensibility features motivated by widespread production use of Kubernetes in the most demanding enterprise environments.  +_This article is by Aparna Sinha and Ihor Dvoretskyi, on behalf of the Kubernetes 1.7 release team._ + +Today we’re announcing Kubernetes 1.7, a milestone release that adds security, storage and extensibility features motivated by widespread production use of Kubernetes in the most demanding enterprise environments. At-a-glance, security enhancements in this release include encrypted secrets, network policy for pod-to-pod communication, node authorizer to limit kubelet access and client / server TLS certificate rotation.  @@ -77,5 +82,3 @@ The simplest way to get involved is joining one of the many [Special Interest Gr Many thanks to our vast community of contributors and supporters in making this and all releases possible. - -_-- Aparna Sinha, Group Product Manager, Kubernetes Google and Ihor Dvoretskyi, Program Manager, Kubernetes Mirantis_ diff --git a/content/en/blog/_posts/2017-07-00-How-Watson-Health-Cloud-Deploys.md b/content/en/blog/_posts/2017-07-00-How-Watson-Health-Cloud-Deploys.md index b931ec336a57b..8ba9154a4cc89 100644 --- a/content/en/blog/_posts/2017-07-00-How-Watson-Health-Cloud-Deploys.md +++ b/content/en/blog/_posts/2017-07-00-How-Watson-Health-Cloud-Deploys.md @@ -3,6 +3,8 @@ title: " How Watson Health Cloud Deploys Applications with Kubernetes " date: 2017-07-14 slug: how-watson-health-cloud-deploys url: /blog/2017/07/How-Watson-Health-Cloud-Deploys +author: > + Sandhya Kapoor (IBM) --- Today’s post is by [Sandhya Kapoor](https://www.linkedin.com/in/sandhyakapoor/), Senior Technologist, Watson Platform for Health, IBM @@ -141,11 +143,6 @@ Exposing services with Ingress: To expose our services to outside the cluster, we used Ingress. In IBM Cloud Kubernetes Service, if we create a paid cluster, an Ingress controller is automatically installed for us to use. We were able to access services through Ingress by creating a YAML resource file that specifies the service path. - -–Sandhya Kapoor, Senior Technologist, Watson Platform for Health, IBM - - - - Post questions (or answer questions) on [Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes) - Join the community portal for advocates on [K8sPort](http://k8sport.org/) - Follow us on Twitter [@Kubernetesio](https://twitter.com/kubernetesio) for latest updates diff --git a/content/en/blog/_posts/2017-08-00-High-Performance-Networking-With-Ec2.md b/content/en/blog/_posts/2017-08-00-High-Performance-Networking-With-Ec2.md index 181af0aa58cc5..8f56af750db26 100644 --- a/content/en/blog/_posts/2017-08-00-High-Performance-Networking-With-Ec2.md +++ b/content/en/blog/_posts/2017-08-00-High-Performance-Networking-With-Ec2.md @@ -3,6 +3,9 @@ title: " High Performance Networking with EC2 Virtual Private Clouds " date: 2017-08-11 slug: high-performance-networking-with-ec2 url: /blog/2017/08/High-Performance-Networking-With-Ec2 +author: > + Juergen Brendel (Pani Networks) + Chris Marino (Pani Networks) --- @@ -71,7 +74,3 @@ When using Romana v2.0, native VPC networking is now available for clusters of a ![](https://archive.org/download/hpc-ec2-vpc-2/hpc-ec2-vpc-2.png) - - - --- _Juergen Brendel and Chris Marino, co-founders of Pani Networks, sponsor of the Romana project_ diff --git a/content/en/blog/_posts/2017-08-00-Kompose-Helps-Developers-Move-Docker.md b/content/en/blog/_posts/2017-08-00-Kompose-Helps-Developers-Move-Docker.md index b94ac8b69320d..544d1dc11e9d1 100644 --- a/content/en/blog/_posts/2017-08-00-Kompose-Helps-Developers-Move-Docker.md +++ b/content/en/blog/_posts/2017-08-00-Kompose-Helps-Developers-Move-Docker.md @@ -3,8 +3,9 @@ title: " Kompose Helps Developers Move Docker Compose Files to Kubernetes " date: 2017-08-10 slug: kompose-helps-developers-move-docker url: /blog/2017/08/Kompose-Helps-Developers-Move-Docker +author: > + Charlie Drage (Red Hat) --- -_Editor's note: today's post is by Charlie Drage, Software Engineer at Red Hat giving an update about the Kubernetes project Kompose._ I'm pleased to announce that [Kompose](https://github.com/kubernetes/kompose), a conversion tool for developers to transition Docker Compose applications to Kubernetes, has graduated from the [Kubernetes Incubator](https://github.com/kubernetes/community/blob/master/incubator.md) to become an official part of the project. @@ -147,10 +148,6 @@ As we continue development, we will strive to convert as many Docker Compose key - [Kompose Documentation](https://github.com/kubernetes/kompose/tree/master/docs) - ---Charlie Drage, Software Engineer, Red Hat - - - Post questions (or answer questions) on[Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes) - Join the community portal for advocates on[K8sPort](http://k8sport.org/) - Follow us on Twitter[@Kubernetesio](https://twitter.com/kubernetesio) for latest updates diff --git a/content/en/blog/_posts/2017-08-00-Kubernetes-Meets-High-Performance.md b/content/en/blog/_posts/2017-08-00-Kubernetes-Meets-High-Performance.md index 08de339bb9e53..6ad3823a97371 100644 --- a/content/en/blog/_posts/2017-08-00-Kubernetes-Meets-High-Performance.md +++ b/content/en/blog/_posts/2017-08-00-Kubernetes-Meets-High-Performance.md @@ -3,8 +3,9 @@ title: " Kubernetes Meets High-Performance Computing " date: 2017-08-22 slug: kubernetes-meets-high-performance url: /blog/2017/08/Kubernetes-Meets-High-Performance +author: > + Robert Lalonde (Univa) --- -Editor's note: today's post is by Robert Lalonde, general manager at Univa, on supporting mixed HPC and containerized applications   Anyone who has worked with Docker can appreciate the enormous gains in efficiency achievable with containers. While Kubernetes excels at orchestrating containers, high-performance computing (HPC) applications can be tricky to deploy on Kubernetes. diff --git a/content/en/blog/_posts/2017-09-00-Introducing-Resource-Management-Working.md b/content/en/blog/_posts/2017-09-00-Introducing-Resource-Management-Working.md index 4c1ff8183ab32..5a907b7c9e263 100644 --- a/content/en/blog/_posts/2017-09-00-Introducing-Resource-Management-Working.md +++ b/content/en/blog/_posts/2017-09-00-Introducing-Resource-Management-Working.md @@ -3,8 +3,9 @@ title: " Introducing the Resource Management Working Group " date: 2017-09-21 slug: introducing-resource-management-working url: /blog/2017/09/Introducing-Resource-Management-Working +author: > + Jeremy Eder (Red Hat) --- -_**Editor's note: today's post is by Jeremy Eder, Senior Principal Software Engineer at Red Hat, on the formation of the Resource Management Working Group**_ ## Why are we here? Kubernetes has evolved to support diverse and increasingly complex classes of applications. We can onboard and scale out modern, cloud-native web applications based on microservices, batch jobs, and stateful applications with persistent storage requirements. diff --git a/content/en/blog/_posts/2017-09-00-Kubernetes-18-Security-Workloads-And.md b/content/en/blog/_posts/2017-09-00-Kubernetes-18-Security-Workloads-And.md index e2f031f8a52b2..870ad747e38c8 100644 --- a/content/en/blog/_posts/2017-09-00-Kubernetes-18-Security-Workloads-And.md +++ b/content/en/blog/_posts/2017-09-00-Kubernetes-18-Security-Workloads-And.md @@ -4,11 +4,10 @@ date: 2017-09-29 slug: kubernetes-18-security-workloads-and url: /blog/2017/09/Kubernetes-18-Security-Workloads-And evergreen: true +author: > + [Kubernetes v1.8 Release Team](https://github.com/kubernetes/sig-release/blob/master/releases/release-1.8/release_team.md) --- -**Authors:** Kubernetes v1.8 release team - - We’re pleased to announce the delivery of Kubernetes 1.8, our third release this year. Kubernetes 1.8 represents a snapshot of many exciting enhancements and refinements underway. In addition to functional improvements, we’re increasing project-wide focus on maturing [process](https://github.com/kubernetes/sig-release), formalizing [architecture](https://github.com/kubernetes/community/tree/master/sig-architecture), and strengthening Kubernetes’ [governance model](https://github.com/kubernetes/community/tree/master/community/elections/2017). The evolution of mature processes clearly signals that sustainability is a driving concern, and helps to ensure that Kubernetes is a viable and thriving project far into the future. diff --git a/content/en/blog/_posts/2017-09-00-Kubernetes-Statefulsets-Daemonsets.md b/content/en/blog/_posts/2017-09-00-Kubernetes-Statefulsets-Daemonsets.md index 67f3e084cc957..cb20fc87360e9 100644 --- a/content/en/blog/_posts/2017-09-00-Kubernetes-Statefulsets-Daemonsets.md +++ b/content/en/blog/_posts/2017-09-00-Kubernetes-Statefulsets-Daemonsets.md @@ -4,9 +4,10 @@ title: " Kubernetes StatefulSets & DaemonSets Updates " date: 2017-09-27 slug: kubernetes-statefulsets-daemonsets url: /blog/2017/09/Kubernetes-Statefulsets-Daemonsets +author: > + Janet Kuo (Google), + Kenneth Owens (Kenneth Owens) --- -Editor's note: today's post is by Janet Kuo and Kenneth Owens, Software Engineers at Google. - This post talks about recent updates to the [DaemonSet](/docs/concepts/workloads/controllers/daemonset/) and [StatefulSet](/docs/concepts/workloads/controllers/statefulset/) API objects for Kubernetes. We explore these features using [Apache ZooKeeper](https://zookeeper.apache.org/) and [Apache Kafka](https://kafka.apache.org/) StatefulSets and a [Prometheus node exporter](https://github.com/prometheus/node_exporter) DaemonSet. diff --git a/content/en/blog/_posts/2017-09-00-Windows-Networking-At-Parity-With-Linux.md b/content/en/blog/_posts/2017-09-00-Windows-Networking-At-Parity-With-Linux.md index 14d7aae14eaee..6f746457ee41d 100644 --- a/content/en/blog/_posts/2017-09-00-Windows-Networking-At-Parity-With-Linux.md +++ b/content/en/blog/_posts/2017-09-00-Windows-Networking-At-Parity-With-Linux.md @@ -3,8 +3,9 @@ title: " Windows Networking at Parity with Linux for Kubernetes " date: 2017-09-08 slug: windows-networking-at-parity-with-linux url: /blog/2017/09/Windows-Networking-At-Parity-With-Linux +author: > + Jason Messer (Microsoft) --- -_**Editor's note: today's post is by Jason Messer, Principal PM Manager at Microsoft, on improvements to the Windows network stack to support the Kubernetes CNI model.**_ Since I last blogged about [Kubernetes Networking for Windows](https://blogs.technet.microsoft.com/networking/2017/04/04/windows-networking-for-kubernetes/) four months ago, the Windows Core Networking team has made tremendous progress in both the platform and open source Kubernetes projects. With the updates, Windows is now on par with Linux in terms of networking. Customers can now deploy mixed-OS, Kubernetes clusters in any environment including Azure, on-premises, and on 3rd-party cloud stacks with the same network primitives and topologies supported on Linux without any workarounds, “hacks”, or 3rd-party switch extensions. diff --git a/content/en/blog/_posts/2017-10-00-Enforcing-Network-Policies-In-Kubernetes.md b/content/en/blog/_posts/2017-10-00-Enforcing-Network-Policies-In-Kubernetes.md index acbae0265c77a..acc6f2c8966a0 100644 --- a/content/en/blog/_posts/2017-10-00-Enforcing-Network-Policies-In-Kubernetes.md +++ b/content/en/blog/_posts/2017-10-00-Enforcing-Network-Policies-In-Kubernetes.md @@ -3,8 +3,10 @@ title: " Enforcing Network Policies in Kubernetes " date: 2017-10-30 slug: enforcing-network-policies-in-kubernetes url: /blog/2017/10/Enforcing-Network-Policies-In-Kubernetes +author: > + Ahmet Alp Balkan (Google) --- -_**Editor's note: this post is part of a [series of in-depth articles](https://kubernetes.io/blog/2017/10/five-days-of-kubernetes-18) on what's new in Kubernetes 1.8. Today’s post comes from Ahmet Alp Balkan, Software Engineer, Google.**_ +_**Editor's note:** this post is part of a [series of in-depth articles](/blog/2017/10/five-days-of-kubernetes-18) on what's new in Kubernetes 1.8._ diff --git a/content/en/blog/_posts/2017-10-00-Kubeadm-V18-Released.md b/content/en/blog/_posts/2017-10-00-Kubeadm-V18-Released.md index 05a6605af9221..a0bdeba9b419a 100644 --- a/content/en/blog/_posts/2017-10-00-Kubeadm-V18-Released.md +++ b/content/en/blog/_posts/2017-10-00-Kubeadm-V18-Released.md @@ -3,8 +3,10 @@ title: " kubeadm v1.8 Released: Introducing Easy Upgrades for Kubernetes Cluste date: 2017-10-25 slug: kubeadm-v18-released url: /blog/2017/10/Kubeadm-V18-Released +author: > + Lucas Käldström (Weaveworks) --- -**_Editor’s note: this post is part of a [series of in-depth articles](https://kubernetes.io/blog/2017/10/five-days-of-kubernetes-18) on what's new in Kubernetes 1.8_** +_**Editor's note:** this post is part of a [series of in-depth articles](/blog/2017/10/five-days-of-kubernetes-18) on what's new in Kubernetes 1.8._ Since its debut in [September 2016](https://kubernetes.io/blog/2016/09/how-we-made-kubernetes-easy-to-install), the Cluster Lifecycle Special Interest Group (SIG) has established kubeadm as the easiest Kubernetes bootstrap method. Now, we’re releasing kubeadm v1.8.0 in tandem with the release of [Kubernetes v1.8.0](https://kubernetes.io/blog/2017/09/kubernetes-18-security-workloads-and). In this blog post, I’ll walk you through the changes we’ve made to kubeadm since the last update, the scope of kubeadm, and how you can contribute to this effort. @@ -99,7 +101,3 @@ If you want to get involved in these efforts, join SIG Cluster Lifecycle. We [me If you want to know what a kubeadm developer does at a given time in the Kubernetes release cycle, check out [this doc](https://github.com/kubernetes/kubeadm/blob/master/docs/release-cycle.md). Finally, don’t hesitate to join if any of our upcoming projects are of interest to you! -Thank you, -Lucas Käldström -Kubernetes maintainer & SIG Cluster Lifecycle co-lead -[Weaveworks](https://www.weave.works/?utm_source=k8&utm_medium=ww&utm_campaign=blog) contractor diff --git a/content/en/blog/_posts/2017-10-00-Request-Routing-And-Policy-Management.md b/content/en/blog/_posts/2017-10-00-Request-Routing-And-Policy-Management.md index 0d490ce1bf355..701c30a7be801 100644 --- a/content/en/blog/_posts/2017-10-00-Request-Routing-And-Policy-Management.md +++ b/content/en/blog/_posts/2017-10-00-Request-Routing-And-Policy-Management.md @@ -3,8 +3,12 @@ title: " Request Routing and Policy Management with the Istio Service Mesh " date: 2017-10-10 slug: request-routing-and-policy-management url: /blog/2017/10/Request-Routing-And-Policy-Management +author: > + Frank Budinsky (IBM), + Andra Cismaru (Google), + Israel Shalom (Google) --- - **_Editor's note: Today’s post by Frank Budinsky, Software Engineer, IBM, Andra Cismaru, Software Engineer, Google, and Israel Shalom, Product Manager, Google, is the second post in a three-part series on Istio. It offers a closer look at request routing and policy management._** +_**Editor's note:** Today’s post is the second post in a three-part series on Istio._ In a [previous article](https://kubernetes.io/blog/2017/05/managing-microservices-with-istio-service-mesh), we looked at a [simple application (Bookinfo)](https://istio.io/docs/guides/bookinfo.html) that is composed of four separate microservices. The article showed how to deploy an application with Kubernetes and an Istio-enabled cluster without changing any application code. The article also outlined how to view Istio provided L7 metrics on the running services. @@ -447,4 +451,4 @@ Stopping the load generator means the limit will no longer be exceeded: the blac ## Summary We’ve shown you how to introduce advanced features like HTTP request routing and policy injection into a service mesh configured with Istio without restarting any of the services. This lets you develop and deploy without worrying about the ongoing management of the service mesh; service-wide policies can always be added later. -In the next and last installment of this series, we’ll focus on Istio’s security and authentication capabilities. We’ll discuss how to secure all interservice communications in a mesh, even against insiders with access to the network, without any changes to the application code or the deployment. +In the next and last installment of this series, we’ll focus on Istio’s security and authentication capabilities. We’ll discuss how to secure all interservice communications in a mesh, even against insiders with access to the network, without any changes to the application code or the deployment. \ No newline at end of file diff --git a/content/en/blog/_posts/2017-10-00-Software-Conformance-Certification.md b/content/en/blog/_posts/2017-10-00-Software-Conformance-Certification.md index a9f31724ff49d..9ab6269735d08 100644 --- a/content/en/blog/_posts/2017-10-00-Software-Conformance-Certification.md +++ b/content/en/blog/_posts/2017-10-00-Software-Conformance-Certification.md @@ -3,11 +3,10 @@ title: " Introducing Software Certification for Kubernetes " date: 2017-10-19 slug: software-conformance-certification url: /blog/2017/10/Software-Conformance-Certification +author: > + William Denniss (Google) --- -_**Editor's Note: Today's post is by William Denniss, Product Manager, Google Cloud on the new Certified Kubernetes Conformance Program.**_ - - Over the last three years, Kubernetes® has seen wide-scale adoption by a vibrant and diverse community of providers. In fact, there are now more than [60](https://docs.google.com/spreadsheets/d/1LxSqBzjOxfGx3cmtZ4EbB_BGCxT_wlxW_xgHVVa23es/edit#gid=0) known Kubernetes platforms and distributions. From the start, one goal of Kubernetes has been consistency and portability. In order to better serve this goal, today the Kubernetes community and the Cloud Native Computing Foundation® (CNCF®) announce the availability of the beta Certified Kubernetes Conformance Program. The Kubernetes conformance certification program gives users the confidence that when they use a Certified Kubernetes™ product, they can rely on a high level of common functionality. Certification provides Independent Software Vendors (ISVs) confidence that if their customer is using a Certified Kubernetes product, their software will behave as expected. diff --git a/content/en/blog/_posts/2017-10-00-Using-Rbac-Generally-Available-18.md b/content/en/blog/_posts/2017-10-00-Using-Rbac-Generally-Available-18.md index 35f9234a676e3..96f479fcfb319 100644 --- a/content/en/blog/_posts/2017-10-00-Using-Rbac-Generally-Available-18.md +++ b/content/en/blog/_posts/2017-10-00-Using-Rbac-Generally-Available-18.md @@ -3,8 +3,10 @@ title: " Using RBAC, Generally Available in Kubernetes v1.8 " date: 2017-10-28 slug: using-rbac-generally-available-18 url: /blog/2017/10/Using-Rbac-Generally-Available-18 +author: > + Eric Chiang (CoreOS) --- -**_Editor's note: this post is part of a [series of in-depth articles](https://kubernetes.io/blog/2017/10/five-days-of-kubernetes-18) on what's new in Kubernetes 1.8. Today’s post comes from Eric Chiang, software engineer, CoreOS, and SIG-Auth co-lead._** +_**Editor's note:** this post is part of a [series of in-depth articles](/blog/2017/10/five-days-of-kubernetes-18) on what's new in Kubernetes 1.8._ Kubernetes 1.8 represents a significant milestone for the [role-based access control (RBAC) authorizer](/docs/reference/access-authn-authz/rbac/), which was promoted to GA in this release. RBAC is a mechanism for controlling access to the Kubernetes API, and since its [beta in 1.6](https://kubernetes.io/blog/2017/04/rbac-support-in-kubernetes), many Kubernetes clusters and provisioning strategies have enabled it by default. diff --git a/content/en/blog/_posts/2017-11-00-Containerd-Container-Runtime-Options-Kubernetes.md b/content/en/blog/_posts/2017-11-00-Containerd-Container-Runtime-Options-Kubernetes.md index 7bfcebe7059e4..3dd652df53c17 100644 --- a/content/en/blog/_posts/2017-11-00-Containerd-Container-Runtime-Options-Kubernetes.md +++ b/content/en/blog/_posts/2017-11-00-Containerd-Container-Runtime-Options-Kubernetes.md @@ -3,10 +3,11 @@ title: " Containerd Brings More Container Runtime Options for Kubernetes " date: 2017-11-02 slug: containerd-container-runtime-options-kubernetes url: /blog/2017/11/Containerd-Container-Runtime-Options-Kubernetes +author: > + Lantao Liu (Google), + Mike Brown (IBM) --- -**Authors:** Lantao Liu (Google), and Mike Brown (IBM) - _Update: Kubernetes support for Docker via `dockershim` is now deprecated. For more information, read the [deprecation notice](/blog/2020/12/08/kubernetes-1-20-release-announcement/#dockershim-deprecation). You can also discuss the deprecation via a dedicated [GitHub issue](https://github.com/kubernetes/kubernetes/issues/106917)._ diff --git a/content/en/blog/_posts/2017-11-00-Kubernetes-Easy-Way.md b/content/en/blog/_posts/2017-11-00-Kubernetes-Easy-Way.md index 54cbf1444ed81..af0e1e18ea996 100644 --- a/content/en/blog/_posts/2017-11-00-Kubernetes-Easy-Way.md +++ b/content/en/blog/_posts/2017-11-00-Kubernetes-Easy-Way.md @@ -3,9 +3,9 @@ title: " Kubernetes the Easy Way " date: 2017-11-01 slug: kubernetes-easy-way url: /blog/2017/11/Kubernetes-Easy-Way +author: > + Dan Garfield (Codefresh) --- - **_Editor's note: Today's post is by Dan Garfield, VP of Marketing at Codefresh, on how to set up and easily deploy a Kubernetes cluster._** - Kelsey Hightower wrote an invaluable guide for Kubernetes called [Kubernetes the Hard Way](https://github.com/kelseyhightower/kubernetes-the-hard-way). It’s an awesome resource for those looking to understand the ins and outs of Kubernetes—but what if you want to put Kubernetes on easy mode? That’s something we’ve been working on together with Google Cloud. In this guide, we’ll show you how to get a cluster up and running, as well as how to actually deploy your code to that cluster and run it. diff --git a/content/en/blog/_posts/2017-11-00-Securing-Software-Supply-Chain-Grafeas.md b/content/en/blog/_posts/2017-11-00-Securing-Software-Supply-Chain-Grafeas.md index b996a796a2aa7..c88400ed5e362 100644 --- a/content/en/blog/_posts/2017-11-00-Securing-Software-Supply-Chain-Grafeas.md +++ b/content/en/blog/_posts/2017-11-00-Securing-Software-Supply-Chain-Grafeas.md @@ -3,8 +3,10 @@ title: " Securing Software Supply Chain with Grafeas " date: 2017-11-03 slug: securing-software-supply-chain-grafeas url: /blog/2017/11/Securing-Software-Supply-Chain-Grafeas +author: > + Kelsey Hightower (Google), + Sandra Guo (Google) --- - **_Editor's note: This post is written by Kelsey Hightower, Staff Developer Advocate at Google, and Sandra Guo, Product Manager at Google._** Kubernetes has evolved to support increasingly complex classes of applications, enabling the development of two major industry trends: hybrid cloud and microservices. With increasing complexity in production environments, customers—especially enterprises—are demanding better ways to manage their software supply chain with more centralized visibility and control over production deployments. diff --git a/content/en/blog/_posts/2017-12-00-Introducing-Kubeflow-Composable.md b/content/en/blog/_posts/2017-12-00-Introducing-Kubeflow-Composable.md index dfc3ace13cc62..fb20eb8f96963 100644 --- a/content/en/blog/_posts/2017-12-00-Introducing-Kubeflow-Composable.md +++ b/content/en/blog/_posts/2017-12-00-Introducing-Kubeflow-Composable.md @@ -3,12 +3,11 @@ title: " Introducing Kubeflow - A Composable, Portable, Scalable ML Stack Built date: 2017-12-21 slug: introducing-kubeflow-composable url: /blog/2017/12/Introducing-Kubeflow-Composable +author: > + Jeremy Lewi (Google), + David Aronchick (Google) --- -**_Today’s post is by David Aronchick and Jeremy Lewi, a PM and Engineer on the Kubeflow project, a new open source GitHub repo dedicated to making using machine learning (ML) stacks on Kubernetes easy, fast and extensible._** - - - ## Kubernetes and Machine Learning Kubernetes has quickly become the hybrid solution for deploying complicated workloads anywhere. While it started with just stateless services, customers have begun to move complex workloads to the platform, taking advantage of rich APIs, reliability and performance provided by Kubernetes. One of the fastest growing use cases is to use Kubernetes as the deployment platform of choice for machine learning. @@ -168,8 +167,6 @@ And we’re just getting started! We would love for you to help. How you might a - Please download and run kubeflow, and submit bugs! Thank you for your support so far, we could not be more excited! -_Jeremy Lewi & David Aronchick_ -Google Note: * This article was amended in June 2023 to update the trained model bucket location. diff --git a/content/en/blog/_posts/2017-12-00-Kubernetes-19-Workloads-Expanded-Ecosystem.md b/content/en/blog/_posts/2017-12-00-Kubernetes-19-Workloads-Expanded-Ecosystem.md index cefcf21452095..b5440b9a43f17 100644 --- a/content/en/blog/_posts/2017-12-00-Kubernetes-19-Workloads-Expanded-Ecosystem.md +++ b/content/en/blog/_posts/2017-12-00-Kubernetes-19-Workloads-Expanded-Ecosystem.md @@ -4,10 +4,10 @@ date: 2017-12-15 slug: kubernetes-19-workloads-expanded-ecosystem url: /blog/2017/12/Kubernetes-19-Workloads-Expanded-Ecosystem evergreen: true +author: > + [Kubernetes v1.9 Release Team](https://github.com/kubernetes/sig-release/blob/master/releases/release-1.9/release_team.md) --- -**Authors:** Kubernetes v1.9 release team - We’re pleased to announce the delivery of Kubernetes 1.9, our fourth and final release this year. Today’s release continues the evolution of an increasingly rich feature set, more robust stability, and even greater community contributions. As the fourth release of the year, it gives us an opportunity to look back at the progress made in key areas. Particularly notable is the advancement of the Apps Workloads API to stable. This removes any reservations potential adopters might have had about the functional stability required to run mission-critical workloads. Another big milestone is the beta release of Windows support, which opens the door for many Windows-specific applications and workloads to run in Kubernetes, significantly expanding the implementation scenarios and enterprise readiness of Kubernetes. diff --git a/content/en/blog/_posts/2017-12-00-Paddle-Paddle-Fluid-Elastic-Learning.md b/content/en/blog/_posts/2017-12-00-Paddle-Paddle-Fluid-Elastic-Learning.md index a4169f8f7ffd2..b8c36c2b7b55b 100644 --- a/content/en/blog/_posts/2017-12-00-Paddle-Paddle-Fluid-Elastic-Learning.md +++ b/content/en/blog/_posts/2017-12-00-Paddle-Paddle-Fluid-Elastic-Learning.md @@ -3,8 +3,16 @@ title: " PaddlePaddle Fluid: Elastic Deep Learning on Kubernetes " date: 2017-12-06 slug: paddle-paddle-fluid-elastic-learning url: /blog/2017/12/Paddle-Paddle-Fluid-Elastic-Learning +author: > + Xu Yan (Baidu Research), + Helin Wang (Baidu Research), + Yi Wu (Baidu Research), + Xi Chen (Baidu Research), + Weibao Gong (Baidu Research), + Xiang Li (CoreOS), + Yi Wang (Baidu Research) --- -_Editor's note: Today's post is a joint post from the deep learning team at Baidu and the etcd team at CoreOS._ +_**Editor's note:** Today's post is a joint post from the deep learning team at Baidu and the etcd team at CoreOS_ @@ -39,11 +47,4 @@ In the second test, each experiment ran 400 Nginx pods, which has higher priorit We continue to work on FluidEDL and welcome comments and contributions. Visit the [PaddlePaddle repo](https://github.com/PaddlePaddle/cloud), where you can find the [design doc](https://github.com/PaddlePaddle/cloud/tree/develop/doc/design), a [simple tutorial](https://github.com/PaddlePaddle/cloud/blob/develop/doc/autoscale/example/autoscale.md), and [experiment details](https://github.com/PaddlePaddle/cloud/tree/develop/doc/edl/experiment). -- Xu Yan (Baidu Research) -- Helin Wang (Baidu Research) -- Yi Wu (Baidu Research) -- Xi Chen (Baidu Research) -- Weibao Gong (Baidu Research) -- Xiang Li (CoreOS) -- Yi Wang (Baidu Research) diff --git a/content/en/blog/_posts/2018-07-24-cpu-manager.md b/content/en/blog/_posts/2018-07-24-cpu-manager.md index 0f2f47e0846ea..896216ff39046 100644 --- a/content/en/blog/_posts/2018-07-24-cpu-manager.md +++ b/content/en/blog/_posts/2018-07-24-cpu-manager.md @@ -3,8 +3,8 @@ layout: blog title: "Feature Highlight: CPU Manager" date: 2018-07-24 author: > - [Balaji Subramaniam]((mailto:balaji.subramaniam@intel.com)) (Intel), - [Connor Doyle](mailto:connor.p.doyle@intel.com) (Intel]) + [Balaji Subramaniam](mailto:balaji.subramaniam@intel.com) (Intel), + [Connor Doyle](mailto:connor.p.doyle@intel.com) (Intel) --- This blog post describes the [CPU Manager](/docs/tasks/administer-cluster/cpu-management-policies/), a beta feature in [Kubernetes](https://kubernetes.io/). The CPU manager feature enables better placement of workloads in the [Kubelet](/docs/reference/command-line-tools-reference/kubelet/), the Kubernetes node agent, by allocating exclusive CPUs to certain pod containers. diff --git a/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/future.png b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/future.png new file mode 100644 index 0000000000000..7b14992a01cdb Binary files /dev/null and b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/future.png differ diff --git a/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/index.md b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/index.md new file mode 100644 index 0000000000000..1cac0a7c5ca21 --- /dev/null +++ b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/index.md @@ -0,0 +1,196 @@ +--- +layout: blog +title: "10 Years of Kubernetes" +date: 2024-06-06 +slug: 10-years-of-kubernetes +author: > + [Bob Killen](https://github.com/mrbobbytables) (CNCF), + [Chris Short](https://github.com/chris-short) (AWS), + [Frederico Muñoz](https://github.com/fsmunoz) (SAS), + [Kaslin Fields](https://github.com/kaslin) (Google), + [Tim Bannister](https://github.com/sftim) (The Scale Factory), + and every contributor across the globe +--- +![KCSEU 2024 group photo](kcseu2024.jpg) + +Ten (10) years ago, on June 6th, 2014, the +[first commit](https://github.com/kubernetes/kubernetes/commit/2c4b3a562ce34cddc3f8218a2c4d11c7310e6d56) +of Kubernetes was pushed to GitHub. That first commit with 250 files and 47,501 lines of go, bash +and markdown kicked off the project we have today. Who could have predicted that 10 years later, +Kubernetes would grow to become one of the largest Open Source projects to date with over +[88,000 contributors](https://k8s.devstats.cncf.io/d/24/overall-project-statistics?orgId=1) from +more than [8,000 companies](https://www.cncf.io/reports/kubernetes-project-journey-report/), across +44 countries. + +KCSCN 2019 + +This milestone isn't just for Kubernetes but for the Cloud Native ecosystem that blossomed from +it. There are close to [200 projects](https://all.devstats.cncf.io/d/18/overall-project-statistics-table?orgId=1) +within the CNCF itself, with contributions from +[240,000+ individual contributors](https://all.devstats.cncf.io/d/18/overall-project-statistics-table?orgId=1) and +thousands more in the greater ecosystem. Kubernetes would not be where it is today without them, the +[7M+ Developers](https://www.cncf.io/blog/2022/05/18/slashdata-cloud-native-continues-to-grow-with-more-than-7-million-developers-worldwide/), +and the even larger user community that have all helped shape the ecosystem that it is today. + +## Kubernetes' beginnings - a converging of technologies + +The ideas underlying Kubernetes started well before the first commit, or even the first prototype +([which came about in 2013](/blog/2018/07/20/the-history-of-kubernetes-the-community-behind-it/)). +In the early 2000s, Moore's Law was well in effect. Computing hardware was becoming more and more +powerful at an incredibly fast rate. Correspondingly, applications were growing more and more +complex. This combination of hardware commoditization and application complexity pointed to a need +to further abstract software from hardware, and solutions started to emerge. + +Like many companies at the time, Google was scaling rapidly, and its engineers were interested in +the idea of creating a form of isolation in the Linux kernel. Google engineer Rohit Seth described +the concept in an [email in 2006](https://lwn.net/Articles/199643/): + +> We use the term container to indicate a structure against which we track and charge utilization of +system resources like memory, tasks, etc. for a Workload. + +The future of Linux containers + +In March of 2013, a 5-minute lightning talk called +["The future of Linux Containers," presented by Solomon Hykes at PyCon](https://youtu.be/wW9CAH9nSLs?si=VtK_VFQHymOT7BIB), +introduced an upcoming open source tool called "Docker" for creating and using Linux +Containers. Docker introduced a level of usability to Linux Containers that made them accessible to +more users than ever before, and the popularity of Docker, and thus of Linux Containers, +skyrocketed. With Docker making the abstraction of Linux Containers accessible to all, running +applications in much more portable and repeatable ways was suddenly possible, but the question of +scale remained. + +Google's Borg system for managing application orchestration at scale had adopted Linux containers as +they were developed in the mid-2000s. Since then, the company had also started working on a new +version of the system called "Omega." Engineers at Google who were familiar with the Borg and Omega +systems saw the popularity of containerization driven by Docker. They recognized not only the need +for an open source container orchestration system but its "inevitability," as described by Brendan +Burns in +[this blog post](/blog/2018/07/20/the-history-of-kubernetes-the-community-behind-it/). +That realization in the fall of 2013 inspired a small team to start working on a project that would +later become **Kubernetes**. That team included Joe Beda, Brendan Burns, Craig McLuckie, Ville +Aikas, Tim Hockin, Dawn Chen, Brian Grant, and Daniel Smith. + +## A decade of Kubernetes + +KubeCon EU 2017 + +Kubernetes' history begins with that historic commit on June 6th, 2014, and the subsequent +announcement of the project in a June 10th +[keynote by Google engineer Eric Brewer at DockerCon 2014](https://youtu.be/YrxnVKZeqK8?si=Q_wYBFn7dsS9H3k3) +(and its corresponding [Google blog](https://cloudplatform.googleblog.com/2014/06/an-update-on-container-support-on-google-cloud-platform.html)). + +Over the next year, a small community of +[contributors, largely from Google and Red Hat](https://k8s.devstats.cncf.io/d/9/companies-table?orgId=1&var-period_name=Before%20joining%20CNCF&var-metric=contributors), +worked hard on the project, culminating in a [version 1.0 release on July 21st, 2015](https://cloudplatform.googleblog.com/2015/07/Kubernetes-V1-Released.html). +Alongside 1.0, Google announced that Kubernetes would be donated to a newly formed branch of the +Linux Foundation called the +[Cloud Native Computing Foundation (CNCF)](https://www.cncf.io/announcements/2015/06/21/new-cloud-native-computing-foundation-to-drive-alignment-among-container-technologies/). + +Despite reaching 1.0, the Kubernetes project was still very challenging to use and +understand. Kubernetes contributor Kelsey Hightower took special note of the project's shortcomings +in ease of use and on July 7, 2016, he pushed the +[first commit of his famed "Kubernetes the Hard Way" guide](https://github.com/kelseyhightower/kubernetes-the-hard-way/commit/9d7ace8b186f6ebd2e93e08265f3530ec2fba81c). + +The project has changed enormously since its original 1.0 release; experiencing a number of big wins +such as +[Custom Resource Definitions (CRD) going GA in 1.16](/blog/2019/09/18/kubernetes-1-16-release-announcement/) +or [full dual stack support launching in 1.23](/blog/2021/12/08/dual-stack-networking-ga/) and +community "lessons learned" from the [removal of widely used beta APIs in 1.22](/blog/2021/07/14/upcoming-changes-in-kubernetes-1-22/) +or the deprecation of [Dockershim](/blog/2020/12/02/dockershim-faq/). + +Some notable updates, milestones and events since 1.0 include: + +* December 2016 - [Kubernetes 1.5](/blog/2016/12/kubernetes-1-5-supporting-production-workloads/) introduces runtime pluggability with initial CRI support and alpha Windows node support. OpenAPI also appears for the first time, paving the way for clients to be able to discover extension APIs. + * This release also introduced StatefulSets and PodDisruptionBudgets in Beta. +* April 2017 — [Introduction of Role-Based Access Controls or RBAC](/blog/2017/04/rbac-support-in-kubernetes/). +* June 2017 — In [Kubernetes 1.7](/blog/2017/06/kubernetes-1-7-security-hardening-stateful-application-extensibility-updates/), ThirdPartyResources or "TPRs" are replaced with CustomResourceDefinitions (CRDs). +* December 2017 — [Kubernetes 1.9](/blog/2017/12/kubernetes-19-workloads-expanded-ecosystem/) sees the Workloads API becoming GA (Generally Available). The release blog states: _"Deployment and ReplicaSet, two of the most commonly used objects in Kubernetes, are now stabilized after more than a year of real-world use and feedback."_ +* December 2018 — In 1.13, the Container Storage Interface (CSI) reaches GA, kubeadm tool for bootstrapping minimum viable clusters reaches GA, and CoreDNS becomes the default DNS server. +* September 2019 — [Custom Resource Definitions go GA](/blog/2019/09/18/kubernetes-1-16-release-announcement/) in Kubernetes 1.16. +* August 2020 — [Kubernetes 1.19](/blog/2016/12/kubernetes-1-5-supporting-production-workloads/) increases the support window for releases to 1 year. +* December 2020 — [Dockershim is deprecated](/blog/2020/12/18/kubernetes-1.20-pod-impersonation-short-lived-volumes-in-csi/) in 1.20 +* April 2021 — the [Kubernetes release cadence changes](/blog/2021/07/20/new-kubernetes-release-cadence/#:~:text=On%20April%2023%2C%202021%2C%20the,Kubernetes%20community's%20contributors%20and%20maintainers.) from 4 releases per year to 3 releases per year. +* July 2021 — Widely used beta APIs are [removed](/blog/2021/07/14/upcoming-changes-in-kubernetes-1-22/) in Kubernetes 1.22. +* May 2022 — Kubernetes 1.24 sees [beta APIs become disabled by default](/blog/2022/05/03/kubernetes-1-24-release-announcement/) to reduce upgrade conflicts and removal of [Dockershim](/dockershim), leading to [widespread user confusion](https://www.youtube.com/watch?v=a03Hh1kd6KE) (we've since [improved our communication!](https://github.com/kubernetes/community/tree/master/communication/contributor-comms)) +* December 2022 — In 1.26, there was a significant batch and [Job API overhaul](/blog/2022/12/29/scalable-job-tracking-ga/) that paved the way for better support for AI /ML / batch workloads. + +**PS:** Curious to see how far the project has come for yourself? Check out this [tutorial for spinning up a Kubernetes 1.0 cluster](https://github.com/spurin/kubernetes-v1.0-lab) created by community members Carlos Santana, Amim Moises Salum Knabben, and James Spurin. + +--- + +Kubernetes offers more extension points than we can count. Originally designed to work with Docker +and only Docker, now you can plug in any container runtime that adheres to the CRI standard. There +are other similar interfaces: CSI for storage and CNI for networking. And that's far from all you +can do. In the last decade, whole new patterns have emerged, such as using + +[Custom Resource Definitions](/docs/concepts/extend-kubernetes/api-extension/custom-resources/) +(CRDs) to support third-party controllers - now a huge part of the Kubernetes ecosystem. + +The community building the project has also expanded immensely over the last decade. Using +[DevStats](https://k8s.devstats.cncf.io/d/24/overall-project-statistics?orgId=1), we can see the +incredible volume of contribution over the last decade that has made Kubernetes the +[second-largest open source project in the world](https://www.cncf.io/reports/kubernetes-project-journey-report/): + +* **88,474** contributors +* **15,121** code committers +* **4,228,347** contributions +* **158,530** issues +* **311,787** pull requests + +## Kubernetes today + +KubeCon NA 2023 + +Since its early days, the project has seen enormous growth in technical capability, usage, and +contribution. The project is still actively working to improve and better serve its users. + +In the upcoming 1.31 release, the project will celebrate the culmination of an important long-term +project: the removal of in-tree cloud provider code. In this +[largest migration in Kubernetes history](/blog/2024/05/20/completing-cloud-provider-migration/), +roughly 1.5 million lines of code have been removed, reducing the binary sizes of core components +by approximately 40%. In the project's early days, it was clear that extensibility would be key to +success. However, it wasn't always clear how that extensibility should be achieved. This migration +removes a variety of vendor-specific capabilities from the core Kubernetes code +base. Vendor-specific capabilities can now be better served by other pluggable extensibility +features or patterns, such as +[Custom Resource Definitions (CRDs)](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/) +or API standards like the [Gateway API](https://gateway-api.sigs.k8s.io/). +Kubernetes also faces new challenges in serving its vast user base, and the community is adapting +accordingly. One example of this is the migration of image hosting to the new, community-owned +registry.k8s.io. The egress bandwidth and costs of providing pre-compiled binary images for user +consumption have become immense. This new registry change enables the community to continue +providing these convenient images in more cost- and performance-efficient ways. Make sure you check +out the [blog post](/blog/2022/11/28/registry-k8s-io-faster-cheaper-ga/) and +update any automation you have to use registry.k8s.io! + +## The future of Kubernetes + + + +A decade in, the future of Kubernetes still looks bright. The community is prioritizing changes that +both improve the user experiences, and enhance the sustainability of the project. The world of +application development continues to evolve, and Kubernetes is poised to change along with it. + +In 2024, the advent of AI changed a once-niche workload type into one of prominent +importance. Distributed computing and workload scheduling has always gone hand-in-hand with the +resource-intensive needs of Artificial Intelligence, Machine Learning, and High Performance +Computing workloads. Contributors are paying close attention to the needs of newly developed +workloads and how Kubernetes can best serve them. The new +[Serving Working Group](https://github.com/kubernetes/community/tree/master/wg-serving) is one +example of how the community is organizing to address these workloads' needs. It's likely that the +next few years will see improvements to Kubernetes' ability to manage various types of hardware, and +its ability to manage the scheduling of large batch-style workloads which are run across hardware in +chunks. + +The ecosystem around Kubernetes will continue to grow and evolve. In the future, initiatives to +maintain the sustainability of the project, like the migration of in-tree vendor code and the +registry change, will be ever more important. + +The next 10 years of Kubernetes will be guided by its users and the ecosystem, but most of all, by +the people who contribute to it. The community remains open to new contributors. You can find more +information about contributing in our New Contributor Course at +[https://k8s.dev/docs/onboarding](https://k8s.dev/docs/onboarding). + +We look forward to building the future of Kubernetes with you! + +{{< figure src="kcsna2023.jpg" alt="KCSNA 2023">}} diff --git a/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcscn2019.jpg b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcscn2019.jpg new file mode 100644 index 0000000000000..95446f4ff4346 Binary files /dev/null and b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcscn2019.jpg differ diff --git a/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcseu2024.jpg b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcseu2024.jpg new file mode 100644 index 0000000000000..43f7c2ed7c4aa Binary files /dev/null and b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcseu2024.jpg differ diff --git a/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcsna2023.jpg b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcsna2023.jpg new file mode 100644 index 0000000000000..96d318778d897 Binary files /dev/null and b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcsna2023.jpg differ diff --git a/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kubeconeu2017.jpg b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kubeconeu2017.jpg new file mode 100644 index 0000000000000..21434b355fd3e Binary files /dev/null and b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kubeconeu2017.jpg differ diff --git a/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/lts.jpg b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/lts.jpg new file mode 100644 index 0000000000000..6a8ce6f5fdc4b Binary files /dev/null and b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/lts.jpg differ diff --git a/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/welcome.jpg b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/welcome.jpg new file mode 100644 index 0000000000000..58719a07cdfc1 Binary files /dev/null and b/content/en/blog/_posts/2024-06-06-10-Years-of-Kubernetes/welcome.jpg differ diff --git a/content/en/community/special/kubernetes-10th-birthday.md b/content/en/community/special/kubernetes-10th-birthday.md new file mode 100644 index 0000000000000..10ad6a07a1d96 --- /dev/null +++ b/content/en/community/special/kubernetes-10th-birthday.md @@ -0,0 +1,13 @@ +--- +title: Kubernetes' 10th birthday +content_type: special + +display_date_start: 2024-06-06 +display_date_end: 2024-06-15 + +# Only ever included, not rendered as a page in its own right +_build: + list: never + render: false +--- +Kubernetes 10 Years diff --git a/content/en/docs/concepts/services-networking/ingress-controllers.md b/content/en/docs/concepts/services-networking/ingress-controllers.md index d8621b4f944fe..a7a91d7c70f41 100644 --- a/content/en/docs/concepts/services-networking/ingress-controllers.md +++ b/content/en/docs/concepts/services-networking/ingress-controllers.md @@ -59,6 +59,7 @@ Kubernetes as a project supports and maintains [AWS](https://github.com/kubernet works with the [NGINX](https://www.nginx.com/resources/glossary/nginx/) webserver (as a proxy). * The [ngrok Kubernetes Ingress Controller](https://github.com/ngrok/kubernetes-ingress-controller) is an open source controller for adding secure public access to your K8s services using the [ngrok platform](https://ngrok.com). * The [OCI Native Ingress Controller](https://github.com/oracle/oci-native-ingress-controller#readme) is an Ingress controller for Oracle Cloud Infrastructure which allows you to manage the [OCI Load Balancer](https://docs.oracle.com/en-us/iaas/Content/Balance/home.htm). +* [OpenNJet Ingress Controller](https://gitee.com/njet-rd/open-njet-kic) is a [OpenNJet](https://njet.org.cn/)-based ingress controller. * The [Pomerium Ingress Controller](https://www.pomerium.com/docs/k8s/ingress.html) is based on [Pomerium](https://pomerium.com/), which offers context-aware access policy. * [Skipper](https://opensource.zalando.com/skipper/kubernetes/ingress-controller/) HTTP router and reverse proxy for service composition, including use cases like Kubernetes Ingress, designed as a library to build your custom proxy. * The [Traefik Kubernetes Ingress provider](https://doc.traefik.io/traefik/providers/kubernetes-ingress/) is an diff --git a/content/en/docs/concepts/workloads/controllers/statefulset.md b/content/en/docs/concepts/workloads/controllers/statefulset.md index 54c06cfb8beba..516cb4f60c736 100644 --- a/content/en/docs/concepts/workloads/controllers/statefulset.md +++ b/content/en/docs/concepts/workloads/controllers/statefulset.md @@ -101,7 +101,7 @@ spec: terminationGracePeriodSeconds: 10 containers: - name: nginx - image: registry.k8s.io/nginx-slim:0.8 + image: registry.k8s.io/nginx-slim:0.24 ports: - containerPort: 80 name: web diff --git a/content/en/docs/concepts/workloads/pods/pod-lifecycle.md b/content/en/docs/concepts/workloads/pods/pod-lifecycle.md index 9ac411910c970..703c39d169372 100644 --- a/content/en/docs/concepts/workloads/pods/pod-lifecycle.md +++ b/content/en/docs/concepts/workloads/pods/pod-lifecycle.md @@ -81,7 +81,7 @@ Value | Description `Pending` | The Pod has been accepted by the Kubernetes cluster, but one or more of the containers has not been set up and made ready to run. This includes time a Pod spends waiting to be scheduled as well as the time spent downloading container images over the network. `Running` | The Pod has been bound to a node, and all of the containers have been created. At least one container is still running, or is in the process of starting or restarting. `Succeeded` | All containers in the Pod have terminated in success, and will not be restarted. -`Failed` | All containers in the Pod have terminated, and at least one container has terminated in failure. That is, the container either exited with non-zero status or was terminated by the system. +`Failed` | All containers in the Pod have terminated, and at least one container has terminated in failure. That is, the container either exited with non-zero status or was terminated by the system, and is not set for automatic restarting. `Unknown` | For some reason the state of the Pod could not be obtained. This phase typically occurs due to an error in communicating with the node where the Pod should be running. {{< note >}} @@ -671,4 +671,4 @@ for more details. * For detailed information about Pod and container status in the API, see the API reference documentation covering - [`status`](/docs/reference/kubernetes-api/workload-resources/pod-v1/#PodStatus) for Pod. \ No newline at end of file + [`status`](/docs/reference/kubernetes-api/workload-resources/pod-v1/#PodStatus) for Pod. diff --git a/content/en/docs/contribute/style/style-guide.md b/content/en/docs/contribute/style/style-guide.md index 07d48aebcfc2f..f0486c0575d16 100644 --- a/content/en/docs/contribute/style/style-guide.md +++ b/content/en/docs/contribute/style/style-guide.md @@ -249,11 +249,11 @@ also known as PascalCase. Do not write API kinds with code formatting. Don't split an API object name into separate words. For example, use PodTemplateList, not Pod Template List. -For more information about PascalCase and code formatting, please review the related guidance on +For more information about PascalCase and code formatting, review the related guidance on [Use upper camel case for API objects](/docs/contribute/style/style-guide/#use-upper-camel-case-for-api-objects) and [Use code style for inline code, commands, and API objects](/docs/contribute/style/style-guide/#code-style-inline-code). -For more information about Kubernetes API terminologies, please review the related +For more information about Kubernetes API terminologies, review the related guidance on [Kubernetes API terminology](/docs/reference/using-api/api-concepts/#standard-api-terminology). ## Code snippet formatting diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates/ip-tables-ownership-cleanup.md b/content/en/docs/reference/command-line-tools-reference/feature-gates/iptables-ownership-cleanup.md similarity index 100% rename from content/en/docs/reference/command-line-tools-reference/feature-gates/ip-tables-ownership-cleanup.md rename to content/en/docs/reference/command-line-tools-reference/feature-gates/iptables-ownership-cleanup.md diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates/name-generation-retries.md b/content/en/docs/reference/command-line-tools-reference/feature-gates/name-generation-retries.md index 6f654f89faa52..a2d0018e7fd3f 100644 --- a/content/en/docs/reference/command-line-tools-reference/feature-gates/name-generation-retries.md +++ b/content/en/docs/reference/command-line-tools-reference/feature-gates/name-generation-retries.md @@ -1,5 +1,5 @@ --- -title: NameGenerationRetries +title: RetryGenerateName content_type: feature_gate _build: diff --git a/content/en/docs/reference/using-api/cel.md b/content/en/docs/reference/using-api/cel.md index fd6460ea78172..28adf0bb07912 100644 --- a/content/en/docs/reference/using-api/cel.md +++ b/content/en/docs/reference/using-api/cel.md @@ -59,8 +59,8 @@ Example CEL expressions: | `self.metadata.name == 'singleton'` | Validate that an object's name matches a specific value (making it a singleton) | | `self.set1.all(e, !(e in self.set2))` | Validate that two listSets are disjoint | | `self.names.size() == self.details.size() && self.names.all(n, n in self.details)` | Validate the 'details' map is keyed by the items in the 'names' listSet | -| `self.details.all(key, key.matches('^[a-zA-Z]*$')` | Validate the keys of the 'details' map | -| `self.details.all(key, self.details[key].matches('^[a-zA-Z]*$')` | Validate the values of the 'details' map | +| `self.details.all(key, key.matches('^[a-zA-Z]*$'))` | Validate the keys of the 'details' map | +| `self.details.all(key, self.details[key].matches('^[a-zA-Z]*$'))` | Validate the values of the 'details' map | {{< /table >}} ## CEL options, language features, and libraries @@ -133,8 +133,8 @@ Examples: {{< table caption="Examples of CEL expressions using regex library functions" >}} | CEL Expression | Purpose | |-------------------------------------------------------------|----------------------------------------------------------| -| `"abc 123".find('[0-9]*')` | Find the first number in a string | -| `"1, 2, 3, 4".findAll('[0-9]*').map(x, int(x)).sum() < 100` | Verify that the numbers in a string sum to less than 100 | +| `"abc 123".find('[0-9]+')` | Find the first number in a string | +| `"1, 2, 3, 4".findAll('[0-9]+').map(x, int(x)).sum() < 100` | Verify that the numbers in a string sum to less than 100 | {{< /table >}} See the [Kubernetes regex library](https://pkg.go.dev/k8s.io/apiextensions-apiserver/pkg/apiserver/schema/cel/library#Regex) @@ -239,7 +239,7 @@ Examples: | `quantity("500000G").isInteger()` | Test if conversion to integer would throw an error | | `quantity("50k").asInteger()` | Precise conversion to integer | | `quantity("9999999999999999999999999999999999999G").asApproximateFloat()` | Lossy conversion to float | -| `quantity("50k").add("20k")` | Add two quantities | +| `quantity("50k").add(quantity("20k"))` | Add two quantities | | `quantity("50k").sub(20000)` | Subtract an integer from a quantity | | `quantity("50k").add(20).sub(quantity("100k")).sub(-50000)` | Chain adding and subtracting integers and quantities | | `quantity("200M").compareTo(quantity("0.2G"))` | Compare two quantities | diff --git a/content/en/docs/tasks/administer-cluster/configure-upgrade-etcd.md b/content/en/docs/tasks/administer-cluster/configure-upgrade-etcd.md index 3c213702afe0c..93402dd5d353f 100644 --- a/content/en/docs/tasks/administer-cluster/configure-upgrade-etcd.md +++ b/content/en/docs/tasks/administer-cluster/configure-upgrade-etcd.md @@ -342,24 +342,36 @@ Before starting the restore operation, a snapshot file must be present. It can either be a snapshot file from a previous backup operation, or from a remaining [data directory](https://etcd.io/docs/current/op-guide/configuration/#--data-dir). -When restoring the cluster, use the `--data-dir` option to specify to which folder the cluster should be restored: +{{< tabs name="etcd_restore" >}} +{{% tab name="Use etcdutl" %}} + When restoring the cluster using [`etcdutl`](https://github.com/etcd-io/etcd/blob/main/etcdutl/README.md), + use the `--data-dir` option to specify to which folder the cluster should be restored: -```shell -etcdutl --data-dir snapshot restore snapshot.db -``` -where `` is a directory that will be created during the restore process. + ```shell + etcdutl --data-dir snapshot restore snapshot.db + ``` + where `` is a directory that will be created during the restore process. -The below example depicts the usage of the `etcdctl` tool for the restore operation: -{{< note >}} -The usage of `etcdctl` for restoring has been deprecated since etcd v3.5.x and may be removed from a future etcd release. -{{< /note >}} +{{% /tab %}} +{{% tab name="Use etcdctl (Deprecated)" %}} -```shell -export ETCDCTL_API=3 -etcdctl --data-dir snapshot restore snapshot.db -``` + {{< note >}} + The usage of `etcdctl` for restoring has been **deprecated** since etcd v3.5.x and is slated for removal from etcd v3.6. + It is recommended to utilize [`etcdutl`](https://github.com/etcd-io/etcd/blob/main/etcdutl/README.md) instead. + {{< /note >}} + + The below example depicts the usage of the `etcdctl` tool for the restore operation: + + ```shell + export ETCDCTL_API=3 + etcdctl --data-dir snapshot restore snapshot.db + ``` + + If `` is the same folder as before, delete it and stop the etcd process before restoring the cluster. + Otherwise, change etcd configuration and restart the etcd process after restoration to have it use the new data directory. -If `` is the same folder as before, delete it and stop the etcd process before restoring the cluster. Otherwise, change etcd configuration and restart the etcd process after restoration to have it use the new data directory. +{{% /tab %}} +{{< /tabs >}} For more information and examples on restoring a cluster from a snapshot file, see [etcd disaster recovery documentation](https://etcd.io/docs/current/op-guide/recovery/#restoring-a-cluster). diff --git a/content/en/docs/tasks/administer-cluster/reserve-compute-resources.md b/content/en/docs/tasks/administer-cluster/reserve-compute-resources.md index fedc88f2b2757..1959002a92078 100644 --- a/content/en/docs/tasks/administer-cluster/reserve-compute-resources.md +++ b/content/en/docs/tasks/administer-cluster/reserve-compute-resources.md @@ -5,7 +5,6 @@ reviewers: - dashpole title: Reserve Compute Resources for System Daemons content_type: task -min-kubernetes-server-version: 1.8 weight: 290 --- @@ -25,10 +24,10 @@ on each node. ## {{% heading "prerequisites" %}} -{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} -Your Kubernetes server must be at or later than version 1.17 to use -the kubelet command line option `--reserved-cpus` to set an -[explicitly reserved CPU list](#explicitly-reserved-cpu-list). +{{< include "task-tutorial-prereqs.md" >}} + +You can configure below kubelet [configuration settings](/docs/reference/config-api/kubelet-config.v1beta1/) +using the [kubelet configuration file](/docs/tasks/administer-cluster/kubelet-config-file/). @@ -48,15 +47,14 @@ Resources can be reserved for two categories of system daemons in the `kubelet`. ### Enabling QoS and Pod level cgroups To properly enforce node allocatable constraints on the node, you must -enable the new cgroup hierarchy via the `--cgroups-per-qos` flag. This flag is +enable the new cgroup hierarchy via the `cgroupsPerQOS` setting. This setting is enabled by default. When enabled, the `kubelet` will parent all end-user pods under a cgroup hierarchy managed by the `kubelet`. ### Configuring a cgroup driver The `kubelet` supports manipulation of the cgroup hierarchy on -the host using a cgroup driver. The driver is configured via the -`--cgroup-driver` flag. +the host using a cgroup driver. The driver is configured via the `cgroupDriver` setting. The supported values are the following: @@ -73,21 +71,21 @@ be configured to use the `systemd` cgroup driver. ### Kube Reserved -- **Kubelet Flag**: `--kube-reserved=[cpu=100m][,][memory=100Mi][,][ephemeral-storage=1Gi][,][pid=1000]` -- **Kubelet Flag**: `--kube-reserved-cgroup=` +- **KubeletConfiguration Setting**: `kubeReserved: {}`. Example value `{cpu: 100m, memory: 100Mi, ephemeral-storage: 1Gi, pid=1000}` +- **KubeletConfiguration Setting**: `kubeReservedCgroup: ""` -`kube-reserved` is meant to capture resource reservation for kubernetes system -daemons like the `kubelet`, `container runtime`, `node problem detector`, etc. +`kubeReserved` is meant to capture resource reservation for kubernetes system +daemons like the `kubelet`, `container runtime`, etc. It is not meant to reserve resources for system daemons that are run as pods. -`kube-reserved` is typically a function of `pod density` on the nodes. +`kubeReserved` is typically a function of `pod density` on the nodes. In addition to `cpu`, `memory`, and `ephemeral-storage`, `pid` may be specified to reserve the specified number of process IDs for kubernetes system daemons. -To optionally enforce `kube-reserved` on kubernetes system daemons, specify the parent -control group for kube daemons as the value for `--kube-reserved-cgroup` kubelet -flag. +To optionally enforce `kubeReserved` on kubernetes system daemons, specify the parent +control group for kube daemons as the value for `kubeReservedCgroup` setting, +and [add `kube-reserved` to `enforceNodeAllocatable`](#enforcing-node-allocatable). It is recommended that the kubernetes system daemons are placed under a top level control group (`runtime.slice` on systemd machines for example). Each @@ -95,19 +93,19 @@ system daemon should ideally run within its own child control group. Refer to [the design proposal](https://git.k8s.io/design-proposals-archive/node/node-allocatable.md#recommended-cgroups-setup) for more details on recommended control group hierarchy. -Note that Kubelet **does not** create `--kube-reserved-cgroup` if it doesn't +Note that Kubelet **does not** create `kubeReservedCgroup` if it doesn't exist. The kubelet will fail to start if an invalid cgroup is specified. With `systemd` cgroup driver, you should follow a specific pattern for the name of the cgroup you -define: the name should be the value you set for `--kube-reserved-cgroup`, +define: the name should be the value you set for `kubeReservedCgroup`, with `.slice` appended. ### System Reserved -- **Kubelet Flag**: `--system-reserved=[cpu=100m][,][memory=100Mi][,][ephemeral-storage=1Gi][,][pid=1000]` -- **Kubelet Flag**: `--system-reserved-cgroup=` +- **KubeletConfiguration Setting**: `systemReserved: {}`. Example value `{cpu: 100m, memory: 100Mi, ephemeral-storage: 1Gi, pid=1000}` +- **KubeletConfiguration Setting**: `systemReservedCgroup: ""` -`system-reserved` is meant to capture resource reservation for OS system daemons -like `sshd`, `udev`, etc. `system-reserved` should reserve `memory` for the +`systemReserved` is meant to capture resource reservation for OS system daemons +like `sshd`, `udev`, etc. `systemReserved` should reserve `memory` for the `kernel` too since `kernel` memory is not accounted to pods in Kubernetes at this time. Reserving resources for user login sessions is also recommended (`user.slice` in systemd world). @@ -116,33 +114,32 @@ In addition to `cpu`, `memory`, and `ephemeral-storage`, `pid` may be specified to reserve the specified number of process IDs for OS system daemons. -To optionally enforce `system-reserved` on system daemons, specify the parent -control group for OS system daemons as the value for `--system-reserved-cgroup` -kubelet flag. +To optionally enforce `systemReserved` on system daemons, specify the parent +control group for OS system daemons as the value for `systemReservedCgroup` setting, +and [add `system-reserved` to `enforceNodeAllocatable`](#enforcing-node-allocatable). It is recommended that the OS system daemons are placed under a top level control group (`system.slice` on systemd machines for example). -Note that `kubelet` **does not** create `--system-reserved-cgroup` if it doesn't +Note that `kubelet` **does not** create `systemReservedCgroup` if it doesn't exist. `kubelet` will fail if an invalid cgroup is specified. With `systemd` cgroup driver, you should follow a specific pattern for the name of the cgroup you -define: the name should be the value you set for `--system-reserved-cgroup`, +define: the name should be the value you set for `systemReservedCgroup`, with `.slice` appended. ### Explicitly Reserved CPU List {{< feature-state for_k8s_version="v1.17" state="stable" >}} -**Kubelet Flag**: `--reserved-cpus=0-3` -**KubeletConfiguration Flag**: `reservedSystemCPUs: 0-3` +**KubeletConfiguration Setting**: `reservedSystemCPUs:`. Example value `0-3` -`reserved-cpus` is meant to define an explicit CPU set for OS system daemons and -kubernetes system daemons. `reserved-cpus` is for systems that do not intend to +`reservedSystemCPUs` is meant to define an explicit CPU set for OS system daemons and +kubernetes system daemons. `reservedSystemCPUs` is for systems that do not intend to define separate top level cgroups for OS system daemons and kubernetes system daemons with regard to cpuset resource. -If the Kubelet **does not** have `--system-reserved-cgroup` and `--kube-reserved-cgroup`, -the explicit cpuset provided by `reserved-cpus` will take precedence over the CPUs -defined by `--kube-reserved` and `--system-reserved` options. +If the Kubelet **does not** have `kubeReservedCgroup` and `systemReservedCgroup`, +the explicit cpuset provided by `reservedSystemCPUs` will take precedence over the CPUs +defined by `kubeReservedCgroup` and `systemReservedCgroup` options. This option is specifically designed for Telco/NFV use cases where uncontrolled interrupts/timers may impact the workload performance. you can use this option @@ -155,7 +152,7 @@ For example: in Centos, you can do this using the tuned toolset. ### Eviction Thresholds -**Kubelet Flag**: `--eviction-hard=[memory.available<500Mi]` +**KubeletConfiguration Setting**: `evictionHard: {memory.available: "100Mi", nodefs.available: "10%", nodefs.inodesFree: "5%", imagefs.available: "15%"}`. Example value: `{memory.available: "<500Mi"}` Memory pressure at the node level leads to System OOMs which affects the entire node and all pods running on it. Nodes can go offline temporarily until memory @@ -163,7 +160,7 @@ has been reclaimed. To avoid (or reduce the probability of) system OOMs kubelet provides [out of resource](/docs/concepts/scheduling-eviction/node-pressure-eviction/) management. Evictions are supported for `memory` and `ephemeral-storage` only. By reserving some memory via -`--eviction-hard` flag, the `kubelet` attempts to evict pods whenever memory +`evictionHard` setting, the `kubelet` attempts to evict pods whenever memory availability on the node drops below the reserved value. Hypothetically, if system daemons did not exist on a node, pods cannot use more than `capacity - eviction-hard`. For this reason, resources reserved for evictions are not @@ -171,7 +168,7 @@ available for pods. ### Enforcing Node Allocatable -**Kubelet Flag**: `--enforce-node-allocatable=pods[,][system-reserved][,][kube-reserved]` +**KubeletConfiguration setting**: `enforceNodeAllocatable: [pods]`. Example value: `[pods,system-reserved,kube-reserved]` The scheduler treats 'Allocatable' as the available `capacity` for pods. @@ -180,35 +177,35 @@ by evicting pods whenever the overall usage across all pods exceeds 'Allocatable'. More details on eviction policy can be found on the [node pressure eviction](/docs/concepts/scheduling-eviction/node-pressure-eviction/) page. This enforcement is controlled by -specifying `pods` value to the kubelet flag `--enforce-node-allocatable`. +specifying `pods` value to the KubeletConfiguration setting `enforceNodeAllocatable`. -Optionally, `kubelet` can be made to enforce `kube-reserved` and -`system-reserved` by specifying `kube-reserved` & `system-reserved` values in -the same flag. Note that to enforce `kube-reserved` or `system-reserved`, -`--kube-reserved-cgroup` or `--system-reserved-cgroup` needs to be specified +Optionally, `kubelet` can be made to enforce `kubeReserved` and +`systemReserved` by specifying `kube-reserved` & `system-reserved` values in +the same setting. Note that to enforce `kubeReserved` or `systemReserved`, +`kubeReservedCgroup` or `systemReservedCgroup` needs to be specified respectively. ## General Guidelines -System daemons are expected to be treated similar to -[Guaranteed pods](/docs/tasks/configure-pod-container/quality-service-pod/#create-a-pod-that-gets-assigned-a-qos-class-of-guaranteed). +System daemons are expected to be treated similar to +[Guaranteed pods](/docs/tasks/configure-pod-container/quality-service-pod/#create-a-pod-that-gets-assigned-a-qos-class-of-guaranteed). System daemons can burst within their bounding control groups and this behavior needs to be managed as part of kubernetes deployments. For example, `kubelet` should -have its own control group and share `kube-reserved` resources with the +have its own control group and share `kubeReserved` resources with the container runtime. However, Kubelet cannot burst and use up all available Node -resources if `kube-reserved` is enforced. +resources if `kubeReserved` is enforced. -Be extra careful while enforcing `system-reserved` reservation since it can lead +Be extra careful while enforcing `systemReserved` reservation since it can lead to critical system services being CPU starved, OOM killed, or unable to fork on the node. The -recommendation is to enforce `system-reserved` only if a user has profiled their +recommendation is to enforce `systemReserved` only if a user has profiled their nodes exhaustively to come up with precise estimates and is confident in their ability to recover if any process in that group is oom-killed. * To begin with enforce 'Allocatable' on `pods`. * Once adequate monitoring and alerting is in place to track kube system - daemons, attempt to enforce `kube-reserved` based on usage heuristics. -* If absolutely necessary, enforce `system-reserved` over time. + daemons, attempt to enforce `kubeReserved` based on usage heuristics. +* If absolutely necessary, enforce `systemReserved` over time. The resource requirements of kube system daemons may grow over time as more and more features are added. Over time, kubernetes project will attempt to bring @@ -222,9 +219,9 @@ So expect a drop in `Allocatable` capacity in future releases. Here is an example to illustrate Node Allocatable computation: * Node has `32Gi` of `memory`, `16 CPUs` and `100Gi` of `Storage` -* `--kube-reserved` is set to `cpu=1,memory=2Gi,ephemeral-storage=1Gi` -* `--system-reserved` is set to `cpu=500m,memory=1Gi,ephemeral-storage=1Gi` -* `--eviction-hard` is set to `memory.available<500Mi,nodefs.available<10%` +* `kubeReserved` is set to `{cpu: 1000m, memory: 2Gi, ephemeral-storage: 1Gi}` +* `systemReserved` is set to `{cpu: 500m, memory: 1Gi, ephemeral-storage: 1Gi}` +* `evictionHard` is set to `{memory.available: "<500Mi", nodefs.available: "<10%"}` Under this scenario, 'Allocatable' will be 14.5 CPUs, 28.5Gi of memory and `88Gi` of local storage. @@ -234,7 +231,7 @@ Kubelet evicts pods whenever the overall memory usage across pods exceeds 28.5Gi or if overall disk usage exceeds 88Gi. If all processes on the node consume as much CPU as they can, pods together cannot consume more than 14.5 CPUs. -If `kube-reserved` and/or `system-reserved` is not enforced and system daemons +If `kubeReserved` and/or `systemReserved` is not enforced and system daemons exceed their reservation, `kubelet` evicts pods whenever the overall node memory usage is higher than 31.5Gi or `storage` is greater than 90Gi. diff --git a/content/en/docs/tasks/manage-hugepages/scheduling-hugepages.md b/content/en/docs/tasks/manage-hugepages/scheduling-hugepages.md index 2bae4e6c9bff5..ce0925a109db0 100644 --- a/content/en/docs/tasks/manage-hugepages/scheduling-hugepages.md +++ b/content/en/docs/tasks/manage-hugepages/scheduling-hugepages.md @@ -7,7 +7,7 @@ description: Configure and manage huge pages as a schedulable resource in a clus --- -{{< feature-state state="stable" >}} +{{< feature-state feature_gate_name="HugePages" >}} Kubernetes supports the allocation and consumption of pre-allocated huge pages by applications in a Pod. This page describes how users can consume huge pages. diff --git a/content/en/docs/tutorials/hello-minikube.md b/content/en/docs/tutorials/hello-minikube.md index 3e20defe9bdfe..f1d43391d5f20 100644 --- a/content/en/docs/tutorials/hello-minikube.md +++ b/content/en/docs/tutorials/hello-minikube.md @@ -141,7 +141,7 @@ recommended way to manage the creation and scaling of Pods. kubectl config view ``` -1. View application logs for a container in a pod. +1. View application logs for a container in a pod (replace pod name with the one you got from `kubectl get pods`). ```shell kubectl logs hello-node-5f76cf6ccf-br9b5 diff --git a/content/en/docs/tutorials/stateful-application/basic-stateful-set.md b/content/en/docs/tutorials/stateful-application/basic-stateful-set.md index 35af85aef743a..4fe4bb864f36c 100644 --- a/content/en/docs/tutorials/stateful-application/basic-stateful-set.md +++ b/content/en/docs/tutorials/stateful-application/basic-stateful-set.md @@ -593,7 +593,7 @@ In one terminal window, patch the `web` StatefulSet to change the container image again: ```shell -kubectl patch statefulset web --type='json' -p='[{"op": "replace", "path": "/spec/template/spec/containers/0/image", "value":"registry.k8s.io/nginx-slim:0.8"}]' +kubectl patch statefulset web --type='json' -p='[{"op": "replace", "path": "/spec/template/spec/containers/0/image", "value":"registry.k8s.io/nginx-slim:0.24"}]' ``` ``` statefulset.apps/web patched @@ -661,9 +661,9 @@ Get the Pods to view their container images: for p in 0 1 2; do kubectl get pod "web-$p" --template '{{range $i, $c := .spec.containers}}{{$c.image}}{{end}}'; echo; done ``` ``` -registry.k8s.io/nginx-slim:0.8 -registry.k8s.io/nginx-slim:0.8 -registry.k8s.io/nginx-slim:0.8 +registry.k8s.io/nginx-slim:0.24 +registry.k8s.io/nginx-slim:0.24 +registry.k8s.io/nginx-slim:0.24 ``` @@ -705,7 +705,7 @@ Patch the StatefulSet again to change the container image that this StatefulSet uses: ```shell -kubectl patch statefulset web --type='json' -p='[{"op": "replace", "path": "/spec/template/spec/containers/0/image", "value":"registry.k8s.io/nginx-slim:0.7"}]' +kubectl patch statefulset web --type='json' -p='[{"op": "replace", "path": "/spec/template/spec/containers/0/image", "value":"registry.k8s.io/nginx-slim:0.21"}]' ``` ``` statefulset.apps/web patched @@ -740,7 +740,7 @@ Get the Pod's container image: kubectl get pod web-2 --template '{{range $i, $c := .spec.containers}}{{$c.image}}{{end}}' ``` ``` -registry.k8s.io/nginx-slim:0.8 +registry.k8s.io/nginx-slim:0.24 ``` Notice that, even though the update strategy is `RollingUpdate` the StatefulSet @@ -790,7 +790,7 @@ Get the Pod's container: kubectl get pod web-2 --template '{{range $i, $c := .spec.containers}}{{$c.image}}{{end}}' ``` ``` -registry.k8s.io/nginx-slim:0.7 +registry.k8s.io/nginx-slim:0.21 ``` @@ -834,7 +834,7 @@ Get the `web-1` Pod's container image: kubectl get pod web-1 --template '{{range $i, $c := .spec.containers}}{{$c.image}}{{end}}' ``` ``` -registry.k8s.io/nginx-slim:0.8 +registry.k8s.io/nginx-slim:0.24 ``` `web-1` was restored to its original configuration because the Pod's ordinal @@ -892,9 +892,9 @@ Get the container image details for the Pods in the StatefulSet: for p in 0 1 2; do kubectl get pod "web-$p" --template '{{range $i, $c := .spec.containers}}{{$c.image}}{{end}}'; echo; done ``` ``` -registry.k8s.io/nginx-slim:0.7 -registry.k8s.io/nginx-slim:0.7 -registry.k8s.io/nginx-slim:0.7 +registry.k8s.io/nginx-slim:0.21 +registry.k8s.io/nginx-slim:0.21 +registry.k8s.io/nginx-slim:0.21 ``` By moving the `partition` to `0`, you allowed the StatefulSet to diff --git a/content/en/examples/application/web/web-parallel.yaml b/content/en/examples/application/web/web-parallel.yaml index a6633f476c133..3664c63c106f7 100644 --- a/content/en/examples/application/web/web-parallel.yaml +++ b/content/en/examples/application/web/web-parallel.yaml @@ -30,7 +30,7 @@ spec: spec: containers: - name: nginx - image: registry.k8s.io/nginx-slim:0.8 + image: registry.k8s.io/nginx-slim:0.24 ports: - containerPort: 80 name: web diff --git a/content/en/examples/application/web/web.yaml b/content/en/examples/application/web/web.yaml index 14e2d27e1445f..6f8f5133ffed9 100644 --- a/content/en/examples/application/web/web.yaml +++ b/content/en/examples/application/web/web.yaml @@ -29,7 +29,7 @@ spec: spec: containers: - name: nginx - image: registry.k8s.io/nginx-slim:0.7 + image: registry.k8s.io/nginx-slim:0.21 ports: - containerPort: 80 name: web diff --git a/content/es/docs/concepts/architecture/leases.md b/content/es/docs/concepts/architecture/leases.md new file mode 100644 index 0000000000000..8934f4f925598 --- /dev/null +++ b/content/es/docs/concepts/architecture/leases.md @@ -0,0 +1,106 @@ +--- +title: Leases +api_metadata: +- apiVersion: "coordination.k8s.io/v1" + kind: "Lease" +content_type: concept +weight: 30 +--- + + + +Los sistemas distribuidos suelen necesitar _leases_, que proporcionan un mecanismo para bloquear recursos compartidos +y coordinar la actividad entre los miembros de un conjunto. +En Kubernetes, el concepto de lease (arrendamiento) está representado por objetos [Lease](/docs/reference/kubernetes-api/cluster-resources/lease-v1/) +en el {{< glossary_tooltip text="grupo API" term_id="api-group" >}} de `coordination.k8s.io`, +que se utilizan para capacidades críticas del sistema, como los heartbeats del nodo y la elección del líder a nivel de componente. + + +## Heartbeats del nodo {#node-heart-beats} + +Kubernetes utiliza la API Lease para comunicar los heartbeats de los nodos kubelet al servidor API de Kubernetes. +Para cada `Nodo` , existe un objeto `Lease` con un nombre que coincide en el espacio de nombres `kube-node-lease`. +Analizando a detalle, cada hearbeat es una solicitud **update** a este objeto `Lease`, actualizando +el campo `spec.renewTime` del objeto Lease. El plano de control de Kubernetes utiliza la marca de tiempo de este campo +para determinar la disponibilidad de este «Nodo». + +Ve [Objetos Lease de nodos](/docs/concepts/architecture/nodes/#heartbeats) para más detalles. + +## Elección del líder + + +Kubernetes también utiliza Leases para asegurar que sólo una instancia de un componente se está ejecutando en un momento dado. +Esto lo utilizan componentes del plano de control como `kube-controller-manager` y `kube-scheduler` en configuraciones de +HA, donde sólo una instancia del componente debe estar ejecutándose activamente mientras las otras +instancias están en espera. + +## Identidad del servidor API + +{{< feature-state feature_gate_name="APIServerIdentity" >}} + +A partir de Kubernetes v1.26, cada `kube-apiserver` utiliza la API Lease para publicar su identidad al resto del sistema. +Aunque no es particularmente útil por sí mismo, esto proporciona un mecanismo para que los clientes +puedan descubrir cuántas instancias de `kube-apiserver` están operando el plano de control de Kubernetes. +La existencia de los objetos leases de kube-apiserver permite futuras capacidades que pueden requerir la coordinación entre +cada kube-apiserver. + +Puedes inspeccionar los leases de cada kube-apiserver buscando objetos leases en el namespace `kube-system` +con el nombre `kube-apiserver-`. También puedes utilizar el selector de etiquetas `apiserver.kubernetes.io/identity=kube-apiserver`: + +```shell +kubectl -n kube-system get lease -l apiserver.kubernetes.io/identity=kube-apiserver +``` +``` +NAME HOLDER AGE +apiserver-07a5ea9b9b072c4a5f3d1c3702 apiserver-07a5ea9b9b072c4a5f3d1c3702_0c8914f7-0f35-440e-8676-7844977d3a05 5m33s +apiserver-7be9e061c59d368b3ddaf1376e apiserver-7be9e061c59d368b3ddaf1376e_84f2a85d-37c1-4b14-b6b9-603e62e4896f 4m23s +apiserver-1dfef752bcb36637d2763d1868 apiserver-1dfef752bcb36637d2763d1868_c5ffa286-8a9a-45d4-91e7-61118ed58d2e 4m43s + +``` + + +El hash SHA256 utilizado en el nombre del lease se basa en el nombre de host del sistema operativo visto por ese servidor API. Cada kube-apiserver debe ser +configurado para utilizar un nombre de host que es único dentro del clúster. Las nuevas instancias de kube-apiserver que utilizan el mismo nombre de host +asumirán los leases existentes utilizando una nueva identidad de titular, en lugar de instanciar nuevos objetos leases. Puedes comprobar el +nombre de host utilizado por kube-apiserver comprobando el valor de la etiqueta `kubernetes.io/hostname`: + +```shell +kubectl -n kube-system get lease apiserver-07a5ea9b9b072c4a5f3d1c3702 -o yaml +``` +```yaml +apiVersion: coordination.k8s.io/v1 +kind: Lease +metadata: + creationTimestamp: "2023-07-02T13:16:48Z" + labels: + apiserver.kubernetes.io/identity: kube-apiserver + kubernetes.io/hostname: master-1 + name: apiserver-07a5ea9b9b072c4a5f3d1c3702 + namespace: kube-system + resourceVersion: "334899" + uid: 90870ab5-1ba9-4523-b215-e4d4e662acb1 +spec: + holderIdentity: apiserver-07a5ea9b9b072c4a5f3d1c3702_0c8914f7-0f35-440e-8676-7844977d3a05 + leaseDurationSeconds: 3600 + renewTime: "2023-07-04T21:58:48.065888Z" +``` + +Los leases caducados de los kube-apiservers que ya no existen son recogidos por los nuevos kube-apiservers después de 1 hora. + +Puedes desactivar el lease de identidades del servidor API desactivando la opción `APIServerIdentity` de los [interruptores de funcionalidades](/docs/reference/command-line-tools-reference/feature-gates/). + +## Cargas de trabajo {#custom-workload} + +Tu propia carga de trabajo puede definir su propio uso de los leases. Por ejemplo, puede ejecutar un +{{< glossary_tooltip term_id=controller text=controlador >}} en la que un miembro principal o líder +realiza operaciones que sus compañeros no realizan. Tú defines un Lease para que las réplicas del controlador puedan seleccionar +o elegir un líder, utilizando la API de Kubernetes para la coordinación. +Si utilizas un lease, es una buena práctica definir un nombre para el lease que esté obviamente vinculado a +el producto o componente. Por ejemplo, si tienes un componente denominado Ejemplo Foo, utilice un lease denominado +`ejemplo-foo`. + +Si un operador de clúster u otro usuario final puede desplegar varias instancias de un componente, selecciona un nombre +prefijo y elije un mecanismo (como el hash del nombre del despliegue) para evitar colisiones de nombres +para los leases. + +Puedes utilizar otro enfoque siempre que consigas el mismo resultado: los distintos productos de software no entren en conflicto entre sí. \ No newline at end of file diff --git a/content/fr/docs/concepts/services-networking/ingress.md b/content/fr/docs/concepts/services-networking/ingress.md index 140b15715dc90..4001986300525 100644 --- a/content/fr/docs/concepts/services-networking/ingress.md +++ b/content/fr/docs/concepts/services-networking/ingress.md @@ -447,8 +447,8 @@ Suivez [SIG network](https://github.com/kubernetes/community/tree/master/sig-net Vous pouvez exposer un service de plusieurs manières sans impliquer directement la ressource Ingress : -* Utilisez [Service.Type=LoadBalancer](/docs/concepts/services-networking/service/#loadbalancer) -* Utilisez [Service.Type=NodePort](/docs/concepts/services-networking/service/#nodeport) +* Utilisez [Service.Type=LoadBalancer](/fr/docs/concepts/services-networking/service/#loadbalancer) +* Utilisez [Service.Type=NodePort](/fr/docs/concepts/services-networking/service/#type-nodeport) * Utilisez un [Proxy du port](https://git.k8s.io/contrib/for-demos/proxy-to-service) diff --git a/content/fr/docs/reference/glossary/index.md b/content/fr/docs/reference/glossary/index.md new file mode 100644 index 0000000000000..e0f376d548d0d --- /dev/null +++ b/content/fr/docs/reference/glossary/index.md @@ -0,0 +1,13 @@ +--- +title: Glossaire de termes +layout: glossary +noedit: true +body_class: glossary +default_active_tag: fundamental +weight: 5 +card: + name: reference + weight: 10 + title: Glossaire +--- + diff --git a/content/fr/docs/tasks/access-application-cluster/service-access-application-cluster.md b/content/fr/docs/tasks/access-application-cluster/service-access-application-cluster.md index b24d0b1da6e68..2a7108fc4cfe7 100644 --- a/content/fr/docs/tasks/access-application-cluster/service-access-application-cluster.md +++ b/content/fr/docs/tasks/access-application-cluster/service-access-application-cluster.md @@ -129,7 +129,9 @@ Voici le fichier de configuration pour le déploiement de l'application : réponse à une requête réussie est un message de bienvenue : ```none - Hello Kubernetes! + Hello, world! + Version: 2.0.0 + Hostname: hello-world-2895499144-bsbk5 ``` ## Utilisation d'un fichier de configuration de service diff --git a/content/fr/examples/service/access/hello-application.yaml b/content/fr/examples/service/access/hello-application.yaml index 1cf41313c5dde..24270db9c9e6b 100644 --- a/content/fr/examples/service/access/hello-application.yaml +++ b/content/fr/examples/service/access/hello-application.yaml @@ -14,7 +14,7 @@ spec: spec: containers: - name: hello-world - image: gcr.io/google-samples/node-hello:1.0 + image: us-docker.pkg.dev/google-samples/containers/gke/hello-app:2.0 ports: - containerPort: 8080 protocol: TCP diff --git a/content/hi/docs/tutorials/configuration/configure-java-microservice/configure-java-microservice.md b/content/hi/docs/tutorials/configuration/configure-java-microservice/configure-java-microservice.md new file mode 100644 index 0000000000000..5e8646f9d187d --- /dev/null +++ b/content/hi/docs/tutorials/configuration/configure-java-microservice/configure-java-microservice.md @@ -0,0 +1,67 @@ +--- +title: "माइक्रोप्रोफाइल, कॉन्फिगमैप्स और सीक्रेट्स का उपयोग करके कॉन्फिगरेशन को बाह्यीकृत करना" +content_type: ट्यूटोरियल +weight: 10 +--- + + + +इस ट्यूटोरियल में आप सीखेंगे कि अपने माइक्रोसर्विस के कॉन्फ़िगरेशन को कैसे और क्यों बाह्यीकृत करना है। +विशेष रूप से, आप सीखेंगे कि एनवायरमेंट वेरिएबल सेट करने के लिए कुबेरनेट्स कॉन्फिगमैप्स और सीक्रेट्स का +उपयोग कैसे करें और फिर माइक्रोप्रोफाइल कॉन्फिग का उपयोग करके उनका उपभोग करें। + + +## {{% heading "prerequisites" %}} + +### कुबेरनेट्स कॉन्फ़िगमैप्स और सीक्रेट बनाना + +कुबेरनेट्स में डॉकर कंटेनर के लिए एनवायरमेंट वेरिएबल सेट करने के कई तरीके हैं, जिनमें शामिल हैं: Dockerfile, +kubernetes.yml, Kubernetes ConfigMaps, और Kubernetes Secrets। ट्यूटोरियल में, आप सीखेंगे कि अपने +एनवायरमेंट वेरिएबल सेट करने के लिए कुबेरनेट्स कॉन्फिगमैप्स और कुबेरनेट्स सीक्रेट्स का उपयोग कैसे करें, जिनके वैल्यू +आपके माइक्रोसर्विसेज में इंजेक्ट किए जाएंगे। कॉन्फिगमैप्स और सीक्रेट्स का उपयोग करने का एक लाभ यह है कि +उन्हें कई कंटेनरों में फिर से उपयोग किया जा सकता है, जिसमें विभिन्न कंटेनरों के लिए अलग-अलग एनवायरमेंट वेरिएबल +को सौंपा जाना भी शामिल है। + +कॉन्फिगमैप्स एपीआई ऑब्जेक्ट हैं जो गैर-गोपनीय key-value जोड़े को संग्रहीत करते हैं। +इंटरएक्टिव ट्यूटोरियल में आप सीखेंगे कि एप्लिकेशन के नाम को संग्रहीत करने के लिए +कॉन्फिगमैप का उपयोग कैसे करना है। कॉन्फ़िगमैप्स के संबंध में अधिक जानकारी के लिए, +आप [दस्तावेज़ यहाँ पा सकते हैं](/docs/tasks/configure-pod-container/configure-pod-configmap/))। + +हालाँकि सीक्रेट्स का उपयोग भी key-value जोड़े को संग्रहीत करने के लिए किया जाता है, +वे कॉन्फिगमैप्स से भिन्न होते हैं क्योंकि वे गोपनीय/संवेदनशील जानकारी के लिए होते हैं और Base64 एन्कोडिंग +का उपयोग करके संग्रहीत होते हैं। यह सीक्रेट को क्रेडेंशियल्स, keys और टोकन जैसी चीज़ों को संग्रहीत करने +के लिए उपयुक्त विकल्प बनाता है, जिनमें से पहला काम आप इंटरैक्टिव ट्यूटोरियल में करेंगे। सीक्रेट के बारे +में अधिक जानकारी के लिए, आप [दस्तावेज़ यहाँ पा सकते हैं](/docs/concepts/configuration/secret/)। + +### कोड से कॉन्फ़िग को बाह्यीकृत करना + +बाह्यीकृत एप्लिकेशन कॉन्फ़िगरेशन उपयोगी है क्योंकि कॉन्फ़िगरेशन आमतौर पर आपके वातावरण के आधार पर +बदलता है। इसे पूरा करने के लिए, हम Java के Contexts and Dependency Injection (CDI) और माइक्रोप्रोफाइल +कॉन्फ़िगरेशन का उपयोग करेंगे। माइक्रोप्रोफाइल कॉन्फिग माइक्रोप्रोफाइल की एक विशेषता है, जो क्लाउड-नेटिव +माइक्रोसर्विसेज को विकसित करने और डेप्लॉय करने के लिए open Java प्रौद्योगिकियों का एक सेट है। + +सीडीआई (CDI) एक स्टैंडर्ड तरीका है जो एप्लिकेशन में डिपेंडेंसी इंजेक्शन (dependency injection) को आसान बनाता है। +इसकी मदद से, एप्लिकेशन को अलग-अलग हिस्सों (beans) से मिलाकर बनाया जा सकता है जो एक-दूसरे से कम जुड़े होते हैं। +इससे एप्लिकेशन को बनाना और सुधारना आसान हो जाता है। माइक्रोप्रोफाइल कॉन्फिग ऐप्स और माइक्रोसर्विसेज को एप्लिकेशन, +रनटाइम और एनवायरमेंट सहित विभिन्न स्रोतों से कॉन्फिग के गुण प्राप्त करने का एक मानक तरीका प्रदान करता है। स्रोत की +परिभाषित प्राथमिकता के आधार पर, गुणों को स्वचालित रूप से गुणों के एक सेट में संयोजित किया जाता है जिसे +एप्लिकेशन एपीआई के माध्यम से एक्सेस कर सकता है। साथ में, सीडीआई और माइक्रोप्रोफाइल का उपयोग कुबेरनेट्स +कॉन्फिगमैप्स और सीक्रेट्स से बाहरी रूप से प्रदान की गई संपत्तियों को पुनः प्राप्त करने और आपके एप्लिकेशन कोड +में इंजेक्ट करने के लिए इंटरएक्टिव ट्यूटोरियल में किया जाएगा। + +कई ओपन सोर्स फ्रेमवर्क और रनटाइम माइक्रोप्रोफाइल कॉन्फ़िगरेशन को लागू और समर्थ करते हैं। पूरे इंटरैक्टिव +ट्यूटोरियल के दौरान, आप ओपन लिबर्टी का उपयोग करेंगे, जो क्लाउड-नेटिव ऐप्स और माइक्रोसर्विसेज को बनाने +और चलाने के लिए एक फ्लेक्सिबल ओपन-सोर्स Java रनटाइम है। हालाँकि, इसके बजाय किसी भी माइक्रोप्रोफाइल +संगत रनटाइम का उपयोग किया जा सकता है। + +## {{% heading "objectives" %}} + +* एक कुबेरनेट्स कॉन्फ़िगमैप और सीक्रेट बनाएं +* माइक्रोप्रोफाइल कॉन्फ़िगरेशन का उपयोग करके माइक्रोसर्विस कॉन्फ़िगरेशन इंजेक्ट करें + + +## उदाहरण: माइक्रोप्रोफाइल, कॉन्फिगमैप्स और सीक्रेट्स का उपयोग करके कॉन्फिगरेशन को बाह्यीकृत करना + +[इंटरैक्टिव ट्यूटोरियल प्रारंभ करें](/docs/tutorials/configuration/configure-java-microservice/configure-java-microservice-interactive/) + + diff --git a/content/it/docs/reference/glossary/index.md b/content/it/docs/reference/glossary/index.md new file mode 100644 index 0000000000000..fbad7a8d65040 --- /dev/null +++ b/content/it/docs/reference/glossary/index.md @@ -0,0 +1,13 @@ +--- +title: Glossario +layout: glossary +noedit: true +body_class: glossary +default_active_tag: fundamental +weight: 5 +card: + name: reference + weight: 10 + title: Glossario +--- + diff --git a/content/ja/blog/_posts/2024-03-07-cri-o-seccomp-oci-artifacts.md b/content/ja/blog/_posts/2024-03-07-cri-o-seccomp-oci-artifacts.md index 3a4060c3925b4..f4dcd105228c5 100644 --- a/content/ja/blog/_posts/2024-03-07-cri-o-seccomp-oci-artifacts.md +++ b/content/ja/blog/_posts/2024-03-07-cri-o-seccomp-oci-artifacts.md @@ -5,7 +5,7 @@ date: 2024-03-07 slug: cri-o-seccomp-oci-artifacts --- -**著者:** Kevin Hannon (Red Hat) +**著者:** Sascha Grunert **翻訳者:** Taisuke Okamoto (IDC Frontier Inc), atoato88 (NEC Corporation), Junya Okabe (University of Tsukuba) diff --git a/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/future.png b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/future.png new file mode 100644 index 0000000000000..7b14992a01cdb Binary files /dev/null and b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/future.png differ diff --git a/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/index.md b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/index.md new file mode 100644 index 0000000000000..39a9692892057 --- /dev/null +++ b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/index.md @@ -0,0 +1,152 @@ +--- +layout: blog +title: "Kubernetesの10年間の歴史" +date: 2024-06-06 +slug: 10-years-of-kubernetes +author: > + [Bob Killen](https://github.com/mybobbytables) (CNCF), + [Chris Short](https://github.com/chris-short) (AWS), + [Frederico Muñoz](https://github.com/fsmunoz) (SAS), + [Kaslin Fields](https://github.com/kaslin) (Google), + [Tim Bannister](https://github.com/sftim) (The Scale Factory), + and every contributor across the globe +--- +**翻訳者**: [Junya Okabe](https://github.com/Okabe-Junya) (University of Tsukuba), [Daiki Hayakawa(bells17)](https://github.com/bells17) ([3-shake Inc.](https://3-shake.com/en/)), [Kaito Ii](https://github.com/kaitoii11) (Hewlett Packard Enterprise) + +![KCSEU 2024 group photo](kcseu2024.jpg) + +10年前の2014年6月6日、Kubernetesの[最初のコミット](https://github.com/kubernetes/kubernetes/commit/2c4b3a562ce34cddc3f8218a2c4d11c7310e6d56)がGitHubにプッシュされました。 +Go、Bash、Markdownで書かれた250のファイルと47,501行のコードを含むその最初のコミットが、今日のKubernetesプロジェクトの始まりでした。 +それから10年後の今日、Kubernetesが44か国から[8,000社以上の企業](https://www.cncf.io/reports/kubernetes-project-journey-report/)、[88,000人以上のコントリビューター](https://k8s.devstats.cncf.io/d/24/overall-project-statistics?orgId=1)を有する、これまでで最大のオープンソースプロジェクトの一つに成長するとは誰が予想したでしょうか。 + +KCSCN 2019 + +このマイルストーンはKubernetesだけでなく、そこから生まれたクラウドネイティブエコシステムにとっても重要なものです。 +CNCFには[約200のプロジェクト](https://all.devstats.cncf.io/d/18/overall-project-statistics-table?orgId=1)があり、[240,000人以上のコントリビューター](https://all.devstats.cncf.io/d/18/overall-project-statistics-table?orgId=1)からのコントリビューションがあります。 +また、より広いエコシステムの中でも数千人のコントリビューターがいます。 +Kubernetesが今日の姿になれたのは、彼らや[700万人以上の開発者](https://www.cncf.io/blog/2022/05/18/slashdata-cloud-native-continues-to-grow-with-more-than-7-million-developers-worldwide/)、さらに多くのユーザーコミュニティがエコシステムを形作る手助けをしてくれたおかげです。 + +## Kubernetesの始まり - 技術の収束 + +Kubernetesの元となるアイディアは、([2013年に登場した](https://blog/2018/07/20/the-history-of-kubernetes-the-community-behind-it/))最初のコミットや最初のプロトタイプの前から存在していました。 +2000年代初頭、ムーアの法則が有効に機能していました。 +コンピューティングハードウェアは非常に速い速度でますます強力になり、それに対応してアプリケーションもますます複雑化していきました。 +このハードウェアのコモディティ化とアプリケーションの複雑化の組み合わせにより、ソフトウェアをハードウェアからさらに抽象化する必要が生じ、解決策が現れ始めました。 + +当時の多くの企業と同様にGoogleも急速に拡大しており、同社のエンジニアたちはLinuxカーネル内での隔離の形態を作り出すというアイデアに興味を持っていました。 +Googleのエンジニア、Rohit Sethはそのコンセプトを[2006年のメール](https://lwn.net/Articles/199643/)で説明しました。 + +> ワークロードのメモリやタスクなどのシステムリソースの使用を追跡し、課金する構造を示すためにコンテナという用語を使用します。 + +The future of Linux containers + +2013年3月、PyConでSolomon Hykesが行った5分間のライトニングトーク[The future of Linux Containers](https://youtu.be/wW9CAH9nSLs?si=VtK_VFQHymOT7BIB)では、Linuxコンテナを作成および使用するためのオープンソースツールである「Docker」が紹介されました。 +DockerはLinuxコンテナに使いやすさをもたらし、これまで以上に多くのユーザーが利用できるようになりました。 +Dockerの人気が急上昇し、Linuxコンテナの抽象化を誰もが利用できるようにしたことで、アプリケーションをより移植性が高く、再現性のある方法で実行できるようになりました。 +しかし、依然としてスケールの問題は残っていました。 + +Googleのアプリケーションオーケストレーションをスケールで管理するBorgシステムは、2000年代半ばにLinuxコンテナを採用しました。 +その後、GoogleはOmegaと呼ばれるシステムの新バージョンの開発も開始しました。 +BorgとOmegaシステムに精通していたGoogleのエンジニアたちは、Dockerによって駆動するコンテナ化の人気を目の当たりにしました。 +そしてBrendan Burnsの[ブログ](/blog/2018/07/20/the-history-of-kubernetes-the-community-behind-it/)で説明されているように、オープンソースのコンテナオーケストレーションシステムの必要性だけでなく、その「必然性」を認識しました。 +この認識は2013年秋にJoe Beda、Brendan Burns、Craig McLuckie、Ville Aikas、Tim Hockin、Dawn Chen、Brian Grant、Daniel Smithを含む小さなチームにKubernetesのプロジェクトを始めるインスピレーションを与えました。 + +## Kubernetesの10年間 + +KubeCon EU 2017 + +Kubernetesの歴史は2014年6月6日のその歴史的なコミットと、2014年6月10日の[DockerCon 2014でのGoogleエンジニアEric Brewerによる基調講演](https://youtu.be/YrxnVKZeqK8?si=Q_wYBFn7dsS9H3k3)(およびそれに対応する[Googleブログ](https://cloudplatform.googleblog.com/2014/06/an-update-on-container-support-on-google-cloud-platform.html))でのプロジェクト発表から始まります。 + +その後の1年間で、主に[GoogleとRed Hatからのコントリビューター](https://k8s.devstats.cncf.io/d/9/companies-table?orgId=1&var-period_name=Before%20joining%20CNCF&var-metric=contributors)による小さなコミュニティがプロジェクトに取り組み、[2015年7月21日にバージョン1.0のリリース](https://cloudplatform.googleblog.com/2015/07/Kubernetes-V1-Released.html)に至りました。 +1.0と同時に、GoogleはKubernetesをLinux Foundationの新たに設立された部門である[Cloud Native Computing Foundation (CNCF)](https://www.cncf.io/announcements/2015/06/21/new-cloud-native-computing-foundation-to-drive-alignment-among-container-technologies/)に寄贈することを発表しました。 + +1.0に到達したものの、Kubernetesプロジェクトは依然として使いにくく理解しにくいものでした。 +KubernetesのコントリビューターであるKelsey Hightowerはプロジェクトの使いやすさの欠点に特に注目し、2016年7月7日に彼の有名な["Kubernetes the Hard Way"ガイドの最初のコミット](https://github.com/kelseyhightower/kubernetes-the-hard-way/commit/9d7ace8b186f6ebd2e93e08265f3530ec2fba81c)をプッシュしました。 + +プロジェクトは最初の1.0リリース以来大きく変わり、いくつかの大きな成果を経験しました。 +たとえば、[1.16でのCustom Resource Definition (CRD)のGA](https://kubernetes.io/blog/2019/09/18/kubernetes-1-16-release-announcement/)や、[1.23での完全なデュアルスタックサポートの開始](https://kubernetes.io/blog/2021/12/08/dual-stack-networking-ga/)などです。 +また、[1.22での広く使用されているベータ版APIの削除](https://kubernetes.io/blog/2021/07/14/upcoming-changes-in-kubernetes-1-22/)や、[Dockershimの廃止](https://kubernetes.io/blog/2020/12/02/dockershim-faq/)から学んだコミュニティの「教訓」もあります。 + +1.0以降の注目すべきアップデート、マイルストーン、およびイベントには以下のものがあります。 + +* 2016年12月 - [Kubernetes 1.5](/blog/2016/12/kubernetes-1-5-supporting-production-workloads/)でCRIの最初のサポートとアルファ版Windowsノードサポートによるランタイムプラグイン機能が導入されました。また、OpenAPIが初めて登場し、クライアントが拡張されたAPIを認識できるようになりました。 + * このリリースでは、StatefulSetとPodDisruptionBudgetがベータ版で導入されました。 +* 2017年4月 - [ロールベースアクセス制御(RBAC)](/blog/2017/04/rbac-support-in-kubernetes/)の導入。 +* 2017年6月 - [Kubernetes 1.7](/blog/2017/06/kubernetes-1-7-security-hardening-stateful-application-extensibility-updates/)でThirdPartyResource (TPR)がCustomResourceDefinition (CRD)に置き換えられました。 +* 2017年12月 - [Kubernetes 1.9](/blog/2017/12/kubernetes-19-workloads-expanded-ecosystem/)ではWorkload APIがGA(一般提供)となりました。リリースブログには「Kubernetesで最もよく使用されるオブジェクトの一つであるDeploymentとReplicaSetは、1年以上の実際の使用とフィードバックを経て安定しました」と書かれています。 +* 2018年12月 - Kubernetes 1.13でContainer Storage Interface (CSI)がGAに達しました。また最小限のクラスターをブートストラップするためのkubeadmツールがGAに達し、CoreDNSがデフォルトのDNSサーバーとなりました。 +* 2019年9月 - Kubernetes 1.16で[Custom Resource DefinitionがGAに達し](https://kubernetes.io/blog/2019/09/18/kubernetes-1-16-release-announcement/)ました。 +* 2020年8月 - [Kubernetes 1.19](/blog/2016/12/kubernetes-1-5-supporting-production-workloads/)でリリースのサポート期間が1年に延長されました。 +* 2020年12月 - Kubernetes 1.20で[Dockershimが廃止](https://kubernetes.io/blog/2020/12/18/kubernetes-1.20-pod-impersonation-short-lived-volumes-in-csi/)されました。 +* 2021年4月 - [Kubernetesのリリース頻度が変更](https://kubernetes.io/blog/2021/07/20/new-kubernetes-release-cadence/#:~:text=On%20April%2023%2C%202021%2C%20the,Kubernetes%20community's%20contributors%20and%20maintainers.)され、年間4回から3回に減少されました。 +* 2021年7月 - 広く使用されているベータ版APIが[Kubernetes 1.22で削除](https://kubernetes.io/blog/2021/07/14/upcoming-changes-in-kubernetes-1-22/)されました。 +* 2022年5月 - Kubernetes 1.24で[ベータ版APIがデフォルトで無効](https://kubernetes.io/blog/2022/05/03/kubernetes-1-24-release-announcement/)にされ、アップグレードの競合を減らすとともに[Dockershimが削除](https://kubernetes.io/dockershim)されました。その結果、[多くのユーザーの混乱](https://www.youtube.com/watch?v=a03Hh1kd6KE)を引き起こしました(その後、[コミュニケーションを改善しました](https://github.com/kubernetes/community/tree/master/communication/contributor-comms))。 +* 2022年12月 - Kubernetes 1.26ではAI/ML/バッチワークロードのサポートを強化するための大規模なバッチおよび[Job APIのオーバーホール](https://kubernetes.io/blog/2022/12/29/scalable-job-tracking-ga/)が行われました。 + +**PS:** プロジェクトがどれだけ進化したか自分で見てみたいですか? +コミュニティメンバーのCarlos Santana、Amim Moises Salum Knabben、James Spurinが作成した[Kubernetes 1.0クラスターを立ち上げるためのチュートリアル](https://github.com/spurin/kubernetes-v1.0-lab)をチェックしてみてください。 + +--- + +Kubernetesには数え切れないほどの拡張するポイントがあります。 +もともとはDocker専用に設計されていましたが、現在ではCRI標準に準拠する任意のコンテナランタイムをプラグインできます。 +他にもストレージ用のCSIやネットワーキング用のCNIなどのインターフェースがあります。 +そしてこれはできることのほんの一部に過ぎません。 +過去10年間で新しいパターンがいくつも登場しました。 +例えば、[Custom Resource Definition](/ja/docs/concepts/extend-kubernetes/api-extension/custom-resources/) (CRD)を使用してサードパーティのコントローラーをサポートすることができます。 +これは現在Kubernetesエコシステムの大きな一部となっています。 + +このプロジェクトを構築するコミュニティも、この10年間で非常に大きくなりました。 +[DevStats](https://k8s.devstats.cncf.io/d/24/overall-project-statistics?orgId=1)を使用すると、この10年間でKubernetesを[世界で2番目に大きなオープンソースプロジェクト](https://www.cncf.io/reports/kubernetes-project-journey-report/)にした驚異的なコントリビューションの量を確認できます。 + +* **88,474**人のコントリビューター +* **15,121**人のコードコミッター +* **4,228,347**件のコントリビューション +* **158,530**件のIssue +* **311,787**件のPull Request + +## 今日のKubernetes + +KubeCon NA 2023 + +初期の頃からこのプロジェクトは技術的能力、利用状況、およびコントリビューションの面で驚異的な成長を遂げてきました。 +プロジェクトは今もなおユーザーにより良いサービスを提供するために積極的に改善に取り組んでいます。 + +次回の1.31リリースでは、長期にわたる重要なプロジェクトの完成を祝います。 +それはインツリークラウドプロバイダーのコードの削除です。 +この[Kubernetesの歴史上最大のマイグレーション](https://kubernetes.io/blog/2024/05/20/completing-cloud-provider-migration/)では、約150万行のコードが削除され、コアコンポーネントのバイナリサイズが約40%削減されました。 +プロジェクトの初期には、拡張性が成功の鍵であることは明らかでした。 +しかし、その拡張性をどのように実現するかは常に明確ではありませんでした。 +このマイグレーションにより、Kubernetesの核となるコードベースからさまざまなベンダー固有の機能が削除されました。 +ベンダー固有の機能は、今後は[Custom Resource Definition (CRD)](/ja/docs/concepts/extend-kubernetes/api-extension/custom-resources/)や[Gateway API](https://gateway-api.sigs.k8s.io/)などの他のプラグイン拡張機能やパターンによってよりよく提供されるようになります。 + +Kubernetesは、膨大なユーザーベースにサービスを提供する上で新たな課題にも直面しており、コミュニティはそれに適応しています。 +その一例が、新しいコミュニティ所有のregistry.k8s.ioへのイメージホスティングの移行です。 +ユーザーに事前コンパイル済みのバイナリイメージを提供するためのエグレスの帯域幅とコストは非常に大きなものとなっています。 +この新しいレジストリの変更により、コミュニティはこれらの便利なイメージをよりコスト効率およびパフォーマンス効率の高い方法で提供し続けることができます。 +必ず[ブログ記事](https://kubernetes.io/blog/2022/11/28/registry-k8s-io-faster-cheaper-ga/)をチェックし、registry.k8s.ioを使用するように更新してください! + +## Kubernetesの未来 + + + +10年が経ち、Kubernetesの未来は依然として明るく見えます。 +コミュニティはユーザー体験の改善とプロジェクトの持続可能性を向上させる変更を優先しています。 +アプリケーション開発の世界は進化し続けており、Kubernetesもそれに合わせて変化していく準備ができています。 + +2024年にはAIの登場がかつてニッチなワークロードタイプを重要なものへと変えました。 +分散コンピューティングとワークロードスケジューリングは常に人工知能(AI)、機械学習(ML)、および高性能コンピューティング(HPC)ワークロードのリソース集約的なニーズと密接に関連してきました。 +コントリビューターは、新しく開発されたワークロードのニーズとそれらにKubernetesがどのように最適に対応できるかに注目しています。 +新しい[Serving Working Group](https://github.com/kubernetes/community/tree/master/wg-serving)は、コミュニティがこれらのワークロードのニーズに対処するためにどのように組織化されているかの一例です。 +今後数年でKubernetesがさまざまな種類のハードウェアを管理する能力や、ハードウェア全体でチャンクごとに実行される大規模なバッチスタイルのワークロードのスケジューリング能力に関して改善が見られるでしょう。 + +Kubernetesを取り巻くエコシステムは成長し続け、進化していきます。 +将来的にはインツリーベンダーコードのマイグレーションやレジストリの変更など、プロジェクトの持続可能性を維持するための取り組みがますます重要になるでしょう。 + +Kubernetesの次の10年は、ユーザーとエコシステム、そして何よりもそれに貢献する人々によって導かれるでしょう。 +コミュニティは新しいコントリビューターを歓迎しています。 +コントリビューションに関する詳細は、[新しいコントリビューター向けのガイド](https://k8s.dev/contributors)で確認できます。 + +Kubernetesの未来を一緒に築いていくことを楽しみにしています! + +{{< figure src="kcsna2023.jpg" alt="KCSNA 2023">}} diff --git a/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcscn2019.jpg b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcscn2019.jpg new file mode 100644 index 0000000000000..95446f4ff4346 Binary files /dev/null and b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcscn2019.jpg differ diff --git a/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcseu2024.jpg b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcseu2024.jpg new file mode 100644 index 0000000000000..43f7c2ed7c4aa Binary files /dev/null and b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcseu2024.jpg differ diff --git a/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcsna2023.jpg b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcsna2023.jpg new file mode 100644 index 0000000000000..96d318778d897 Binary files /dev/null and b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kcsna2023.jpg differ diff --git a/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kubeconeu2017.jpg b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kubeconeu2017.jpg new file mode 100644 index 0000000000000..21434b355fd3e Binary files /dev/null and b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/kubeconeu2017.jpg differ diff --git a/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/lts.jpg b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/lts.jpg new file mode 100644 index 0000000000000..6a8ce6f5fdc4b Binary files /dev/null and b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/lts.jpg differ diff --git a/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/welcome.jpg b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/welcome.jpg new file mode 100644 index 0000000000000..58719a07cdfc1 Binary files /dev/null and b/content/ja/blog/_posts/2024-06-06-10-Years-of-Kubernetes/welcome.jpg differ diff --git a/content/ja/docs/concepts/architecture/cgroups.md b/content/ja/docs/concepts/architecture/cgroups.md index 9ad161c183c27..822dd6baabff7 100644 --- a/content/ja/docs/concepts/architecture/cgroups.md +++ b/content/ja/docs/concepts/architecture/cgroups.md @@ -32,7 +32,7 @@ cgroup v2はリソース管理機能を強化した統合制御システムを - ページキャッシュの書き戻しといった、非即時のリソース変更 Kubernetesのいくつかの機能では、強化されたリソース管理と隔離のためにcgroup v2のみを使用しています。 -例えば、[MemoryQoS](/blog/2021/11/26/qos-memory-resources/)機能はメモリーQoSを改善し、cgroup v2の基本的な機能に依存しています。 +例えば、[MemoryQoS](/docs/concepts/workloads/pods/pod-qos/#memory-qos-with-cgroup-v2)機能はメモリーQoSを改善し、cgroup v2の基本的な機能に依存しています。 ## cgroup v2を使う {#using-cgroupv2} diff --git a/content/ja/docs/concepts/workloads/controllers/statefulset.md b/content/ja/docs/concepts/workloads/controllers/statefulset.md index 48aa86f68bc43..286ac5d135aae 100644 --- a/content/ja/docs/concepts/workloads/controllers/statefulset.md +++ b/content/ja/docs/concepts/workloads/controllers/statefulset.md @@ -142,7 +142,7 @@ Cluster Domain | Service (ns/name) | StatefulSet (ns/name) | StatefulSet Domain ### 安定したストレージ -Kubernetesは各VolumeClaimTemplateに対して、1つの[PersistentVolume](/docs/concepts/storage/persistent-volumes/)を作成します。上記のnginxの例において、各Podは`my-storage-class`というStorageClassをもち、1GiBのストレージ容量を持った単一のPersistentVolumeを受け取ります。もしStorageClassが指定されていない場合、デフォルトのStorageClassが使用されます。PodがNode上にスケジュール(もしくは再スケジュール)されたとき、その`volumeMounts`はPersistentVolume Claimに関連したPersistentVolumeをマウントします。 +StatefulSetで定義された各VolumeClaimTemplateに対して、各Podは1つのPersistentVolumeClaimを受け取ります。上記のnginxの例において、各Podは`my-storage-class`というStorageClassをもち、1GiBのストレージ容量を持った単一のPersistentVolumeを受け取ります。もしStorageClassが指定されていない場合、デフォルトのStorageClassが使用されます。PodがNode上にスケジュール(もしくは再スケジュール)されたとき、その`volumeMounts`はPersistentVolume Claimに関連したPersistentVolumeをマウントします。 注意点として、PodのPersistentVolume Claimと関連したPersistentVolumeは、PodやStatefulSetが削除されたときに削除されません。 削除する場合は手動で行わなければなりません。 diff --git a/content/ja/docs/reference/glossary/cri-o.md b/content/ja/docs/reference/glossary/cri-o.md new file mode 100644 index 0000000000000..6acae8bc35b66 --- /dev/null +++ b/content/ja/docs/reference/glossary/cri-o.md @@ -0,0 +1,19 @@ +--- +title: CRI-O +id: cri-o +date: 2019-05-14 +full_link: https://cri-o.io/#what-is-cri-o +short_description: > + Kubernetesに特化した軽量コンテナランタイム + +aka: +tags: +- tool +--- +Kubernetes CRIと一緒にOCIコンテナランタイムを使うためのツールです。 + + + +CRI-OはOpen Container Initiative (OCI) [runtime spec](https://www.github.com/opencontainers/runtime-spec)と互換性がある{{< glossary_tooltip text="コンテナ" term_id="container" >}}ランタイムを使用できるようにするための{{< glossary_tooltip term_id="cri" >}}の実装の1つです。 + +CRI-Oのデプロイによって、Kubernetesは任意のOCI準拠のランタイムを、{{< glossary_tooltip text="Pod" term_id="pod" >}}を実行するためのコンテナランタイムとして利用することと、リモートレジストリからOCIコンテナイメージを取得することができるようになります。 diff --git a/content/ja/docs/reference/glossary/customresourcedefinition.md b/content/ja/docs/reference/glossary/customresourcedefinition.md new file mode 100644 index 0000000000000..df37d7c971c47 --- /dev/null +++ b/content/ja/docs/reference/glossary/customresourcedefinition.md @@ -0,0 +1,19 @@ +--- +title: カスタムリソース定義(Custom Resource Definitions) +id: CustomResourceDefinition +date: 2018-04-12 +full_link: /docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/ +short_description: > + 拡張APIサーバーを構築することなく、Kubernetes APIサーバーに追加するリソースを定義するカスタムコードです。 + +aka: +tags: +- fundamental +- operation +- extension +--- + 拡張APIサーバーを構築することなく、Kubernetes APIサーバーに追加するリソースを定義するカスタムコードです。 + + + +公開されているサポート対象のAPIリソースではニーズを満たせない場合、カスタムリソース定義(Custom Resource Definitions)を使用することで環境に合わせてKubernetes APIを拡張できます。 diff --git a/content/pt-br/docs/reference/glossary/index.md b/content/pt-br/docs/reference/glossary/index.md index 89cea39e442db..947fe4821701b 100644 --- a/content/pt-br/docs/reference/glossary/index.md +++ b/content/pt-br/docs/reference/glossary/index.md @@ -2,6 +2,7 @@ title: Glossário layout: glossary noedit: true +body_class: glossary default_active_tag: fundamental weight: 5 card: diff --git a/content/uk/docs/reference/glossary/index.md b/content/uk/docs/reference/glossary/index.md index fd57553ef82cd..9dadedc3617dd 100644 --- a/content/uk/docs/reference/glossary/index.md +++ b/content/uk/docs/reference/glossary/index.md @@ -6,6 +6,7 @@ approvers: title: Глосарій layout: glossary noedit: true +body_class: glossary default_active_tag: fundamental weight: 5 card: diff --git a/content/zh-cn/docs/reference/command-line-tools-reference/feature-gates/name-generation-retries.md b/content/zh-cn/docs/reference/command-line-tools-reference/feature-gates/name-generation-retries.md index 5e2a05ba20e27..35e194a0c0f04 100644 --- a/content/zh-cn/docs/reference/command-line-tools-reference/feature-gates/name-generation-retries.md +++ b/content/zh-cn/docs/reference/command-line-tools-reference/feature-gates/name-generation-retries.md @@ -1,5 +1,5 @@ --- -title: NameGenerationRetries +title: RetryGenerateName content_type: feature_gate _build: diff --git a/content/zh-cn/docs/reference/kubectl/generated/_index.md b/content/zh-cn/docs/reference/kubectl/generated/_index.md new file mode 100644 index 0000000000000..1dea8f4ec6bad --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/_index.md @@ -0,0 +1,8 @@ +--- +title: "kubectl 参考" +weight: 10 +--- + diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl.md new file mode 100644 index 0000000000000..720bcdbc824e4 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl.md @@ -0,0 +1,591 @@ +--- +title: kubectl +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +kubectl 用于控制 Kubernetes 集群管理器。 + +参阅更多细节: +https://kubernetes.io/zh-cn/docs/reference/kubectl/ + +```bash +kubectl [flags] +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中的集群名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

-h, --help

+ +kubectl 操作的帮助命令。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl annotate](../kubectl_annotate/) - 更新资源上的注解 +* [kubectl api-resources](../kubectl_api-resources/) - 打印服务器上所支持的 API 资源 +* [kubectl api-versions](../kubectl_api-versions/) - 以“组/版本”的格式输出服务端所支持的 API 版本 +* [kubectl apply](../kubectl_apply/) - 基于文件名或标准输入,将新的配置应用到资源上 +* [kubectl attach](../kubectl_attach/) - 挂接到一个正在运行的容器 + +* [kubectl auth](../kubectl_auth/) - 检查授权信息 +* [kubectl autoscale](../kubectl_autoscale/) - 对一个资源对象 + (Deployment、ReplicaSet 或 ReplicationController)进行自动扩缩 +* [kubectl certificate](../kubectl_certificate/) - 修改证书资源 +* [kubectl cluster-info](../kubectl_cluster-info/) - 显示集群信息 +* [kubectl completion](../kubectl_completion/) - 根据已经给出的 Shell(bash 或 zsh),输出 Shell 补全后的代码 +* [kubectl config](../kubectl_config/) - 修改 kubeconfig 配置文件 + +* [kubectl cordon](../kubectl_cordon/) - 标记节点为不可调度的 +* [kubectl cp](../kubectl_cp/) - 将文件和目录拷入/拷出容器 +* [kubectl create](../kubectl_create/) - 通过文件或标准输入来创建资源 +* [kubectl debug](../kubectl_debug/) - 创建用于排查工作负载和节点故障的调试会话 +* [kubectl delete](../kubectl_delete/) - 通过文件名、标准输入、资源和名字删除资源, + 或者通过资源和标签选择算符来删除资源 + +* [kubectl describe](../kubectl_describe/) - 显示某个资源或某组资源的详细信息 +* [kubectl diff](../kubectl_diff/) - 显示目前版本与将要应用的版本之间的差异 +* [kubectl drain](../kubectl_drain/) - 腾空节点,准备维护 +* [kubectl edit](../kubectl_edit/) - 修改服务器上的某资源 +* [kubectl events](../kubectl_events/) - 列举事件 +* [kubectl exec](../kubectl_exec/) - 在容器中执行命令 +* [kubectl explain](../kubectl_explain/) - 显示资源文档说明 +* [kubectl expose](../kubectl_expose/) - 给定 ReplicationController、Service、Deployment 或 Pod, + 将其暴露为新的 kubernetes Service + +* [kubectl get](../kubectl_get/) - 显示一个或者多个资源 +* [kubectl kustomize](../kubectl_kustomize/) - 基于目录或远程 URL 内容构建 kustomization 目标 +* [kubectl label](../kubectl_label/) - 更新资源的标签 +* [kubectl logs](../kubectl_logs/) - 输出 Pod 中某容器的日志 +* [kubectl options](../kubectl_options/) - 打印所有命令都支持的共有参数列表 +* [kubectl patch](../kubectl_patch/) - 更新某资源中的字段 + +* [kubectl plugin](../kubectl_plugin/) - 提供与插件交互的工具 +* [kubectl port-forward](../kubectl_port-forward/) - 将一个或者多个本地端口转发到 Pod +* [kubectl proxy](../kubectl_proxy/) - 运行一个 kubernetes API 服务器代理 +* [kubectl replace](../kubectl_replace/) - 基于文件名或标准输入替换资源 +* [kubectl rollout](../kubectl_rollout/) - 管理资源的上线 +* [kubectl run](../kubectl_run/) - 在集群中使用指定镜像启动容器 + +* [kubectl scale](../kubectl_scale/) - 为一个 Deployment、ReplicaSet 或 + ReplicationController 设置一个新的规模值 +* [kubectl set](../kubectl_set/) - 为对象设置功能特性 +* [kubectl taint](../kubectl_taint/) - 在一个或者多个节点上更新污点配置 +* [kubectl top](../kubectl_top/) - 显示资源(CPU/内存/存储)使用率 +* [kubectl uncordon](../kubectl_uncordon/) - 标记节点为可调度的 +* [kubectl version](../kubectl_version/) - 打印客户端和服务器的版本信息 +* [kubectl wait](../kubectl_wait/) - 实验级特性:等待一个或多个资源达到某种状态 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_api-versions/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_api-versions/_index.md new file mode 100644 index 0000000000000..03457f07ff6e2 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_api-versions/_index.md @@ -0,0 +1,511 @@ +--- +title: kubectl api-versions +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +以 "group/version" 的形式打印服务器支持的 API 版本。 + +``` +kubectl api-versions +``` + +## {{% heading "examples" %}} + +``` + # Print the supported API versions + kubectl api-versions +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +关于 api-versions 的帮助信息。 +

+
+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string
+

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

+
--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_auth/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_auth/_index.md new file mode 100644 index 0000000000000..d707fe0c34bd4 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_auth/_index.md @@ -0,0 +1,512 @@ +--- +title: kubectl auth +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +检查授权。 + +```shell +kubectl auth [flags] +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +关于 auth 的帮助信息。 +

+
+ + + +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string
+

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

+
--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 +* [kubectl auth can-i](kubectl_auth_can-i/) - 检查是否允许执行操作 +* [kubectl auth reconcile](kubectl_auth_reconcile/) - 协调 RBAC 角色、角色绑定、集群角色和集群角色绑定对象的规则 +* [kubectl auth whoami](kubectl_auth_whoami/) - 实验特性:检查自己的主体属性 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_certificate/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_certificate/_index.md new file mode 100644 index 0000000000000..6934911414315 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_certificate/_index.md @@ -0,0 +1,509 @@ +--- +title: kubectl certificate +content_type: tool-reference +weight: 30 +no_list: true +--- + + + +## {{% heading "synopsis" %}} + + +修改证书资源。 + +```shell +kubectl certificate SUBCOMMAND +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +关于 certificate 的帮助信息。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string
+

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

+
--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 +* [kubectl certificate approve](kubectl_certificate_approve/) - 批准证书签名请求 +* [kubectl certificate deny](kubectl_certificate_deny/) - 拒绝证书签名请求 + diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_cluster-info/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_cluster-info/_index.md new file mode 100644 index 0000000000000..e947656b82fcf --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_cluster-info/_index.md @@ -0,0 +1,517 @@ +--- +title: kubectl cluster-info +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +显示控制平面和带有标签 kubernetes.io/cluster-service=true 的 Service 的地址。 +要进一步调试和诊断集群问题,请使用 "kubectl cluster-info dump"。 + +``` +kubectl cluster-info [flags] +``` + +## {{% heading "examples" %}} + + +``` +# 打印控制平面和集群服务的地址 +kubectl cluster-info +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +关于 cluster-info 的帮助信息。 +

+
+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string
+

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

+
--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 +* [kubectl cluster-info dump](kubectl_cluster-info_dump/) - 转储相关信息以便进行调试和诊断 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_completion/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_completion/_index.md new file mode 100644 index 0000000000000..4d3fa1cb3bf65 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_completion/_index.md @@ -0,0 +1,634 @@ +--- +title: kubectl completion +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +输出指定 shell(bash、zsh、fish 或 powershell)的 shell 补全代码。 +必须评估 shell 代码才能提供 kubectl 命令的交互式补全,这可以通过从 .bash_profile 中获取它来完成。 + +有关如何执行此操作的详细说明请参见此处: + +- 对于 macOS: + https://kubernetes.io/docs/tasks/tools/install-kubectl-macos/#enable-shell-autocompletion + +- 对于 Linux: + https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/#enable-shell-autocompletion + +- 对于 Windows: + https://kubernetes.io/docs/tasks/tools/install-kubectl-windows/#enable-shell-autocompletion + + + zsh 用户注意事项:[1] zsh 补全仅支持 zsh >= 5.2 版本。 + +``` +kubectl completion SHELL +``` + +## {{% heading "examples" %}} + + +``` + # 使用 homebrew 在 macOS 上安装 bash-completion + ## 如果运行 macOS 附带的 Bash 3.2 + brew install bash-completion + ## 或者,如果运行的是 Bash 4.1+ + brew install bash-completion@2 + ## 如果通过 homebrew 安装了 kubectl,Shell 补全应该能够立即起作用 + ## 如果你通过其他方式安装,则可能需要将新的补全数据添加到补全目录中 + kubectl completion bash > $(brew --prefix)/etc/bash_completion.d/kubectl + + + # 在 Linux 上安装 bash 补全 + ## 如果 Linux 上未安装 bash-completion,请通过发行版的包管理器安装 "bash-completion" 包。 + ## 将 bash 的 kubectl 补全代码加载到当前 shell 中 + source <(kubectl completion bash) + ## 将 bash 补全代码写入文件并从 .bash_profile 中引用之 + kubectl completion bash > ~/.kube/completion.bash.inc + printf " + # kubectl shell completion + source '$HOME/.kube/completion.bash.inc' + " >> $HOME/.bash_profile + source $HOME/.bash_profile + + # 将 zsh[1] 的 kubectl 补全代码加载到当前 shell 中 + source <(kubectl completion zsh) + # 将 zsh[1] 的 kubectl 补全代码设置为在启动时自动加载 + kubectl completion zsh > "${fpath[1]}/_kubectl" + + + # 将 fish[2] 的 kubectl 补全代码加载到当前 shell 中 + kubectl completion fish | source + # 要为每个会话都加载补全代码,请执行一次如下命令: + kubectl completion fish > ~/.config/fish/completions/kubectl.fish + + # 将 powershell 的 kubectl 补全代码加载到当前 shell 中 + kubectl completion powershell | Out-String | Invoke-Expression + # 设置 powershell 的 kubectl 补全代码在启动时运行 + ## 将补全代码保存到脚本并在配置文件中执行 + kubectl completion powershell > $HOME\.kube\completion.ps1 + Add-Content $PROFILE "$HOME\.kube\completion.ps1" + ## 执行配置文件中的补全代码 + Add-Content $PROFILE "if (Get-Command kubectl -ErrorAction SilentlyContinue) { + kubectl completion powershell | Out-String | Invoke-Expression + }" + ## 直接将补全代码添加到 $PROFILE 脚本 + kubectl completion powershell >> $PROFILE +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +关于 completion 的帮助信息。 +

+
+ + + +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string
+

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

+
--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_config/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_config/_index.md new file mode 100644 index 0000000000000..d54d2ba97208a --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_config/_index.md @@ -0,0 +1,561 @@ +--- +title: kubectl config +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +使用 "kubectl config set current-context my-context" 等子命令修改 kubeconfig 文件。 + +加载顺序遵循以下规则: + +1. 如果设置了 --kubeconfig 标志,则仅加载该文件。该标志只能设置一次,并且不会发生合并。 +2. 如果设置了 $KUBECONFIG 环境变量,则将其用作路径列表(系统的正常路径分隔规则),这些路径会被合并。 + 当某个值被修改时,也会在定义这部分内容的文件中修改此值。当某个值被创建时,也会在存在的第一个文件中创建此值。 + 如果链中不存在文件,则它会创建列表中的最后一个文件。 +3. 否则,将使用 `${HOME}/.kube/config`,并且不会发生合并。 + +```shell +kubectl config SUBCOMMAND +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + +
-h, --help
+

+ +关于 config 的帮助信息。 +

--kubeconfig string
+

+ +使用特定的 kubeconfig 文件 +

+
+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string
+

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

+
--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 +* [kubectl config current-context](kubectl_config_current-context/) - 显示当前上下文 +* [kubectl config delete-cluster](kubectl_config_delete-cluster/) - 从 kubeconfig 中删除指定集群信息 +* [kubectl config delete-context](kubectl_config_delete-context/) - 从 kubeconfig 中删除指定的上下文信息 +* [kubectl config delete-user](kubectl_config_delete-user/) - 从 kubeconfig 中删除指定的用户信息 +* [kubectl config get-clusters](kubectl_config_get-clusters/) - 显示 kubeconfig 中指定集群的信息 +* [kubectl config get-contexts](kubectl_config_get-contexts/) - 显示 kubeconfig 中指定上下文的信息 +* [kubectl config get-users](kubectl_config_get-users/) - 显示 kubeconfig 中指定用户的信息 +* [kubectl config rename-context](kubectl_config_rename-context/) - 对 kubeconfig 文件的上下文重命名 +* [kubectl config set](kubectl_config_set/) - 在 kubeconfig 文件中设置单个值 +* [kubectl config set-cluster](kubectl_config_set-cluster/) - 在 kubeconfig 中设置集群条目 +* [kubectl config set-context](kubectl_config_set-context/) - 在 kubeconfig 中设置上下文条目 +* [kubectl config set-credentials](kubectl_config_set-credentials/) - 在 kubeconfig 中设置用户条目 +* [kubectl config unset](kubectl_config_unset/) - 取消设置 kubeconfig 文件中的单个值 +* [kubectl config use-context](kubectl_config_use-context/) - 设置在 kubeconfig 文件中的当前上下文 +* [kubectl config view](kubectl_config_view/) - 显示合并的 kubeconfig 设置或指定的 kubeconfig 文件 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_config/kubectl_config_current-context.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_config/kubectl_config_current-context.md new file mode 100644 index 0000000000000..78d88b50c19f5 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_config/kubectl_config_current-context.md @@ -0,0 +1,512 @@ +--- +title: kubectl config current-context +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +显示当前上下文。 + +```shell +kubectl config current-context [flags] +``` + +## {{% heading "examples" %}} + + +```shell +# 显示当前上下文 +kubectl config current-context +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +关于 current-context 的帮助信息。 +

+
+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string
+

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

+
--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl config](../) - 修改 kubeconfig 文件 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_cordon/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_cordon/_index.md new file mode 100644 index 0000000000000..d25d995fc8da8 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_cordon/_index.md @@ -0,0 +1,539 @@ +--- +title: kubectl cordon +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +将节点标记为不可调度的。 + +```bash +kubectl cordon NODE +``` + +## {{% heading "examples" %}} + + +```bash + # 将节点 "foo" 标记为不可调度的 + kubectl cordon foo +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

-h, --help

+ +cordon 操作的帮助命令。 +

-l, --selector string

+ +过滤所用的选择算符(标签查询),支持 '='、'==' 和 '!='。 +(例如 -l key1=value1,key2=value2)。匹配的对象必须满足所有指定的标签约束。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中的集群名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 用于控制 Kubernetes 集群管理器 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_cp/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_cp/_index.md new file mode 100644 index 0000000000000..a83b6f671a4c4 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_cp/_index.md @@ -0,0 +1,596 @@ +--- +title: kubectl cp +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +将文件、目录复制到容器;或从容器复制文件、目录。 + +```shell +kubectl cp +``` + +## {{% heading "examples" %}} + + +```shell + # !!!重要提示!!! + # 要求你的容器镜像中存在 'tar' 可执行文件 + # 如果 'tar' 不存在,'kubectl cp' 将会失败 + # + # 对于符号链接、通配符扩展或文件模式保留等高级用例,考虑使用 'kubectl exec' + + # 将本地文件 /tmp/foo 复制到远程命名空间 中 Pod 中的 /tmp/bar + tar cf - /tmp/foo | kubectl exec -i -n -- tar xf - -C /tmp/bar + + # 将 /tmp/foo 从远程 Pod 复制到本地的 /tmp/bar + kubectl exec -n -- tar cf - /tmp/foo | tar xf - -C /tmp/bar + + # 将本地目录 /tmp/foo_dir 复制到远程默认命名空间中 Pod 中的 /tmp/bar_dir + kubectl cp /tmp/foo_dir :/tmp/bar_dir + + # 将本地文件 /tmp/foo 复制到远程 Pod 中特定容器内的 /tmp/bar + kubectl cp /tmp/foo :/tmp/bar -c + + # 将本地文件 /tmp/foo 复制到远程命名空间 内 Pod 中的 /tmp/bar + kubectl cp /tmp/foo /:/tmp/bar + + # 将 /tmp/foo 从远程 Pod 复制到本地的 /tmp/bar + kubectl cp /:/tmp/foo /tmp/bar +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
-c, --container string

+ +容器名称。如果省略,将使用 kubectl.kubernetes.io/default-container +注解来选择要被挂接的容器,或者选择 Pod 中的第一个容器。 +

-h, --help

+ +cp 操作的帮助命令。 +

--no-preserve

+ +被复制的文件/目录的所有权和权限将不会在容器中保留。 +

--retries int

+ +设置从容器完成复制操作的重试次数。 +指定 0 表示禁止重试,指定任何负值表示无限重试。默认值为 0(不重试)。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +要伪装此操作的用户名。用户可以是命名空间中的普通用户或服务账户。 +

--as-group strings

+ +要伪装此操作的组,此标志可以被重复使用以指定多个组。 +

--as-uid string

+ +要伪装此操作的 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书颁发机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +在 GCE 防火墙中打开 CIDR,以进行第 7 层负载均衡流量代理和健康状况检查。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +在 GCE 防火墙中打开 CIDR,以进行第 4 层负载均衡流量代理和健康状况检查。 +

--cluster string

+ +要使用的 kubeconfig 集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +表示对污点 NotReady:NoExecute 的容忍时长(以秒计)。 +默认情况下,这一容忍度会被添加到尚未具有此容忍度的每个 Pod 中。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +表示对污点 unreachable:NoExecute 的容忍时长(以秒计)。 +默认情况下,这一容忍度会被添加到尚未具有此容忍度的每个 Pod 中。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则表示不会检查服务器证书的有效性。这样会导致你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求所用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,CLI 请求将使用此命名空间。 +

--password string

+ +API 服务器进行基本身份认证的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +放弃单个服务器请求之前的等待时间,非零值需要包含相应时间单位(例如:1s、2m、3h)。零值则表示不做超时要求。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名称。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +API 服务器进行身份认证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +API 服务器进行基本身份认证的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出; +--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_clusterrole.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_clusterrole.md new file mode 100644 index 0000000000000..3c9efde42f648 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_clusterrole.md @@ -0,0 +1,712 @@ +--- +title: kubectl create clusterrole +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建一个集群角色。 + +```shell +kubectl create clusterrole NAME --verb=verb --resource=resource.group [--resource-name=resourcename] [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +```shell + # 创建一个名为 "pod-reader" 的集群角色,允许用户对 Pod 执行 "get"、"watch" 和 "list" 操作 + kubectl create clusterrole pod-reader --verb=get,list,watch --resource=pods + + # 创建一个名为 "pod-reader" 的集群角色,并指定 ResourceName + kubectl create clusterrole pod-reader --verb=get --resource=pods --resource-name=readablepod --resource-name=anotherpod + + # 创建一个名为 "foo" 的集群角色,并指定 API 组 + kubectl create clusterrole foo --verb=get,list,watch --resource=rs.apps + + # 创建一个名为 "foo" 的集群角色,并指定 SubResource + kubectl create clusterrole foo --verb=get,list,watch --resource=pods,pods/status + + # 创建一个名为 "foo" 的集群角色,并指定 NonResourceURL + kubectl create clusterrole "foo" --verb=get --non-resource-url=/logs/* + + # 创建一个名为 "monitoring" 的集群角色,并指定 AggregationRule + kubectl create clusterrole monitoring --aggregation-rule="rbac.example.com/aggregate-to-monitoring=true" +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--aggregation-rule <英文逗号分隔的 'key=value' 对>

+ +用于组合 ClusterRole 的聚合标签选择算符。 +

--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

-h, --help

+ +clusterrole 操作的帮助命令。 +

--non-resource-url strings

+ +用户应有权限访问的部分 URL。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--resource strings

+ +规则适用的资源。 +

--resource-name strings

+ +规则适用的白名单中的资源,可以为多项重复使用此标志。 +

--save-config

+ +如果为 true,当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

--verb strings

+ +适用于规则中所含资源的动词。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 基于文件或标准输入创建资源 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_clusterrolebinding.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_clusterrolebinding.md new file mode 100644 index 0000000000000..4a2a1ce7ad6fb --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_clusterrolebinding.md @@ -0,0 +1,658 @@ +--- +title: kubectl create clusterrolebinding +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +为特定的集群角色创建一个集群角色绑定。 + +```shell +kubectl create clusterrolebinding NAME --clusterrole=NAME [--user=username] [--group=groupname] [--serviceaccount=namespace:serviceaccountname] [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +```shell +# 使用 cluster-admin 集群角色为 user1、user2 和 group1 创建一个集群角色绑定 +kubectl create clusterrolebinding cluster-admin --clusterrole=cluster-admin --user=user1 --user=user2 --group=group1 +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--clusterrole string

+ +特定 ClusterRoleBinding 应引用的 ClusterRole。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

--group strings

+ +要绑定到 ClusterRole 的组。此标志可以被重复使用以添加多个组。 +

-h, --help

+ +clusterrolebinding 操作的帮助命令。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--save-config

+ +如果为 true,则当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--serviceaccount strings

+ +要绑定到 ClusterRole 的服务账户,格式为 :。此标志可以被重复使用以添加多个服务账户。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--user strings

+ +要绑定到 ClusterRole 的用户名。此标志可以被重复使用以添加多个用户。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 从文件或标准输入创建资源 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_configmap.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_configmap.md new file mode 100644 index 0000000000000..b5e69c0786e11 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_configmap.md @@ -0,0 +1,706 @@ +--- +title: kubectl create configmap +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +基于文件、目录或指定的文字值创建 ConfigMap。 + +一个 ConfigMap 可以包含一个或多个键/值对。 + +当你基于文件创建 ConfigMap 时,键默认为文件的基本名称,值默认为文件内容。 +如果基本名称是无效的键,你可以指定一个替代键。 + +当基于目录创建 ConfigMap 时,目录中每个基本名称是有效键的文件都会被打包到 ConfigMap 中。 +除常规文件之外的所有目录条目都会被忽略(例如子目录、符号链接、设备、管道等)。 + +```shell +kubectl create configmap NAME [--from-file=[key=]source] [--from-literal=key1=value1] [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +```shell + # 基于 bar 文件夹新建一个名为 my-config 的 ConfigMap + kubectl create configmap my-config --from-file=path/to/bar + + # 新建一个名为 my-config 的 ConfigMap,使用指定的键而不是磁盘上的文件基本名称 + kubectl create configmap my-config --from-file=key1=/path/to/bar/file1.txt --from-file=key2=/path/to/bar/file2.txt + + # 新建一个名为 my-config 的 ConfigMap,包含 key1=config1 和 key2=config2 + kubectl create configmap my-config --from-literal=key1=config1 --from-literal=key2=config2 + + # 从文件中的 key=value 对新建一个名为 my-config 的 ConfigMap + kubectl create configmap my-config --from-file=path/to/bar + + # 从 env 文件新建一个名为 my-config 的 ConfigMap + kubectl create configmap my-config --from-env-file=path/to/foo.env --from-env-file=path/to/bar.env +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--append-hash

+ +将 ConfigMap 的哈希值追加到其名称上。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

--from-env-file strings

+ +指定文件的路径以读取 key=val 对的那些行来创建 ConfigMap。 +

--from-file strings

+ +键文件可以使用其文件路径来指定,在这种情况下,文件的基本名称将用作 ConfigMap 的键。 +另外,键文件也可以选择使用键和文件路径来指定,在这种情况下,将使用指定的键。 +指定一个目录将遍历此目录中所有被命名的文件(其基本名称为有效的 ConfigMap 键)。 +

--from-literal strings

+ +指定键和文字值以插入到 ConfigMap 中(例如 mykey=somevalue)。 +

-h, --help

+ +configmap 操作的帮助命令。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--save-config

+ +如果为 true,则当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 从文件或标准输入创建资源 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_cronjob.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_cronjob.md new file mode 100644 index 0000000000000..4b2dc6fdb2380 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_cronjob.md @@ -0,0 +1,664 @@ +--- +title: kubectl create cronjob +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建具有指定名称的 CronJob。 + +```shell +kubectl create cronjob NAME --image=image --schedule='0/5 * * * ?' -- [COMMAND] [args...] [flags] +``` + +## {{% heading "examples" %}} + + +```shell +# 创建 CronJob +kubectl create cronjob my-job --image=busybox --schedule="*/1 * * * *" + +# 创建带有命令的 CronJob +kubectl create cronjob my-job --image=busybox --schedule="*/1 * * * *" -- date +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

-h, --help

+ +cronjob 操作的帮助命令。 +

--image string

+ +要运行的镜像名称。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--restart string

+ +Job 的重启策略。支持的值:OnFailure、Never +

--save-config

+ +如果为 true,当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--schedule string

+ +Job 运行应使用的 Cron 格式的排期表。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 使用文件或标准输入创建资源 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_job.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_job.md new file mode 100644 index 0000000000000..9c3d5d11358e0 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_job.md @@ -0,0 +1,658 @@ +--- +title: kubectl create job +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建指定名称的 Job。 + +```shell +kubectl create job NAME --image=image [--from=cronjob/name] -- [COMMAND] [args...] +``` + +## {{% heading "examples" %}} + + +```shell +# 创建一个 Job +kubectl create job my-job --image=busybox + +# 创建带一条命令的 Job +kubectl create job my-job --image=busybox -- date + +# 从名为 "a-cronjob" 的定时任务创建一个 Job +kubectl create job test-job --from=cronjob/a-cronjob +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

--from string

+ +要创建 Job 的资源的来源名称(仅支持 cronjob)。 +

-h, --help

+ +job 操作的帮助命令。 +

--image string

+ +要运行的镜像名称。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--save-config

+ +如果为 true,则当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 基于文件或标准输入创建资源 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_namespace.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_namespace.md new file mode 100644 index 0000000000000..4b73e6ca7ed5b --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_namespace.md @@ -0,0 +1,611 @@ +--- +title: kubectl create namespace +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +用指定的名称创建命名空间。 + +```shell +kubectl create namespace NAME [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +```shell +# 新建一个名为 my-namespace 的命名空间 +kubectl create namespace my-namespace +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

-h, --help

+ +namespace 操作的帮助命令。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--save-config

+ +如果为 true,则当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ + +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 基于文件或标准输入创建资源 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_poddisruptionbudget.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_poddisruptionbudget.md new file mode 100644 index 0000000000000..cc8a147832f14 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_poddisruptionbudget.md @@ -0,0 +1,668 @@ +--- +title: kubectl create poddisruptionbudget +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建具有指定名称、选择算符和预期最少可用 Pod 个数的 Pod 干扰预算。 + +```shell +kubectl create poddisruptionbudget NAME --selector=SELECTOR --min-available=N [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +```shell +# 创建一个名为 my-pdb 的 Pod 干扰预算,它将选择所有带有 app=rails 标签的 Pod +# 并要求至少有一个 Pod 在任何时候都是可用的 +kubectl create poddisruptionbudget my-pdb --selector=app=rails --min-available=1 + +# 创建一个名为 my-pdb 的 Pod 干扰预算,它将选择所有带有 app=nginx 标签的 Pod +# 并要求在任何时候所选 Pod 中至少有一半是可用的 +kubectl create pdb my-pdb --selector=app=nginx --min-available=50% +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

-h, --help

+ +poddisruptionbudget 操作的帮助命令。 +

--max-unavailable string

+ +指定预算要求的最大不可用 Pod 个数或百分比。 +

--min-available string

+ +指定预算要求的最小不可用 Pod 个数或百分比。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--save-config

+ +如果为 true,当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--selector string

+ +指定预算所用的标签选择算符。仅支持基于等值的选择算符。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 使用文件或标准输入创建资源 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_priorityclass.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_priorityclass.md new file mode 100644 index 0000000000000..32f858297080a --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_priorityclass.md @@ -0,0 +1,670 @@ +--- +title: kubectl create priorityclass +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建带有指定名称、取值、globalDefault 设置及描述的优先级类对象。 + +```shell +kubectl create priorityclass NAME --value=VALUE --global-default=BOOL [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +```shell +# 创建一个名为 high-priority 的优先级类 +kubectl create priorityclass high-priority --value=1000 --description="high priority" + +# 创建一个名为 default-priority 的优先级类,并将其视为全局默认优先级 +kubectl create priorityclass default-priority --value=1000 --global-default=true --description="default priority" + +# 创建一个名为 high-priority 的优先级类,它不能抢占低优先级的 Pod +kubectl create priorityclass high-priority --value=1000 --description="high priority" --preemption-policy="Never" +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--description string

+ +description 是一个任意字符串,通常提供有关何时应使用此优先级的指南。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

--global-default

+ +global-default 指定优先级类是否应被视为默认优先级。 +

-h, --help

+ +priorityclass 操作的帮助命令。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--preemption-policy string     默认值:"PreemptLowerPriority"

+ +preemption-policy 是用于抢占低优先级 Pod 的策略。 +

--save-config

+ +如果为 true,则当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

--value int32

+ +指定优先级类的取值。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 基于文件或标准输入创建资源 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_role.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_role.md new file mode 100644 index 0000000000000..f8c5e44287c00 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_role.md @@ -0,0 +1,676 @@ +--- +title: kubectl create role +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建单一规则的角色。 + +```shell +kubectl create role NAME --verb=verb --resource=resource.group/subresource [--resource-name=resourcename] [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +```shell +# 创建一个名为 "pod-reader" 的角色,允许用户对 Pod 执行 "get"、"watch" 和 "list" 操作 +kubectl create role pod-reader --verb=get --verb=list --verb=watch --resource=pods + +# 创建一个名为 "pod-reader" 的角色,并指定资源名称 +kubectl create role pod-reader --verb=get --resource=pods --resource-name=readablepod --resource-name=anotherpod + +# 创建一个名为 "foo" 的角色,并指定 API 组 +kubectl create role foo --verb=get,list,watch --resource=rs.apps + +# 创建一个名为 "foo" 的角色,并指定子资源 +kubectl create role foo --verb=get,list,watch --resource=pods,pods/status +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

-h, --help

+ +role 操作的帮助命令。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--resource strings

+ +规则适用的资源。 +

--resource-name strings

+ +规则适用的白名单中的资源,可以为多项重复使用此标志。 +

--save-config

+ +如果为 true,当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

--verb strings

+ +适用于规则中所含资源的动词。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +- [kubectl create](../) - 基于文件或标准输入创建资源 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_rolebinding.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_rolebinding.md new file mode 100644 index 0000000000000..c9a7df15776b0 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_rolebinding.md @@ -0,0 +1,688 @@ +--- +title: kubectl create rolebinding +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +为特定角色或集群角色创建角色绑定。 + +```shell +kubectl create rolebinding NAME --clusterrole=NAME|--role=NAME [--user=用户名] [--group=组名] [--serviceaccount=命名空间:服务账户名] [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +```shell +# 使用 admin 集群角色为 user1、user2 和 group1 创建角色绑定 +kubectl create rolebinding admin --clusterrole=admin --user=user1 --user=user2 --group=group1 + +# 使用 admin 角色为服务账户 monitoring:sa-dev 创建角色绑定 +kubectl create rolebinding admin-binding --role=admin --serviceaccount=monitoring:sa-dev +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--clusterrole string

+ +指定 RoleBinding 应引用的 ClusterRole。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

--group strings

+ +要绑定到角色的组。此标志可以重复使用以添加多个组。 +

-h, --help

+ +rolebinding 操作的帮助命令。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--role string

+ +指定 RoleBinding 应引用的角色。 +

--save-config

+ +如果为 true,当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--serviceaccount strings

+ +要绑定到角色的服务账户,格式为 `:`。此标志可以重复使用以添加多个服务账户。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--user strings

+ +要绑定到角色的用户名。此标志可以重复使用以添加多个用户。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 使用文件或标准输入创建资源 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_secret.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_secret.md new file mode 100644 index 0000000000000..d45964250aa29 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_secret.md @@ -0,0 +1,517 @@ +--- +title: kubectl create secret +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建指定类型的 Secret: + +- docker-registry 类型 Secret 用于访问容器镜像仓库。 + +- generic 类型 Secret 表示不透明 Secret 类型。 + +- tls 类型 Secret 包含 TLS 证书及其关联密钥。 + +```shell +kubectl create secret (docker-registry | generic | tls) +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +secret 操作的帮助命令。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 基于文件或标准输入创建资源 +* [kubectl create secret docker-registry](../kubectl_create_secret_docker-registry/) - 创建 Docker 仓库所用的 Secret +* [kubectl create secret generic](../kubectl_create_secret_generic/) - 基于本地文件、目录或文字值创建 Secret +* [kubectl create secret tls](../kubectl_create_secret_tls/) - 创建 TLS Secret diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service.md new file mode 100644 index 0000000000000..c6319a07e2358 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service.md @@ -0,0 +1,508 @@ +--- +title: kubectl create service +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +使用指定的子命令创建 Service。 + +``` +kubectl create service [flags] +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +service 操作的帮助命令。 +

+ + +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 基于文件或标准输入创建资源 +* [kubectl create service clusterip](../kubectl_create_service_clusterip/) - 创建 ClusterIP Service +* [kubectl create service externalname](../kubectl_create_service_externalname/) - 创建 ExternalName Service +* [kubectl create service loadbalancer](../kubectl_create_service_loadbalancer/) - 创建 LoadBalancer Service +* [kubectl create service nodeport](../kubectl_create_service_nodeport/) - 创建 NodePort Service diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_clusterip.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_clusterip.md new file mode 100644 index 0000000000000..f0902e4cb4c0e --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_clusterip.md @@ -0,0 +1,653 @@ +--- +title: kubectl create service clusterip +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建指定名称的 ClusterIP Service。 + +```shell +kubectl create service clusterip NAME [--tcp=:] [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +```shell +# 新建一个名为 my-cs 的 ClusterIP Service +kubectl create service clusterip my-cs --tcp=5678:8080 + +# 新建一个名为 my-cs 的 ClusterIP Service(无头模式) +kubectl create service clusterip my-cs --clusterip="None" +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--clusterip string

+ +指定你自己的 ClusterIP 或设为 “None” 来创建无头服务(无负载均衡)。 + +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

-h, --help

+ +clusterip 操作的帮助命令。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--save-config

+ +如果为 true,当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--tcp strings

+ +端口对可以指定为 "<端口>:<目标端口>"。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create service](../) - 使用指定的子命令创建 Service diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_externalname.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_externalname.md new file mode 100644 index 0000000000000..6e9588aef39cd --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_externalname.md @@ -0,0 +1,647 @@ +--- +title: kubectl create service externalname +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建指定名称的 ExternalName Service。 + +ExternalName Service 引用外部 DNS 地址,而不仅仅是 Pod, +这类 Service 允许应用作者引用平台外、其他集群或本地存在的服务。 + +```shell +kubectl create service externalname NAME --external-name external.name [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +```shell +# 新建一个名为 my-ns 的 ExternalName Service +kubectl create service externalname my-ns --external-name bar.com +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--external-name string

+ +Service 对外的名称。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

-h, --help

+ +externalname 操作的帮助命令。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--save-config

+ +如果为 true,当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--tcp strings

+ +端口对可以指定为 "<端口>:<目标端口>"。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create service](../) - 使用指定的子命令创建 Service diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_loadbalancer.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_loadbalancer.md new file mode 100644 index 0000000000000..73bf13b171bd0 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_loadbalancer.md @@ -0,0 +1,632 @@ +--- +title: kubectl create service loadbalancer +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建指定名称的 LoadBalancer 类型 Service。 + +```shell +kubectl create service loadbalancer NAME [--tcp=port:targetPort] [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +```shell +# 新建名为 my-lbs 的 LoadBalancer 类型 Service +kubectl create service loadbalancer my-lbs --tcp=5678:8080 +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     Default: true
+

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--dry-run string[="unchanged"]     Default: "none"
+

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认:"kubectl-create"
+

+ +用于跟踪字段属主关系的管理器的名称。 +

-h, --help
+

+ +关于 loadbalancer 的帮助信息。 +

-o, --output string
+

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--save-config

+ +如果为 true,当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--tcp strings

+ +端口对可以指定为 "<端口>:<目标端口>"。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create service](../) - 使用指定的子命令创建 Service diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_nodeport.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_nodeport.md new file mode 100644 index 0000000000000..25f9dcff0571c --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_service_nodeport.md @@ -0,0 +1,647 @@ +--- +title: kubectl create service nodeport +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建一个指定名称的 NodePort 类型 Service。 + +```shell +kubectl create service nodeport NAME [--tcp=port:targetPort] [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +``` +# 新建一个名为 my-ns 的 NodePort 类型 Service +kubectl create service nodeport my-ns --tcp=5678:8080 +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     Default: true
+

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--dry-run string[="unchanged"]     Default: "none"
+

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认:"kubectl-create"
+

+ +用于跟踪字段属主关系的管理器的名称。 +

-h, --help
+

+ +关于 nodeport 的帮助信息。 +

--node-port int
+

+ +用于在集群中每个节点上公开 Service 的端口。 +

-o, --output string
+

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--save-config

+ +如果为 true,当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--tcp strings

+ +端口对可以指定为 "<端口>:<目标端口>"。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ + + +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create service](../) - 使用指定的子命令创建 Service diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_serviceaccount.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_serviceaccount.md new file mode 100644 index 0000000000000..01d7d8bd8d8fa --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_create/kubectl_create_serviceaccount.md @@ -0,0 +1,605 @@ +--- +title: kubectl create serviceaccount +content_type: tool-reference +weight: 30 +--- + + +## {{% heading "synopsis" %}} + + +创建指定名称的服务帐户。 + +``` +kubectl create serviceaccount NAME [--dry-run=server|client|none] +``` + +## {{% heading "examples" %}} + + +``` +# 创建一个名为 my-service-account 的服务帐号 +kubectl create serviceaccount my-service-account +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-create"

+ +用于跟踪字段属主关系的管理器的名称。 +

-h, --help

+ +clusterrolebinding 操作的帮助命令。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--save-config

+ +如果为 true,则当前对象的配置将被保存在其注解中。否则,注解将保持不变。 +当你希望后续对此对象执行 `kubectl apply` 操作时,此标志很有用。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--validate string[="strict"]     默认值:"strict"

+ +必须是以下选项之一:strict(或 true)、warn、ignore(或 false)。
+"true" 或 "strict" 将使用模式定义来验证输入,如果无效,则请求失败。 +如果在 API 服务器上启用了 ServerSideFieldValidation,则执行服务器端验证, +但如果未启用,它将回退到可靠性较低的客户端验证。
+如果在 API 服务器上启用了服务器端字段验证,"warn" 将警告未知或重复的字段而不阻止请求, +否则操作与 "ignore" 的表现相同。
+"false" 或 "ignore" 将不会执行任何模式定义检查,而是静默删除所有未知或重复的字段。 +

+ + + +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string
+

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl create](../) - 从文件或标准输入创建资源 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_exec/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_exec/_index.md new file mode 100644 index 0000000000000..821ac56439423 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_exec/_index.md @@ -0,0 +1,642 @@ +--- +title: kubectl exec +content_type: tool-reference +weight: 30 +no_list: true +--- + + + +## {{% heading "synopsis" %}} + + +在容器中执行命令。 + +``` +kubectl exec (POD | TYPE/NAME) [-c CONTAINER] [flags] -- COMMAND [args...] +``` + +## {{% heading "examples" %}} + + +``` + # 在 Pod mypod 中执行 'date' 命令获取输出,默认在第一个容器中执行 + kubectl exec mypod -- date + + # 在 Pod mypod 的 ruby-container 容器中执行 'date' 命令并获取输出 + kubectl exec mypod -c ruby-container -- date + + # 切换到原始终端模式;从 Pod mypod 将 stdin 发送到 ruby-container 中的 'bash', + # 并将 stdout/stderr 从 'bash' 发送回客户端 + kubectl exec mypod -c ruby-container -i -t -- bash -il + + # 在 Pod mypod 的第一个容器中列出 /usr 的内容,并按修改时间排序 + # 如果你要在 Pod 中执行的命令具有任何与 kubectl 本身重叠的标志(例如 -i), + # 则必须使用两个破折号(--)来分隔命令的标志/参数 + # 另请注意,不要用引号括住你的命令及其标志/参数, + # 除非这是你正常执行它的方式(即执行 ls -t /usr,而不是 "ls -t /usr") + kubectl exec mypod -i -t -- ls -t /usr + + # 在 Deployment mydeployment 中的第一个 Pod 运行 'date' 命令并获取输出,默认使用 Pod 的第一个容器 + kubectl exec deploy/mydeployment -- date + + # 在 Service myservice 的第一个 Pod 运行 'date' 命令并获取输出,默认使用 Pod 的第一个容器 + kubectl exec svc/myservice -- date +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
-c, --container string
+

+ +容器名称。 +如果省略,则使用 kubectl.kubernetes.io/default-container 注解来选择要挂接的容器, +否则将选择 Pod 中的第一个容器。 +

-f, --filename strings
+

+ +用于在资源中执行的文件。 +

-h, --help
+

+ +关于 exec 的帮助信息。 +

--pod-running-timeout duration     默认:1m0s
+

+ +等待至少一个 Pod 运行的时间长度(例如 5 秒、2 分钟或 3 小时,大于零)。 +

-q, --quiet
+

+ +仅打印远程会话的输出。 +

+
-i, --stdin
+

+ +将 stdin 传递给容器。 +

+
-t, --tty
+

+ +Stdin 是一个 TTY。 +

+
+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

+
--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

+
--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

+
--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

+
--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_label/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_label/_index.md new file mode 100644 index 0000000000000..1a27be056bac5 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_label/_index.md @@ -0,0 +1,771 @@ +--- +title: kubectl label +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + + +更新资源上的标签。 + +* 标签的键和值必须以字母或数字开头,可以包含字母、数字、连字符、点和下划线,每个最多 63 个字符。 +* 键可以选择以 DNS 子域前缀加上一个斜杠 '/' 开头,如 example.com/my-app。 +* 如果 --overwrite 为 true,则现有标签可以被覆盖,否则尝试覆盖标签将导致错误。 +* 如果指定了 --resource-version,则更新将使用此资源版本,否则将使用现有的资源版本。 + + +```shell +kubectl label [--overwrite] (-f FILENAME | TYPE NAME) KEY_1=VAL_1 ... KEY_N=VAL_N [--resource-version=version] +``` + +## {{% heading "examples" %}} + + +```shell + # 使用标签 'unhealthy' 和值 'true' 更新 Pod 'foo' + kubectl label pods foo unhealthy=true + + # 使用标签 'status' 和值 'unhealthy' 更新 Pod 'foo',覆盖所有现有值 + kubectl label --overwrite pods foo status=unhealthy + + # 更新命名空间中的所有 Pod + kubectl label pods --all status=unhealthy + + # 更新由 "pod.json" 中的 type 和 name 标识的 Pod + kubectl label -f pod.json status=unhealthy + + # 仅在资源版本为 1 且未更改时更新 Pod 'foo' + kubectl label pods foo status=unhealthy --resource-version=1 + + # 如果存在名为 'bar' 的标签,则通过移除此标签来更新 Pod 'foo' + # 不需要 --overwrite 标志 + kubectl label pods foo bar- +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--all

+ +在指定资源类型的命名空间中,选择所有资源。 +

-A, --all-namespaces

+ +如果为 true,则在所有命名空间中执行指定的操作。 +

--allow-missing-template-keys     默认值:true

+ +如果为 true,在模板中字段或映射键缺失时忽略模板中的错误。 +仅适用于 golang 和 jsonpath 输出格式。 +

--dry-run string[="unchanged"]     默认值:"none"

+ +必须是 "none"、"server" 或 "client"。如果是 client 策略,仅打印将要发送的对象,而不实际发送。 +如果是 server 策略,提交服务器端请求而不持久化资源。 +

--field-manager string     默认值:"kubectl-label"

+ +用于跟踪字段属主关系的管理器的名称。 +

--field-selector string

+ +过滤所用的选择算符(字段查询),支持 '='、'==' 和 '!='。 +(例如 --field-selector key1=value1,key2=value2)。服务器针对每种类型仅支持有限数量的字段查询。 +

-f, --filename strings

+ +文件名、目录或文件 URL,用于标识要更新标签的资源。 +

-h, --help

+ +label 操作的帮助命令。 +

-k, --kustomize string

+ +处理 kustomization 目录。此标志不能与 -f 或 -R 一起使用。 +

--list

+ +如果为 true,则显示给定资源的标签。 +

--local

+ +如果为 true,则 label 操作不会与 api-server 通信,而是在本地运行。 +

-o, --output string

+ +输出格式。可选值为: +json、yaml、name、go-template、go-template-file、template、templatefile、jsonpath、jsonpath-as-json、jsonpath-file。 +

--overwrite

+ +如果为 true,则允许标签被覆盖,否则拒绝覆盖现有标签的更新。 +

-R, --recursive

+ +递归处理在 -f、--filename 中给出的目录。当你想要管理位于同一目录中相互关联的清单时很有用。 +

--resource-version string

+ +如果非空,则只有在所给值是对象的当前资源版本时,标签更新才会成功。仅在指定单个资源时有效。 +

-l, --selector string

+ +过滤所用的选择算符(标签查询),支持 '='、'==' 和 '!='。 +(例如 -l key1=value1,key2=value2)。匹配的对象必须满足所有指定的标签约束。 +

--show-managed-fields

+ +如果为 true,在以 JSON 或 YAML 格式打印对象时保留 managedFields。 +

--template string

+ +当 -o=go-template、-o=go-template-file 时使用的模板字符串或模板文件路径。 +模板格式为 golang 模板 [http://golang.org/pkg/text/template/#pkg-overview]。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求所针对的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 用于控制 Kubernetes 集群管理器 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_logs/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_logs/_index.md new file mode 100644 index 0000000000000..a2d536e1bb0cc --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_logs/_index.md @@ -0,0 +1,762 @@ +--- +title: kubectl logs +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +打印 Pod 或指定资源中某个容器的日志。如果 Pod 只有一个容器,则容器名称是可选的。 + +```shell +kubectl logs [-f] [-p] (POD | TYPE/NAME) [-c CONTAINER] +``` + +## {{% heading "examples" %}} + + +```shell + # 返回只有一个容器的 nginx Pod 中的快照日志 + kubectl logs nginx + + # 返回有多个容器的 nginx Pod 中的快照日志 + kubectl logs nginx --all-containers=true + + # 返回带 app=nginx 标签定义的 Pod 中所有容器的快照日志 + kubectl logs -l app=nginx --all-containers=true + + # 返回 web-1 Pod 中之前终止的 ruby 容器日志的日志 + kubectl logs -p -c ruby web-1 + + # 开始流式传输 web-1 Pod 中 ruby 容器的日志 + kubectl logs -f -c ruby web-1 + + # 开始流式传输带 app=nginx 标签定义的 Pod 中所有容器的日志 + kubectl logs -f -l app=nginx --all-containers=true + + # 仅显示 nginx Pod 的最近 20 行输出 + kubectl logs --tail=20 nginx + + # 显示 nginx Pod 在过去一小时内写入的所有日志 + kubectl logs --since=1h nginx + + # 显示所提供证书过期的 kubelet 的日志 + kubectl logs --insecure-skip-tls-verify-backend nginx + + # 返回名为 hello 的 Job 的第一个容器的快照日志 + kubectl logs job/hello + + # 返回 nginx Deployment 的 nginx-1 容器的快照日志 + kubectl logs deployment/nginx -c nginx-1 +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--all-containers

+ +获取 Pod 中所有容器的日志。 +

-c, --container string

+ +打印指定容器的日志。 +

-f, --follow

+ +指定日志是否应以流式传输。 +

-h, --help

+ +logs 操作的帮助命令。 +

--ignore-errors

+ +如果在监视/跟随 Pod 日志,则允许出现任何非致命的错误。 +

--insecure-skip-tls-verify-backend

+ +跳过请求日志来源的 kubelet 的身份验证。从理论上讲,攻击者可能会提供无效的日志内容。 +如果你的 kubelet 提供的证书已过期,你可能需要使用此参数。 +

--limit-bytes int

+ +要返回的日志的最大字节数。默认为无限制。 +

--max-log-requests int     默认值:5

+ +指定使用选择算符时要遵循的最大并发日志数。默认值为 5。 +

--pod-running-timeout duration     默认值:20s

+ +等待至少一个 Pod 运行的时长(例如 5s、2m 或 3h,大于零)。 +

--prefix

+ +在每行日志前添加日志来源(Pod 名称和容器名称)的前缀。 +

-p, --previous

+ +如果为 true,则打印 Pod 中容器的前一个实例的日志(如果存在)。 +

-l, --selector string

+ +过滤所用的选择算符(标签查询),支持 '='、'==' 和 '!='。 +(例如 -l key1=value1,key2=value2)。匹配的对象必须满足所有指定的标签约束。 +

--since duration

+ +仅返回比相对时长更新的日志,如 5s、2m 或 3h。 +默认返回所有日志。只能使用 since-time 和 since 之一。 +

--since-time string

+ +仅返回特定日期(RFC3339)之后的日志。默认返回所有日志。 +只能使用 since-time 和 since 之一。 +

--tail int     默认值:-1

+ +要显示的最近日志文件的行数。不带选择算符时默认为 -1 将显示所有日志行。 +否则如果提供了选择算符,则为 10。 +

--timestamps

+ +在日志输出的每一行中包含时间戳。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中的集群名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求所针对的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 用于控制 Kubernetes 集群管理器 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_options/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_options/_index.md new file mode 100644 index 0000000000000..37f949f8b07b1 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_options/_index.md @@ -0,0 +1,513 @@ +--- +title: kubectl options +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +打印被所有命令继承的标志列表。 + +``` +kubectl options [flags] +``` + +## {{% heading "examples" %}} + + +``` +# 打印被所有命令继承的标志 +kubectl options +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +关于 options 的帮助信息。 +

+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string
+

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

+
--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_plugin/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_plugin/_index.md new file mode 100644 index 0000000000000..e340d87d3505b --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_plugin/_index.md @@ -0,0 +1,515 @@ +--- +title: kubectl plugin +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +提供与插件交互的实用程序。 + +插件提供主要命令行发布版本所不具备的扩展功能,请参阅文档和示例以获取有关如何编写自己的插件的更多信息。 + +发现和安装插件的最简单方法是通过 kubernetes 子项目 krew,要安装 krew 请参阅 +[krew.sigs.k8s.io](https://krew.sigs.k8s.io/docs/user-guide/setup/install/)。 + +``` +kubectl plugin [flags] +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +关于 plugin 的帮助信息。 +

+
+ + + +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string
+

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

+
--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_set/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_set/_index.md new file mode 100644 index 0000000000000..fef9da0899170 --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_set/_index.md @@ -0,0 +1,521 @@ +--- +title: kubectl set +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +配置应用程序资源。 + +这些命令可帮助你更改现有的应用程序资源。 + +``` +kubectl set SUBCOMMAND +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +关于 set 的帮助信息。 +

+ + + +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string
+

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

+
--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 +* [kubectl set env](kubectl_set_env/) - 更新 Pod 模板上的环境变量 +* [kubectl set image](kubectl_set_image/) - 更新 Pod 模板上的镜像 +* [kubectl set resources](kubectl_set_resources/) - 使用 Pod 模板更新对象的资源请求/限制 +* [kubectl set selector](kubectl_set_selector/) - 设置资源上的选择器 +* [kubectl set serviceaccount](kubectl_set_serviceaccount/) - 更新资源的服务帐户 +* [kubectl set subject](kubectl_set_subject/) - 更新角色绑定或集群角色绑定中的用户、组或服务帐户 diff --git a/content/zh-cn/docs/reference/kubectl/generated/kubectl_top/_index.md b/content/zh-cn/docs/reference/kubectl/generated/kubectl_top/_index.md new file mode 100644 index 0000000000000..d911570aa4beb --- /dev/null +++ b/content/zh-cn/docs/reference/kubectl/generated/kubectl_top/_index.md @@ -0,0 +1,653 @@ +--- +title: kubectl top +content_type: tool-reference +weight: 30 +no_list: true +--- + + +## {{% heading "synopsis" %}} + + +显示资源(CPU/内存)使用情况。 + +- top 命令允许你查看节点或 Pod 的资源消耗情况。 + +- 此命令要求 Metrics Server 在服务器上被正确配置且正常运行。 + +```shell +kubectl top [flags] +``` + +## {{% heading "options" %}} + + ++++ + + + + + + + + + + +
-h, --help
+

+ +关于 top 的帮助信息。 +

+ + + +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--api-group string
+

+ +筛选指定 API 组中的资源。 +

+
--cached
+

+ +如果可用,将使用缓存的资源列表。 +

+
--categories strings
+

+ +筛选属于指定类别的资源。 +

+
-h, --help
+

+ +关于 api-resources 的帮助信息。 +

+
--namespaced     默认值:true
+

+ +如果为 false,则返回非命名空间作用域的资源,否则默认返回命名空间作用域的资源。 +

--no-headers
+

+ +当使用默认或自定义列输出格式时,不要打印标题(默认打印标题)。 +

+
-o, --output string
+

+ +输出格式,可选值为:wide、name。 +

--sort-by string
+

+ +如果非空,则使用指定字段对资源列表进行排序,此字段可以是 "name" 或 "kind"。 +

+
--verbs strings
+

+ +筛选支持指定动词的资源。 +

+
+ +## {{% heading "parentoptions" %}} + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--as string

+ +操作所用的伪装用户名。用户可以是常规用户或命名空间中的服务账号。 +

--as-group strings

+ +操作所用的伪装用户组,此标志可以被重复设置以指定多个组。 +

--as-uid string

+ +操作所用的伪装 UID。 +

--cache-dir string     默认值:"$HOME/.kube/cache"

+ +默认缓存目录。 +

--certificate-authority string

+ +证书机构的证书文件的路径。 +

--client-certificate string

+ +TLS 客户端证书文件的路径。 +

--client-key string

+ +TLS 客户端密钥文件的路径。 +

--cloud-provider-gce-l7lb-src-cidrs cidrs     默认值:130.211.0.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L7 负载均衡流量代理和健康检查开放的 CIDR。 +

--cloud-provider-gce-lb-src-cidrs cidrs     默认值:130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16

+ +GCE 防火墙中为 L4 负载均衡流量代理和健康检查开放的 CIDR。 +

--cluster string

+ +要使用的 kubeconfig 中集群的名称。 +

--context string

+ +要使用的 kubeconfig 上下文的名称。 +

--default-not-ready-toleration-seconds int     默认值:300

+ +设置针对 notReady:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--default-unreachable-toleration-seconds int     默认值:300

+ +设置针对 unreachable:NoExecute 的容忍度的 tolerationSeconds,默认添加到所有尚未设置此容忍度的 Pod。 +

--disable-compression

+ +如果为 true,则对服务器所有请求的响应不再压缩。 +

--insecure-skip-tls-verify

+ +如果为 true,则不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。 +

--kubeconfig string

+ +CLI 请求要使用的 kubeconfig 文件的路径。 +

--match-server-version

+ +要求服务器版本与客户端版本匹配。 +

-n, --namespace string

+ +如果存在,则是此 CLI 请求的命名空间范围。 +

--password string

+ +对 API 服务器进行基本身份验证所用的密码。 +

--profile string     默认值:"none"

+ +要记录的性能分析信息。可选值为(none|cpu|heap|goroutine|threadcreate|block|mutex)。 +

--profile-output string     默认值:"profile.pprof"

+ +性能分析信息要写入的目标文件的名称。 +

--request-timeout string     默认值:"0"

+ +在放弃某个服务器请求之前等待的时长。非零值应包含相应的时间单位(例如 1s、2m、3h)。 +值为零表示请求不会超时。 +

-s, --server string

+ +Kubernetes API 服务器的地址和端口。 +

--storage-driver-buffer-duration duration     默认值:1m0s

+ +对存储驱动的写入操作将被缓存的时长;缓存的操作会作为一个事务提交给非内存后端。 +

--storage-driver-db string     默认值:"cadvisor"

+ +数据库名称。 +

--storage-driver-host string     默认值:"localhost:8086"

+ +数据库 host:port。 +

--storage-driver-password string     默认值:"root"

+ +数据库密码。 +

--storage-driver-secure

+ +使用与数据库的安全连接。 +

--storage-driver-table string     默认值:"stats"

+ +表名。 +

--storage-driver-user string     默认值:"root"

+ +数据库用户名。 +

--tls-server-name string
+

+ +服务器证书验证所用的服务器名称。如果未提供,则使用与服务器通信所用的主机名。 +

+
--token string

+ +向 API 服务器进行身份验证的持有者令牌。 +

--user string

+ +要使用的 kubeconfig 用户的名称。 +

--username string

+ +对 API 服务器进行基本身份验证时所用的用户名。 +

--version version[=true]

+ +--version, --version=raw 打印版本信息并退出;--version=vX.Y.Z... 设置报告的版本。 +

--warnings-as-errors

+ +将从服务器收到的警告视为错误,并以非零退出码退出。 +

+ +## {{% heading "seealso" %}} + + +* [kubectl](../kubectl/) - kubectl 控制 Kubernetes 集群管理器 +* [kubectl top node](kubectl_top_node/) - 显示节点的资源(CPU/内存)使用情况 +* [kubectl top pod](kubectl_top_pod/) - 显示 Pod 的资源(CPU/内存)使用情况 diff --git a/content/zh-cn/docs/reference/kubectl/kubectl.md b/content/zh-cn/docs/reference/kubectl/kubectl.md index ee9c620195043..43ed6a1fe7af7 100644 --- a/content/zh-cn/docs/reference/kubectl/kubectl.md +++ b/content/zh-cn/docs/reference/kubectl/kubectl.md @@ -19,7 +19,7 @@ kubectl 管理控制 Kubernetes 集群。 -更多信息请查阅[命令行工具](/zh-cn/docs/kubectl/)(`kubectl`)。 +更多信息请查阅[命令行工具](/zh-cn/docs/reference/kubectl/)(`kubectl`)。 ```shell kubectl [flags] diff --git a/content/zh-cn/docs/tasks/administer-cluster/reserve-compute-resources.md b/content/zh-cn/docs/tasks/administer-cluster/reserve-compute-resources.md index eeee1b41380e8..40916de09f821 100644 --- a/content/zh-cn/docs/tasks/administer-cluster/reserve-compute-resources.md +++ b/content/zh-cn/docs/tasks/administer-cluster/reserve-compute-resources.md @@ -1,7 +1,6 @@ --- title: 为系统守护进程预留计算资源 content_type: task -min-kubernetes-server-version: 1.8 weight: 290 --- @@ -38,14 +36,14 @@ Kubernetes 推荐集群管理员按照每个节点上的工作负载密度配置 ## {{% heading "prerequisites" %}} -{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} +{{< include "task-tutorial-prereqs.md" >}} + -你的 kubernetes 服务器版本必须至少是 1.17 版本,才能使用 kubelet -命令行选项 `--reserved-cpus` 设置[显式预留 CPU 列表](#explicitly-reserved-cpu-list)。 +你可以使用 [kubelet 配置文件](/zh-cn/docs/tasks/administer-cluster/kubelet-config-file/)来配置以下 +kubelet [设置](/zh-cn/docs/reference/config-api/kubelet-config.v1beta1/)。 @@ -80,22 +78,21 @@ Kubernetes 节点上的 'Allocatable' 被定义为 Pod 可用计算资源量。 ### Enabling QoS and Pod level cgroups To properly enforce node allocatable constraints on the node, you must -enable the new cgroup hierarchy via the `--cgroups-per-qos` flag. This flag is +enable the new cgroup hierarchy via the `cgroupsPerQOS` setting. This setting is enabled by default. When enabled, the `kubelet` will parent all end-user pods under a cgroup hierarchy managed by the `kubelet`. --> ### 启用 QoS 和 Pod 级别的 cgroups {#enabling-qos-and-pod-level-cgroups} -为了恰当地在节点范围实施节点可分配约束,你必须通过 `--cgroups-per-qos` -标志启用新的 cgroup 层次结构。这个标志是默认启用的。 +为了恰当地在节点范围实施节点可分配约束,你必须通过 `cgroupsPerQOS` +设置启用新的 cgroup 层次结构。这个设置是默认启用的。 启用后,`kubelet` 将在其管理的 cgroup 层次结构中创建所有终端用户的 Pod。 ### Kube 预留值 {#kube-reserved} -- **Kubelet 标志**:`--kube-reserved=[cpu=100m][,][memory=100Mi][,][ephemeral-storage=1Gi][,][pid=1000]` -- **Kubelet 标志**:`--kube-reserved-cgroup=` +- **KubeletConfiguration 设置**:`kubeReserved: {}`。 + 示例值 `{cpu: 100m, memory: 100Mi, ephemeral-storage: 1Gi, pid=1000}` +- **KubeletConfiguration 设置**:`kubeReservedCgroup: ""` -`kube-reserved` 用来给诸如 `kubelet`、容器运行时、节点问题监测器等 +`kubeReserved` 用来给诸如 `kubelet`、容器运行时等 Kubernetes 系统守护进程记述其资源预留值。 -该配置并非用来给以 Pod 形式运行的系统守护进程预留资源。`kube-reserved` +该配置并非用来给以 Pod 形式运行的系统守护进程预留资源。`kubeReserved` 通常是节点上 `Pod 密度` 的函数。 除了 `cpu`、`内存` 和 `ephemeral-storage` 之外,`pid` 可用来指定为 Kubernetes 系统守护进程预留指定数量的进程 ID。 -要选择性地对 Kubernetes 系统守护进程上执行 `kube-reserved` 保护,需要把 kubelet 的 -`--kube-reserved-cgroup` 标志的值设置为 kube 守护进程的父控制组。 +要选择性地对 Kubernetes 系统守护进程上执行 `kubeReserved` 保护,需要把 kubelet 的 +`kubeReservedCgroup` 设置的值设为 kube 守护进程的父控制组, +并[将 `kube-reserved` 添加到 `enforceNodeAllocatable`](#enforcing-node-allocatable)。 -推荐将 Kubernetes 系统守护进程放置于顶级控制组之下(例如 systemd 机器上的 -`runtime.slice`)。 +推荐将 Kubernetes 系统守护进程放置于顶级控制组之下(例如 systemd 机器上的 `runtime.slice`)。 理想情况下每个系统守护进程都应该在其自己的子控制组中运行。 请参考[这个设计方案](https://git.k8s.io/design-proposals-archive/node/node-allocatable.md#recommended-cgroups-setup), 进一步了解关于推荐控制组层次结构的细节。 -请注意,如果 `--kube-reserved-cgroup` 不存在,Kubelet 将 **不会** 创建它。 +请注意,如果 `kubeReservedCgroup` 不存在,Kubelet 将 **不会** 创建它。 如果指定了一个无效的 cgroup,Kubelet 将会无法启动。就 `systemd` cgroup 驱动而言, 你要为所定义的 cgroup 设置名称时要遵循特定的模式: -所设置的名字应该是你为 `--kube-reserved-cgroup` 所给的参数值加上 `.slice` 后缀。 +所设置的名字应该是你为 `kubeReservedCgroup` 所给的参数值加上 `.slice` 后缀。 ### 系统预留值 {#system-reserved} -- **Kubelet 标志**:`--system-reserved=[cpu=100m][,][memory=100Mi][,][ephemeral-storage=1Gi][,][pid=1000]` -- **Kubelet 标志**:`--system-reserved-cgroup=` +- **KubeletConfiguration 设置**:`systemReserved: {}`。 + 示例值 `{cpu: 100m, memory: 100Mi, ephemeral-storage: 1Gi, pid=1000}` +- **KubeletConfiguration 设置**:`systemReservedCgroup: ""` -`system-reserved` 用于为诸如 `sshd`、`udev` 等系统守护进程记述其资源预留值。 -`system-reserved` 也应该为 `kernel` 预留 `内存`,因为目前 `kernel` +`systemReserved` 用于为诸如 `sshd`、`udev` 等系统守护进程记述其资源预留值。 +`systemReserved` 也应该为 `kernel` 预留 `内存`,因为目前 `kernel` 使用的内存并不记在 Kubernetes 的 Pod 上。 同时还推荐为用户登录会话预留资源(systemd 体系中的 `user.slice`)。 @@ -217,30 +216,31 @@ daemons. Kubernetes 系统守护进程预留指定数量的进程 ID。 -要想为系统守护进程上可选地实施 `system-reserved` 约束,请指定 kubelet 的 -`--system-reserved-cgroup` 标志值为 OS 系统守护进程的父级控制组。 +要想为系统守护进程上可选地实施 `systemReserved` 约束,请指定 kubelet 的 +`systemReservedCgroup` 设置值为 OS 系统守护进程的父级控制组, +并[将 `system-reserved` 添加到 `enforceNodeAllocatable`](#enforcing-node-allocatable)。 推荐将 OS 系统守护进程放在一个顶级控制组之下(例如 systemd 机器上的 `system.slice`)。 -请注意,如果 `--system-reserved-cgroup` 不存在,`kubelet` **不会** 创建它。 +请注意,如果 `systemReservedCgroup` 不存在,`kubelet` **不会** 创建它。 如果指定了无效的 cgroup,`kubelet` 将会失败。就 `systemd` cgroup 驱动而言, 你在指定 cgroup 名字时要遵循特定的模式: -该名字应该是你为 `--system-reserved-cgroup` 参数所设置的值加上 `.slice` 后缀。 +该名字应该是你为 `systemReservedCgroup` 参数所设置的值加上 `.slice` 后缀。 -**Kubelet 标志**: `--reserved-cpus=0-3` -**KubeletConfiguration 标志**:`reservedSystemCPUs: 0-3` +**KubeletConfiguration 设置**:`reservedSystemCPUs:`。示例值 `0-3` -`reserved-cpus` 旨在为操作系统守护程序和 Kubernetes 系统守护程序预留一组明确指定编号的 CPU。 -`reserved-cpus` 适用于不打算针对 cpuset 资源为操作系统守护程序和 Kubernetes +`reservedSystemCPUs` 旨在为操作系统守护程序和 Kubernetes 系统守护程序预留一组明确指定编号的 CPU。 +`reservedSystemCPUs` 适用于不打算针对 cpuset 资源为操作系统守护程序和 Kubernetes 系统守护程序定义独立的顶级 cgroups 的系统。 -如果 Kubelet **没有** 指定参数 `--system-reserved-cgroup` 和 `--kube-reserved-cgroup`, -则 `reserved-cpus` 的设置将优先于 `--kube-reserved` 和 `--system-reserved` 选项。 +如果 Kubelet **没有** 指定参数 `kubeReservedCgroup` 和 `systemReservedCgroup`, +则 `reservedSystemCPUs` 的设置将优先于 `kubeReservedCgroup` 和 `systemReservedCgroup` 选项。 ### 驱逐阈值 {#eviction-Thresholds} -**Kubelet 标志**:`--eviction-hard=[memory.available<500Mi]` +**KubeletConfiguration 设置**: +`evictionHard: {memory.available: "100Mi", nodefs.available: "10%", nodefs.inodesFree: "5%", imagefs.available: "15%"}`。 +示例值: `{memory.available: "<500Mi"}` 节点级别的内存压力将导致系统内存不足,这将影响到整个节点及其上运行的所有 Pod。 节点可以暂时离线直到内存已经回收为止。为了防止系统内存不足(或减少系统内存不足的可能性), kubelet 提供了[资源不足](/zh-cn/docs/concepts/scheduling-eviction/node-pressure-eviction/)管理。 驱逐操作只支持 `memory` 和 `ephemeral-storage`。 -通过 `--eviction-hard` 标志预留一些内存后,当节点上的可用内存降至预留值以下时, +通过 `evictionHard` 设置预留一些内存后,当节点上的可用内存降至预留值以下时, `kubelet` 将尝试驱逐 Pod。 如果节点上不存在系统守护进程,Pod 将不能使用超过 `capacity-eviction-hard` 所指定的资源量。 因此,为驱逐而预留的资源对 Pod 是不可用的。 @@ -321,13 +321,14 @@ kubelet 提供了[资源不足](/zh-cn/docs/concepts/scheduling-eviction/node-pr ### 实施节点可分配约束 {#enforcing-node-allocatable} -**Kubelet 标志**:`--enforce-node-allocatable=pods[,][system-reserved][,][kube-reserved]` +**KubeletConfiguration 设置**:`enforceNodeAllocatable: [pods]`。 +示例值:`[pods,system-reserved,kube-reserved]` 调度器将 'Allocatable' 视为 Pod 可用的 `capacity`(资源容量)。 @@ -337,35 +338,35 @@ by evicting pods whenever the overall usage across all pods exceeds 'Allocatable'. More details on eviction policy can be found on the [node pressure eviction](/docs/concepts/scheduling-eviction/node-pressure-eviction/) page. This enforcement is controlled by -specifying `pods` value to the kubelet flag `--enforce-node-allocatable`. +specifying `pods` value to the KubeletConfiguration setting `enforceNodeAllocatable`. --> `kubelet` 默认对 Pod 执行 'Allocatable' 约束。 无论何时,如果所有 Pod 的总用量超过了 'Allocatable',驱逐 Pod 的措施将被执行。 有关驱逐策略的更多细节可以在[节点压力驱逐](/zh-cn/docs/concepts/scheduling-eviction/pod-priority-preemption/)页找到。 -可通过设置 kubelet `--enforce-node-allocatable` 标志值为 `pods` 控制这个措施。 +可将 KubeletConfiguration `enforceNodeAllocatable` 设置为 `pods` 值来控制这个措施。 -可选地,通过在同一标志中同时指定 `kube-reserved` 和 `system-reserved` 值, -可以使 `kubelet` 强制实施 `kube-reserved` 和 `system-reserved` 约束。 -请注意,要想执行 `kube-reserved` 或者 `system-reserved` 约束, -需要对应设置 `--kube-reserved-cgroup` 或者 `--system-reserved-cgroup`。 +可选地,通过在同一设置中同时指定 `kube-reserved` 和 `system-reserved` 值, +可以使 `kubelet` 强制实施 `kubeReserved` 和 `systemReserved` 约束。 +请注意,要想执行 `kubeReserved` 或者 `systemReserved` 约束, +需要对应设置 `kubeReservedCgroup` 或者 `systemReservedCgroup`。 ## 一般原则 {#general-guidelines} @@ -373,32 +374,32 @@ resources if `kube-reserved` is enforced. [Guaranteed 的 Pod](/zh-cn/docs/tasks/configure-pod-container/quality-service-pod/#create-a-pod-that-gets-assigned-a-qos-class-of-guaranteed) 一样对待。 系统守护进程可以在与其对应的控制组中出现突发资源用量,这一行为要作为 Kubernetes 部署的一部分进行管理。 -例如,`kubelet` 应该有它自己的控制组并和容器运行时共享 `kube-reserved` 资源。 -不过,如果执行了 `kube-reserved` 约束,则 kubelet 不可出现突发负载并用光节点的所有可用资源。 +例如,`kubelet` 应该有它自己的控制组并和容器运行时共享 `kubeReserved` 资源。 +不过,如果执行了 `kubeReserved` 约束,则 kubelet 不可出现突发负载并用光节点的所有可用资源。 -在执行 `system-reserved` 预留策略时请加倍小心,因为它可能导致节点上的关键系统服务出现 CPU 资源短缺、 +在执行 `systemReserved` 预留策略时请加倍小心,因为它可能导致节点上的关键系统服务出现 CPU 资源短缺、 因为内存不足而被终止或者无法在节点上创建进程。 建议只有当用户详尽地描述了他们的节点以得出精确的估计值, 并且对该组中进程因内存不足而被杀死时,有足够的信心将其恢复时, -才可以强制执行 `system-reserved` 策略。 +才可以强制执行 `systemReserved` 策略。 * 作为起步,可以先针对 `pods` 上执行 'Allocatable' 约束。 -* 一旦用于追踪系统守护进程的监控和告警的机制到位,可尝试基于用量估计的方式执行 `kube-reserved` 策略。 -* 随着时间推进,在绝对必要的时候可以执行 `system-reserved` 策略。 +* 一旦用于追踪系统守护进程的监控和告警的机制到位,可尝试基于用量估计的方式执行 `kubeReserved` 策略。 +* 随着时间推进,在绝对必要的时候可以执行 `systemReserved` 策略。 ## 示例场景 {#example-scenario} 这是一个用于说明节点可分配(Node Allocatable)计算方式的示例: * 节点拥有 `32Gi` `memory`、`16 CPU` 和 `100Gi` `Storage` 资源 -* `--kube-reserved` 被设置为 `cpu=1,memory=2Gi,ephemeral-storage=1Gi` -* `--system-reserved` 被设置为 `cpu=500m,memory=1Gi,ephemeral-storage=1Gi` -* `--eviction-hard` 被设置为 `memory.available<500Mi,nodefs.available<10%` +* `kubeReserved` 被设置为 `{cpu: 1000m, memory: 2Gi, ephemeral-storage: 1Gi}` +* `systemReserved` 被设置为 `{cpu: 500m, memory: 1Gi, ephemeral-storage: 1Gi}` +* `evictionHard` 被设置为 `{memory.available: "<500Mi", nodefs.available: "<10%"}` -当没有执行 `kube-reserved` 和/或 `system-reserved` 策略且系统守护进程使用量超过其预留时, +当没有执行 `kubeReserved` 和/或 `systemReserved` 策略且系统守护进程使用量超过其预留时, 如果节点内存用量高于 31.5Gi 或 `storage` 大于 90Gi,kubelet 将会驱逐 Pod。 - diff --git a/data/i18n/en/en.toml b/data/i18n/en/en.toml index b16e8b6e042a6..a17986d897249 100644 --- a/data/i18n/en/en.toml +++ b/data/i18n/en/en.toml @@ -209,6 +209,9 @@ other = "email address" [javascript_required] other = "JavaScript must be [enabled](https://www.enable-javascript.com/) to view this content" +[k8s_birthday_show_original_content] +other = "Show original content…" + [katacoda_message] other = """

Shutdown of interactive tutorials

The interactive tutorials on this website are being shut down. The Kubernetes diff --git a/layouts/partials/head.html b/layouts/partials/head.html index 5bea1abf07d3a..8f94167ad95f3 100644 --- a/layouts/partials/head.html +++ b/layouts/partials/head.html @@ -87,10 +87,6 @@ -{{- if or (.HasShortcode "table") (.HasShortcode "feature-gate-table") -}} - -{{- end -}} - {{- if .HasShortcode "release-binaries" -}} {{- end -}} diff --git a/layouts/partials/hooks/head-end.html b/layouts/partials/hooks/head-end.html index 6918908c359d6..3221400ccf021 100644 --- a/layouts/partials/hooks/head-end.html +++ b/layouts/partials/hooks/head-end.html @@ -1 +1,11 @@ + +{{- if or (.HasShortcode "table") (.HasShortcode "feature-gate-table") -}} + {{- if hugo.IsProduction -}} + {{- $sortableTableJs := resources.Get "js/sortable-table.js" | minify | fingerprint -}} + + {{- else -}} + {{- $sortableTableJs := resources.Get "js/sortable-table.js" -}} + + {{- end -}} +{{- end -}} diff --git a/layouts/partials/kubernetes-overview.html b/layouts/partials/kubernetes-overview.html new file mode 100644 index 0000000000000..9446c9a422d21 --- /dev/null +++ b/layouts/partials/kubernetes-overview.html @@ -0,0 +1,33 @@ +{{- $shouldShowBirthdayBanner := false -}} +{{- $now := time.Now -}} +{{- with site.GetPage "page" "community/special/kubernetes-10th-birthday" -}} + {{- if and (lt ( (.Param "display_date_start") | time.AsTime ) $now ) (gt ( (.Param "display_date_end") | time.AsTime ) ( $now.AddDate 0 0 1 ) ) -}} + {{- $shouldShowBirthdayBanner = true -}} + {{- warnf "%s" "It's Kubernetes' birthday, fingers crossed this renders OK" -}} + {{- with resources.Get "images/k8s-10th-birthday.svg" -}} + {{- else -}} + {{- errorf "%s" "Birthday banner image missing" -}} + {{- end -}} + {{ end }} +{{- end -}} +{{- if $shouldShowBirthdayBanner -}} +

+
+

{{ "2014-06-06" | time.AsTime | time.Format ":date_long" }}

+ {{- with site.GetPage "page" "community/special/kubernetes-10th-birthday" -}} + + {{ .Content }} + + {{- else -}} + {{- errorf "%s" "10th Birthday content missing" -}} + {{- end -}} +

{{ printf "%s-06-06" ( time.Format "2006" $now ) | time.AsTime | time.Format ":date_long" }}

+
+
+
+
+
+{{- end -}} +
+ {{ .inner }} +
diff --git a/layouts/shortcodes/blocks/section.html b/layouts/shortcodes/blocks/section.html index 49e6d664be824..02138b39bd562 100644 --- a/layouts/shortcodes/blocks/section.html +++ b/layouts/shortcodes/blocks/section.html @@ -2,6 +2,10 @@ {{- $style := .Get "style" -}} {{- $id := .Get "id" | default (printf "section-%d" .Ordinal) -}} {{- $bg := .Get "background-image" -}} +{{/* special case Kubernetes overview */}} +{{- if eq $class "k8s-overview" -}} + {{- partial "kubernetes-overview.html" (dict "id" $id "class" $class "inner" $.Inner ) -}} +{{- else -}} {{- if $bg -}} {{ template "shortcodes-blocks_getimage" (dict "name" $bg "ctx" . "target" "bg") }} {{- end -}} @@ -9,3 +13,4 @@
{{ $.Inner }}
+{{- end -}} diff --git a/static/_redirects b/static/_redirects index 7133d75353df3..33080a5174840 100644 --- a/static/_redirects +++ b/static/_redirects @@ -454,3 +454,4 @@ /docs/concepts/overview/what-is-kubernetes/ /docs/concepts/overview/ 301 /docs/tasks/administer-cluster/verify-signed-images/ /docs/tasks/administer-cluster/verify-signed-artifacts/ 301 +/kubertenes /blog/2024/06/06/10-years-of-kubernetes/ 302 \ No newline at end of file