From a55e66f9efd3b6d315381b8e8ff67896afbb1f10 Mon Sep 17 00:00:00 2001 From: Martin Vladev Date: Thu, 30 May 2019 05:10:19 +0200 Subject: [PATCH] Remove initializers feature gate (#14602) * Remove initializers feature gate Initializers are removed in 1.14 kubernetes/kubernetes#72972 * Update feature-gates.md --- .../extend-kubernetes/extend-cluster.md | 5 - .../docs/concepts/workloads/pods/podpreset.md | 2 +- .../admission-controllers.md | 25 +- .../feature-gates.md | 8 +- .../command-line-tools-reference/kubelet.md | 312 +++++++++--------- .../kubeadm/implementation-details.md | 5 +- content/en/examples/examples_test.go | 3 - 7 files changed, 171 insertions(+), 189 deletions(-) diff --git a/content/en/docs/concepts/extend-kubernetes/extend-cluster.md b/content/en/docs/concepts/extend-kubernetes/extend-cluster.md index 8b04771a07..61d0aacb9c 100644 --- a/content/en/docs/concepts/extend-kubernetes/extend-cluster.md +++ b/content/en/docs/concepts/extend-kubernetes/extend-cluster.md @@ -156,7 +156,6 @@ After a request is authorized, if it is a write operation, it also goes through * The [Image Policy webhook](/docs/reference/access-authn-authz/admission-controllers/#imagepolicywebhook) restricts what images can be run in containers. * To make arbitrary admission control decisions, a general [Admission webhook](/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks) can be used. Admission Webhooks can reject creations or updates. -* [Initializers](/docs/reference/access-authn-authz/extensible-admission-controllers/#initializers) are controllers that can modify objects before they are created. Initializers can modify initial object creations but cannot affect updates to objects. Initializers can also reject objects. ## Infrastructure Extensions @@ -210,7 +209,3 @@ the nodes chosen for a pod. * [List of Operators](https://github.com/operator-framework/awesome-operators) {{% /capture %}} - - - - diff --git a/content/en/docs/concepts/workloads/pods/podpreset.md b/content/en/docs/concepts/workloads/pods/podpreset.md index 5d7ab78c46..f301a7b1cb 100644 --- a/content/en/docs/concepts/workloads/pods/podpreset.md +++ b/content/en/docs/concepts/workloads/pods/podpreset.md @@ -74,7 +74,7 @@ In order to use Pod Presets in your cluster you must ensure the following: 1. You have enabled the admission controller `PodPreset`. One way to doing this is to include `PodPreset` in the `--enable-admission-plugins` option value specified for the API server. In minikube add this flag - `--extra-config=apiserver.enable-admission-plugins=Initializers,NamespaceLifecycle,LimitRanger,ServiceAccount,DefaultStorageClass,DefaultTolerationSeconds,NodeRestriction,MutatingAdmissionWebhook,ValidatingAdmissionWebhook,ResourceQuota,PodPreset` + `--extra-config=apiserver.enable-admission-plugins=NamespaceLifecycle,LimitRanger,ServiceAccount,DefaultStorageClass,DefaultTolerationSeconds,NodeRestriction,MutatingAdmissionWebhook,ValidatingAdmissionWebhook,ResourceQuota,PodPreset` while starting the cluster. 1. You have defined your Pod Presets by creating `PodPreset` objects in the namespace you will use. diff --git a/content/en/docs/reference/access-authn-authz/admission-controllers.md b/content/en/docs/reference/access-authn-authz/admission-controllers.md index 873475c07b..63ee908c52 100644 --- a/content/en/docs/reference/access-authn-authz/admission-controllers.md +++ b/content/en/docs/reference/access-authn-authz/admission-controllers.md @@ -90,7 +90,7 @@ kube-apiserver -h | grep enable-admission-plugins ``` In 1.14, they are: - + ```shell NamespaceLifecycle, LimitRanger, ServiceAccount, TaintNodesByCondition, Priority, DefaultTolerationSeconds, DefaultStorageClass, PersistentVolumeClaimResize, MutatingAdmissionWebhook, ValidatingAdmissionWebhook, ResourceQuota ``` @@ -218,7 +218,7 @@ add these tolerations. ### ImagePolicyWebhook {#imagepolicywebhook} -The ImagePolicyWebhook admission controller allows a backend webhook to make admission decisions. +The ImagePolicyWebhook admission controller allows a backend webhook to make admission decisions. #### Configuration File Format @@ -280,19 +280,19 @@ Note that webhook API objects are subject to the same versioning compatibility r An example request body: ```json -{ +{ "apiVersion":"imagepolicy.k8s.io/v1alpha1", "kind":"ImageReview", - "spec":{ - "containers":[ - { + "spec":{ + "containers":[ + { "image":"myrepo/myimage:v1" }, - { + { "image":"myrepo/myimage@sha256:beb6bd6a68f114c1dc2ea4b28db81bdf91de202a9014972bec5e4d9171d90ed" } ], - "annotations":[ + "annotations":[ "mycluster.image-policy.k8s.io/ticket-1234": "break-glass" ], "namespace":"mynamespace" @@ -339,13 +339,6 @@ Examples of information you might put here are: In any case, the annotations are provided by the user and are not validated by Kubernetes in any way. In the future, if an annotation is determined to be widely useful, it may be promoted to a named field of ImageReviewSpec. -### Initializers {#initializers} {{< feature-state for_k8s_version="v1.13" state="alpha" >}} - -The admission controller determines the initializers of a resource based on the existing -`InitializerConfiguration`s. It sets the pending initializers by modifying the -metadata of the resource to be created. -For more information, please check [Dynamic Admission Control](/docs/reference/access-authn-authz/extensible-admission-controllers/). - ### LimitPodHardAntiAffinityTopology {#limitpodhardantiaffinitytopology} This admission controller denies any pod that defines `AntiAffinity` topology key other than @@ -513,7 +506,7 @@ plugin configuration file as the node selector. Conflicts result in rejection. {{< note >}} -PodNodeSelector allows forcing pods to run on specifically labeled nodes. Also see the PodTolerationRestriction +PodNodeSelector allows forcing pods to run on specifically labeled nodes. Also see the PodTolerationRestriction admission plugin, which allows preventing pods from running on specifically tainted nodes. {{< /note >}} diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates.md b/content/en/docs/reference/command-line-tools-reference/feature-gates.md index 45b52d016a..6adb02807b 100644 --- a/content/en/docs/reference/command-line-tools-reference/feature-gates.md +++ b/content/en/docs/reference/command-line-tools-reference/feature-gates.md @@ -17,7 +17,7 @@ Feature gates are a set of key=value pairs that describe alpha or experimental features. An administrator can use the `--feature-gates` command line flag on each component to turn a feature on or off. Each component supports a set of feature gates unique to that component. -Use `-h` flag to see a full set of feature gates for all components. +Use `-h` flag to see a full set of feature gates for all components. To set feature gates for a component, such as kubelet, use the `--feature-gates` flag assigned to a list of feature pairs: ```shell @@ -97,7 +97,8 @@ different Kubernetes components. | `HugePages` | `false` | Alpha | 1.8 | 1.9 | | `HugePages` | `true` | Beta| 1.10 | | | `HyperVContainer` | `false` | Alpha | 1.10 | | -| `Initializers` | `false` | Alpha | 1.7 | | +| `Initializers` | `false` | Alpha | 1.7 | 1.13 | +| `Initializers` | - | Deprecated | 1.14 | | | `KubeletConfigFile` | `false` | Alpha | 1.8 | 1.9 | | `KubeletPluginsWatcher` | `false` | Alpha | 1.11 | 1.11 | | `KubeletPluginsWatcher` | `true` | Beta | 1.12 | 1.12 | @@ -265,9 +266,6 @@ Each feature gate is designed for enabling/disabling a specific feature: - `GCERegionalPersistentDisk`: Enable the regional PD feature on GCE. - `HugePages`: Enable the allocation and consumption of pre-allocated [huge pages](/docs/tasks/manage-hugepages/scheduling-hugepages/). - `HyperVContainer`: Enable [Hyper-V isolation](https://docs.microsoft.com/en-us/virtualization/windowscontainers/manage-containers/hyperv-container) for Windows containers. -- `Intializers`: Enable the [dynamic admission control](/docs/reference/access-authn-authz/extensible-admission-controllers/) - as an extension to the built-in [admission controllers](/docs/reference/access-authn-authz/admission-controllers/). - When the `Initializers` admission controller is enabled, this feature is automatically enabled. - `KubeletConfigFile`: Enable loading kubelet configuration from a file specified using a config file. See [setting kubelet parameters via a config file](/docs/tasks/administer-cluster/kubelet-config-file/) for more details. - `KubeletPluginsWatcher`: Enable probe-based plugin watcher utility to enable kubelet diff --git a/content/en/docs/reference/command-line-tools-reference/kubelet.md b/content/en/docs/reference/command-line-tools-reference/kubelet.md index b4bbb54044..9778662481 100644 --- a/content/en/docs/reference/command-line-tools-reference/kubelet.md +++ b/content/en/docs/reference/command-line-tools-reference/kubelet.md @@ -31,12 +31,12 @@ HTTP server: The kubelet can also listen for HTTP and respond to a simple API #### Pod Lifecycle Event Generator (PLEG) -The Pod Lifecycle Event Generator is a function of the kubelet that creates a list of +The Pod Lifecycle Event Generator is a function of the kubelet that creates a list of the states for all containers and pods then compares it to the previous states of the -containers and pods in a process called Relisting. This allows the PLEG to know which -pods and containers need to be synced. In versions prior to 1.2, this was accomplished +containers and pods in a process called Relisting. This allows the PLEG to know which +pods and containers need to be synced. In versions prior to 1.2, this was accomplished by polling and was CPU intensive. By changing to this method, this significantly reduced -resource utilization allowing for better container density. +resource utilization allowing for better container density. ``` @@ -124,7 +124,7 @@ kubelet [flags] - --azure-container-registry-config string + --azure-container-registry-config string Path to the file container Azure container registry configuration information. @@ -132,995 +132,995 @@ kubelet [flags] - --boot-id-file string + --boot-id-file string Comma-separated list of files to check for boot-id. Use the first one that exists. (default "/proc/sys/kernel/random/boot_id") - --bootstrap-checkpoint-path string + --bootstrap-checkpoint-path string Path to the directory where the checkpoints are stored - --bootstrap-kubeconfig string + --bootstrap-kubeconfig string Path to a kubeconfig file that will be used to get client certificate for kubelet. If the file specified by --kubeconfig does not exist, the bootstrap kubeconfig is used to request a client certificate from the API server. On success, a kubeconfig file referencing the generated client certificate and key is written to the path specified by --kubeconfig. The client certificate and key file will be stored in the directory pointed by --cert-dir. - --cert-dir string + --cert-dir string The directory where the TLS certs are located. If --tls-cert-file and --tls-private-key-file are provided, this flag will be ignored. (default "/var/lib/kubelet/pki") - --cgroup-driver string + --cgroup-driver string Driver that the kubelet uses to manipulate cgroups on the host. - --cgroup-root string + --cgroup-root string Optional root cgroup to use for pods. This is handled by the container runtime on a best effort basis. Default: '', which means use the container runtime default. - --cgroups-per-qos + --cgroups-per-qos Enable creation of QoS cgroup hierarchy, if true top level QoS and pod cgroups are created. (default true) - --chaos-chance float + --chaos-chance float If > 0.0, introduce random client errors and latency. Intended for testing. - --client-ca-file string + --client-ca-file string If set, any request presenting a client certificate signed by one of the authorities in the client-ca-file is authenticated with an identity corresponding to the CommonName of the client certificate. - --cloud-config string + --cloud-config string The path to the cloud provider configuration file. - --cloud-provider string + --cloud-provider string The provider for cloud services. Specify empty string for running with no cloud provider. - --cloud-provider-gce-lb-src-cidrs cidrs + --cloud-provider-gce-lb-src-cidrs cidrs CIDRs opened in GCE firewall for LB traffic proxy & health checks (default 130.211.0.0/22,35.191.0.0/16,209.85.152.0/22,209.85.204.0/22) - --cluster-dns stringSlice + --cluster-dns stringSlice Comma-separated list of DNS server IP address. - --cluster-domain string + --cluster-domain string Domain for this cluster. - --cni-bin-dir string + --cni-bin-dir string The full path of the directory in which to search for CNI plugin binaries. Default: /opt/cni/bin - --cni-conf-dir string + --cni-conf-dir string The full path of the directory in which to search for CNI config files. Default: /etc/cni/net.d - --container-hints string + --container-hints string location of the container hints file (default "/etc/cadvisor/container_hints.json") - --container-runtime string + --container-runtime string The container runtime to use. Possible values: 'docker', 'remote', 'rkt(deprecated)'. (default "docker") - --container-runtime-endpoint string + --container-runtime-endpoint string [Experimental] The endpoint of remote runtime service. Currently unix socket is supported on Linux, and tcp is supported on windows. - --containerd string + --containerd string containerd endpoint (default "unix:///var/run/containerd.sock") - --containerized + --containerized Experimental support for running kubelet in a container. - --contention-profiling + --contention-profiling Enable lock contention profiling, if profiling is enabled - --cpu-cfs-quota + --cpu-cfs-quota Enable CPU CFS quota enforcement for containers that specify CPU limits (default true) - --cpu-manager-policy string + --cpu-manager-policy string CPU Manager policy to use. Possible values: 'none', 'static'. (default "none") - --cpu-manager-reconcile-period NodeStatusUpdateFrequency + --cpu-manager-reconcile-period NodeStatusUpdateFrequency CPU Manager reconciliation period. Examples: '10s', or '1m'. If not supplied, defaults to NodeStatusUpdateFrequency (default 10s) - --docker string + --docker string docker endpoint (default "unix:///var/run/docker.sock") - --docker-disable-shared-pid + --docker-disable-shared-pid The Container Runtime Interface (CRI) defaults to using a shared PID namespace for containers in a pod when running with Docker 1.13.1 or higher. Setting this flag reverts to the previous behavior of isolated PID namespaces. This ability will be removed in a future Kubernetes release. (default true) - --docker-endpoint string + --docker-endpoint string Use this for the docker endpoint to communicate with (default "unix:///var/run/docker.sock") - --docker-env-metadata-whitelist string + --docker-env-metadata-whitelist string a comma-separated list of environment variable keys that needs to be collected for docker containers - --docker-only + --docker-only Only report docker containers in addition to root stats - --docker-root string + --docker-root string DEPRECATED: docker root is read from docker info (this is a fallback, default: /var/lib/docker) (default "/var/lib/docker") - --docker-tls + --docker-tls use TLS to connect to docker - --docker-tls-ca string + --docker-tls-ca string path to trusted CA (default "ca.pem") - --docker-tls-cert string + --docker-tls-cert string path to client certificate (default "cert.pem") - --docker-tls-key string + --docker-tls-key string path to private key (default "key.pem") - --dynamic-config-dir string + --dynamic-config-dir string The Kubelet will use this directory for checkpointing downloaded configurations and tracking configuration health. The Kubelet will create this directory if it does not already exist. The path may be absolute or relative; relative paths start at the Kubelet's current working directory. Providing this flag enables dynamic Kubelet configuration. Presently, you must also enable the DynamicKubeletConfig feature gate to pass this flag. - --enable-controller-attach-detach + --enable-controller-attach-detach Enables the Attach/Detach controller to manage attachment/detachment of volumes scheduled to this node, and disables kubelet from executing any attach/detach operations (default true) - --enable-debugging-handlers + --enable-debugging-handlers Enables server endpoints for log collection and local running of containers and commands (default true) - --enable-load-reader + --enable-load-reader Whether to enable cpu load reader - --enable-server + --enable-server Enable the Kubelet's server (default true) - --enforce-node-allocatable stringSlice + --enforce-node-allocatable stringSlice A comma separated list of levels of node allocatable enforcement to be enforced by kubelet. Acceptable options are 'pods', 'system-reserved' & 'kube-reserved'. If the latter two options are specified, '--system-reserved-cgroup' & '--kube-reserved-cgroup' must also be set respectively. See /docs/tasks/administer-cluster/reserve-compute-resources/ for more details. (default [pods]) - --event-burst int32 + --event-burst int32 Maximum size of a bursty event records, temporarily allows event records to burst to this number, while still not exceeding event-qps. Only used if --event-qps > 0 (default 10) - --event-qps int32 + --event-qps int32 If > 0, limit event creations per second to this value. If 0, unlimited. (default 5) - --event-storage-age-limit string + --event-storage-age-limit string Max length of time for which to store events (per type). Value is a comma separated list of key values, where the keys are event types (e.g.: creation, oom) or "default" and the value is a duration. Default is applied to all non-specified event types (default "default=0") - --event-storage-event-limit string + --event-storage-event-limit string Max number of events to store (per type). Value is a comma separated list of key values, where the keys are event types (e.g.: creation, oom) or "default" and the value is an integer. Default is applied to all non-specified event types (default "default=0") - --eviction-hard mapStringString + --eviction-hard mapStringString A set of eviction thresholds (e.g. memory.available<1Gi) that if met would trigger a pod eviction. (default imagefs.available<15%,memory.available<100Mi,nodefs.available<10%,nodefs.inodesFree<5%) - --eviction-max-pod-grace-period int32 + --eviction-max-pod-grace-period int32 Maximum allowed grace period (in seconds) to use when terminating pods in response to a soft eviction threshold being met. - --eviction-minimum-reclaim mapStringString + --eviction-minimum-reclaim mapStringString A set of minimum reclaims (e.g. imagefs.available=2Gi) that describes the minimum amount of resource the kubelet will reclaim when performing a pod eviction if that resource is under pressure. - --eviction-pressure-transition-period duration + --eviction-pressure-transition-period duration Duration for which the kubelet has to wait before transitioning out of an eviction pressure condition. (default 5m0s) - --eviction-soft mapStringString + --eviction-soft mapStringString A set of eviction thresholds (e.g. memory.available<1.5Gi) that if met over a corresponding grace period would trigger a pod eviction. - --eviction-soft-grace-period mapStringString + --eviction-soft-grace-period mapStringString A set of eviction grace periods (e.g. memory.available=1m30s) that correspond to how long a soft eviction threshold must hold before triggering a pod eviction. - --exit-on-lock-contention + --exit-on-lock-contention Whether kubelet should exit upon lock-file contention. - --experimental-allocatable-ignore-eviction + --experimental-allocatable-ignore-eviction When set to 'true', Hard Eviction Thresholds will be ignored while calculating Node Allocatable. See /docs/tasks/administer-cluster/reserve-compute-resources/ for more details. [default=false] - --experimental-allowed-unsafe-sysctls stringSlice + --experimental-allowed-unsafe-sysctls stringSlice Comma-separated whitelist of unsafe sysctls or unsafe sysctl patterns (ending in *). Use these at your own risk. - --experimental-bootstrap-kubeconfig string + --experimental-bootstrap-kubeconfig string deprecated: use --bootstrap-kubeconfig - --experimental-check-node-capabilities-before-mount + --experimental-check-node-capabilities-before-mount [Experimental] if set true, the kubelet will check the underlying node for required components (binaries, etc.) before performing the mount - --experimental-kernel-memcg-notification + --experimental-kernel-memcg-notification If enabled, the kubelet will integrate with the kernel memcg notification to determine if memory eviction thresholds are crossed rather than polling. - --experimental-mounter-path string + --experimental-mounter-path string [Experimental] Path of mounter binary. Leave empty to use the default mount. - --experimental-qos-reserved mapStringString + --experimental-qos-reserved mapStringString A set of ResourceName=Percentage (e.g. memory=50%) pairs that describe how pod resource requests are reserved at the QoS level. Currently only memory is supported. [default=none] - --fail-swap-on + --fail-swap-on Makes the Kubelet fail to start if swap is enabled on the node. - --feature-gates mapStringBool + --feature-gates mapStringBool - A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
Accelerators=true|false
AdvancedAuditing=true|false (BETA - default=true)
AllAlpha=true|false (ALPHA - default=false)
AllowExtTrafficLocalEndpoints=true|false
AppArmor=true|false (BETA - default=true)
BlockVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CSIPersistentVolume=true|false (ALPHA - default=false)
CustomPodDNS=true|false (ALPHA - default=false)
CustomResourceValidation=true|false (BETA - default=true)
DebugContainers=true|false
DevicePlugins=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (ALPHA - default=false)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (ALPHA - default=false)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
HugePages=true|false (ALPHA - default=false)
Initializers=true|false (ALPHA - default=false)
KubeletConfigFile=true|false (ALPHA - default=false)
LocalStorageCapacityIsolation=true|false (ALPHA - default=false)
MountContainers=true|false (ALPHA - default=false)
MountPropagation=true|false (ALPHA - default=false)
PVCProtection=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (ALPHA - default=false)
PodPriority=true|false (ALPHA - default=false)
ReadOnlyAPIDataVolumes=true|false
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (ALPHA - default=false)
ServiceNodeExclusion=true|false (ALPHA - default=false)
ServiceProxyAllowExternalIPs=true|false
StreamingProxyRedirects=true|false (BETA - default=true)
SupportIPVSProxyMode=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
VolumeScheduling=true|false (ALPHA - default=false)
VolumeSubpath=true|false
+ A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
Accelerators=true|false
AdvancedAuditing=true|false (BETA - default=true)
AllAlpha=true|false (ALPHA - default=false)
AllowExtTrafficLocalEndpoints=true|false
AppArmor=true|false (BETA - default=true)
BlockVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CSIPersistentVolume=true|false (ALPHA - default=false)
CustomPodDNS=true|false (ALPHA - default=false)
CustomResourceValidation=true|false (BETA - default=true)
DebugContainers=true|false
DevicePlugins=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (ALPHA - default=false)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (ALPHA - default=false)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
HugePages=true|false (ALPHA - default=false)
KubeletConfigFile=true|false (ALPHA - default=false)
LocalStorageCapacityIsolation=true|false (ALPHA - default=false)
MountContainers=true|false (ALPHA - default=false)
MountPropagation=true|false (ALPHA - default=false)
PVCProtection=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (ALPHA - default=false)
PodPriority=true|false (ALPHA - default=false)
ReadOnlyAPIDataVolumes=true|false
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (ALPHA - default=false)
ServiceNodeExclusion=true|false (ALPHA - default=false)
ServiceProxyAllowExternalIPs=true|false
StreamingProxyRedirects=true|false (BETA - default=true)
SupportIPVSProxyMode=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
VolumeScheduling=true|false (ALPHA - default=false)
VolumeSubpath=true|false
- --file-check-frequency duration + --file-check-frequency duration Duration between checking config files for new data (default 20s) - --global-housekeeping-interval duration + --global-housekeeping-interval duration Interval between global housekeepings (default 1m0s) - --google-json-key string + --google-json-key string The Google Cloud Platform Service Account JSON Key to use for authentication. - --hairpin-mode string + --hairpin-mode string How should the kubelet setup hairpin NAT. This allows endpoints of a Service to loadbalance back to themselves if they should try to access their own Service. Valid values are "promiscuous-bridge", "hairpin-veth" and "none". (default "promiscuous-bridge") - --healthz-bind-address 0.0.0.0 + --healthz-bind-address 0.0.0.0 The IP address for the healthz server to serve on (set to 0.0.0.0 for all IPv4 interfaces and `::` for all IPv6 interfaces) (default 127.0.0.1) - --healthz-port int32 + --healthz-port int32 The port of the localhost healthz endpoint (set to 0 to disable) (default 10248) - --host-ipc-sources stringSlice + --host-ipc-sources stringSlice Comma-separated list of sources from which the Kubelet allows pods to use the host ipc namespace. (default [*]) - --host-network-sources stringSlice + --host-network-sources stringSlice Comma-separated list of sources from which the Kubelet allows pods to use of host network. (default [*]) - --host-pid-sources stringSlice + --host-pid-sources stringSlice Comma-separated list of sources from which the Kubelet allows pods to use the host pid namespace. (default [*]) - --hostname-override string + --hostname-override string If non-empty, will use this string as identification instead of the actual hostname. - --housekeeping-interval duration + --housekeeping-interval duration Interval between container housekeepings (default 10s) - --http-check-frequency duration + --http-check-frequency duration Duration between checking http for new data (default 20s) - --image-gc-high-threshold int32 + --image-gc-high-threshold int32 The percent of disk usage after which image garbage collection is always run. (default 85) - --image-gc-low-threshold int32 + --image-gc-low-threshold int32 The percent of disk usage before which image garbage collection is never run. Lowest disk usage to garbage collect to. (default 80) - --image-pull-progress-deadline duration + --image-pull-progress-deadline duration If no pulling progress is made before this deadline, the image pulling will be cancelled. (default 1m0s) - --image-service-endpoint string + --image-service-endpoint string [Experimental] The endpoint of remote image service. If not specified, it will be the same with container-runtime-endpoint by default. Currently unix socket is supported on Linux, and tcp is supported on windows. - --init-config-dir string + --init-config-dir string The Kubelet will look in this directory for the init configuration. The path may be absolute or relative; relative paths start at the Kubelet's current working directory. Omit this argument to use the built-in default configuration values. Presently, you must also enable the KubeletConfigFile feature gate to pass this flag. - --iptables-drop-bit int32 + --iptables-drop-bit int32 The bit of the fwmark space to mark packets for dropping. Must be within the range [0, 31]. (default 15) - --iptables-masquerade-bit int32 + --iptables-masquerade-bit int32 The bit of the fwmark space to mark packets for SNAT. Must be within the range [0, 31]. Please match this parameter with corresponding parameter in kube-proxy. (default 14) - --kube-api-burst int32 + --kube-api-burst int32 Burst to use while talking with kubernetes apiserver (default 10) - --kube-api-content-type string + --kube-api-content-type string Content type of requests sent to apiserver. (default "application/vnd.kubernetes.protobuf") - --kube-api-qps int32 + --kube-api-qps int32 QPS to use while talking with kubernetes apiserver (default 5) - --kube-reserved mapStringString + --kube-reserved mapStringString A set of ResourceName=ResourceQuantity (e.g. cpu=200m,memory=500Mi,ephemeral-storage=1Gi,pid=1000) pairs that describe resources reserved for kubernetes system components. Currently cpu, memory, pid, and local ephemeral storage for root file system are supported. See http://kubernetes.io/docs/user-guide/compute-resources for more detail. [default=none] - --kube-reserved-cgroup string + --kube-reserved-cgroup string Absolute name of the top level cgroup that is used to manage kubernetes components for which compute resources were reserved via '--kube-reserved' flag. Ex. '/kube-reserved'. [default=''] - --kubeconfig string + --kubeconfig string Path to a kubeconfig file, specifying how to connect to the API server. Providing --kubeconfig enables API server mode, omitting --kubeconfig enables standalone mode. - --kubelet-cgroups string + --kubelet-cgroups string Optional absolute name of cgroups to create and run the Kubelet in. - --lock-file string + --lock-file string The path to file for kubelet to use as a lock file. - --log-backtrace-at traceLocation + --log-backtrace-at traceLocation when logging hits line file:N, emit a stack trace (default :0) - --log-cadvisor-usage + --log-cadvisor-usage Whether to log the usage of the cAdvisor container - --log-dir string + --log-dir string If non-empty, write log files in this directory - --log-flush-frequency duration + --log-flush-frequency duration Maximum number of seconds between log flushes (default 5s) - --logtostderr + --logtostderr log to standard error instead of files (default true) - --machine-id-file string + --machine-id-file string Comma-separated list of files to check for machine-id. Use the first one that exists. (default "/etc/machine-id,/var/lib/dbus/machine-id") - --make-iptables-util-chains + --make-iptables-util-chains If true, kubelet will ensure iptables utility rules are present on host. (default true) - --manifest-url string + --manifest-url string URL for accessing the container manifest - --manifest-url-header --manifest-url-header 'a:hello,b:again,c:world' --manifest-url-header 'b:beautiful' + --manifest-url-header --manifest-url-header 'a:hello,b:again,c:world' --manifest-url-header 'b:beautiful' Comma-separated list of HTTP headers to use when accessing the manifest URL. Multiple headers with the same name will be added in the same order provided. This flag can be repeatedly invoked. For example: --manifest-url-header 'a:hello,b:again,c:world' --manifest-url-header 'b:beautiful' - --max-open-files int + --max-open-files int Number of files that can be opened by Kubelet process. (default 1000000) - --max-pods int32 + --max-pods int32 Number of Pods that can run on this Kubelet. (default 110) - --minimum-image-ttl-duration duration + --minimum-image-ttl-duration duration Minimum age for an unused image before it is garbage collected. - --network-plugin string + --network-plugin string The name of the network plugin to be invoked for various events in kubelet/pod lifecycle - --network-plugin-mtu int32 + --network-plugin-mtu int32 The MTU to be passed to the network plugin, to override the default. Set to 0 to use the default 1460 MTU. - --node-ip string + --node-ip string IP address of the node. If set, kubelet will use this IP address for the node - --node-labels mapStringString + --node-labels mapStringString Labels to add when registering the node in the cluster. - --node-status-update-frequency duration + --node-status-update-frequency duration Specifies how often kubelet posts node status to master. Note: be cautious when changing the constant, it must work with nodeMonitorGracePeriod in nodecontroller. (default 10s) - --oom-score-adj int32 + --oom-score-adj int32 The oom-score-adj value for kubelet process. Values must be within the range [-1000, 1000] (default -999) - --pod-cidr string + --pod-cidr string The CIDR to use for pod IP addresses, only used in standalone mode. - --pod-infra-container-image string + --pod-infra-container-image string The image whose network/ipc namespaces containers in each pod will use. (default "k8s.gcr.io/pause:3.1") - --pod-manifest-path string + --pod-manifest-path string Path to the directory containing pod manifest files to run, or the path to a single pod manifest file. Files starting with dots will be ignored. - --pods-per-core int32 + --pods-per-core int32 Number of Pods per core that can run on this Kubelet. The total number of Pods on this Kubelet cannot exceed max-pods, so max-pods will be used if this calculation results in a larger number of Pods allowed on the Kubelet. A value of 0 disables this limit. - --port int32 + --port int32 The port for the Kubelet to serve on. (default 10250) - --protect-kernel-defaults + --protect-kernel-defaults Default kubelet behaviour for kernel tuning. If set, kubelet errors if any of kernel tunables is different than kubelet defaults. - --provider-id string + --provider-id string Unique identifier for identifying the node in a machine database, i.e cloudprovider - --read-only-port int32 + --read-only-port int32 The read-only port for the Kubelet to serve on with no authentication/authorization (set to 0 to disable) (default 10255) - --really-crash-for-testing + --really-crash-for-testing If true, when panics occur crash. Intended for testing. - --register-node + --register-node Register the node with the apiserver. If --kubeconfig is not provided, this flag is irrelevant, as the Kubelet won't have an apiserver to register with. Default=true. (default true) - --register-with-taints []api.Taint + --register-with-taints []api.Taint Register the node with the given list of taints (comma separated "=:"). No-op if register-node is false. - --registry-burst int32 + --registry-burst int32 Maximum size of bursty pulls, temporarily allows pulls to burst to this number, while still not exceeding registry-qps. Only used if --registry-qps > 0 (default 10) - --registry-qps int32 + --registry-qps int32 If > 0, limit registry pull QPS to this value. - --resolv-conf string + --resolv-conf string Resolver configuration file used as the basis for the container DNS resolution configuration. (default "/etc/resolv.conf") - --root-dir string + --root-dir string Directory path for managing kubelet files (volume mounts,etc). (default "/var/lib/kubelet") - --rotate-certificates + --rotate-certificates Auto rotate the kubelet client certificates by requesting new certificates from the kube-apiserver when the certificate expiration approaches. - --rotate-server-certificates + --rotate-server-certificates Auto-request and rotate the kubelet serving certificates by requesting new certificates from the kube-apiserver when the certificate expiration approaches. Requires the RotateKubeletServerCertificate feature gate to be enabled, and approval of the submitted CertificateSigningRequest objects. - + - --runonce + --runonce If true, exit after spawning pods from local manifests or remote urls. Exclusive with --enable-server - --runtime-cgroups string + --runtime-cgroups string Optional absolute name of cgroups to create and run the runtime in. - --runtime-request-timeout duration + --runtime-request-timeout duration Timeout of all runtime requests except long running request - pull, logs, exec and attach. When timeout exceeded, kubelet will cancel the request, throw out an error and retry later. (default 2m0s) - --seccomp-profile-root string + --seccomp-profile-root string Directory path for seccomp profiles. (default "/var/lib/kubelet/seccomp") - --serialize-image-pulls + --serialize-image-pulls Pull images one at a time. We recommend *not* changing the default value on nodes that run docker daemon with version < 1.9 or an Aufs storage backend. Issue #10959 has more details. (default true) - --stderrthreshold severity + --stderrthreshold severity logs at or above this threshold go to stderr (default 2) - --storage-driver-buffer-duration duration + --storage-driver-buffer-duration duration Writes in the storage driver will be buffered for this duration, and committed to the non memory backends as a single transaction (default 1m0s) - --storage-driver-db string + --storage-driver-db string database name (default "cadvisor") - --storage-driver-host string + --storage-driver-host string database host:port (default "localhost:8086") - --storage-driver-password string + --storage-driver-password string database password (default "root") - --storage-driver-secure + --storage-driver-secure use secure connection with database - --storage-driver-table string + --storage-driver-table string table name (default "stats") - --storage-driver-user string + --storage-driver-user string database username (default "root") - --streaming-connection-idle-timeout duration + --streaming-connection-idle-timeout duration Maximum time a streaming connection can be idle before the connection is automatically closed. 0 indicates no timeout. Example: '5m' (default 4h0m0s) - --sync-frequency duration + --sync-frequency duration Max period between synchronizing running containers and config (default 1m0s) - --system-cgroups / + --system-cgroups / Optional absolute name of cgroups in which to place all non-kernel processes that are not already inside a cgroup under /. Empty for no container. Rolling back the flag requires a reboot. - --system-reserved mapStringString + --system-reserved mapStringString A set of ResourceName=ResourceQuantity (e.g. cpu=200m,memory=500Mi,ephemeral-storage=1Gi,pid=1000) pairs that describe resources reserved for non-kubernetes components. Currently only cpu, memory, and pid are supported. See http://kubernetes.io/docs/user-guide/compute-resources for more detail. [default=none] - --system-reserved-cgroup string + --system-reserved-cgroup string Absolute name of the top level cgroup that is used to manage non-kubernetes components for which compute resources were reserved via '--system-reserved' flag. Ex. '/system-reserved'. [default=''] - --tls-cert-file string + --tls-cert-file string File containing x509 Certificate used for serving HTTPS (with intermediate certs, if any, concatenated after server cert). If --tls-cert-file and --tls-private-key-file are not provided, a self-signed certificate and key are generated for the public address and saved to the directory passed to --cert-dir. @@ -1132,44 +1132,44 @@ kubelet [flags] Comma-separated list of cipher suites for the server. If omitted, the default Go cipher suites will be used. Possible values: TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305,TLS_ECDHE_ECDSA_WITH_RC4_128_SHA,TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305,TLS_ECDHE_RSA_WITH_RC4_128_SHA,TLS_RSA_WITH_3DES_EDE_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA256,TLS_RSA_WITH_AES_128_GCM_SHA256,TLS_RSA_WITH_AES_256_CBC_SHA,TLS_RSA_WITH_AES_256_GCM_SHA384,TLS_RSA_WITH_RC4_128_SHA - + - --tls-private-key-file string + --tls-private-key-file string File containing x509 private key matching --tls-cert-file. - -v, --v Level + -v, --v Level log level for V logs - --version version[=true] + --version version[=true] Print version information and quit - --vmodule moduleSpec + --vmodule moduleSpec comma-separated list of pattern=N settings for file-filtered logging - --volume-plugin-dir string + --volume-plugin-dir string The full path of the directory in which to search for additional third party volume plugins (default "/usr/libexec/kubernetes/kubelet-plugins/volume/exec/") - --volume-stats-agg-period duration + --volume-stats-agg-period duration Specifies interval for kubelet to calculate and cache the volume disk usage for all pods and volumes. diff --git a/content/en/docs/reference/setup-tools/kubeadm/implementation-details.md b/content/en/docs/reference/setup-tools/kubeadm/implementation-details.md index 8a5fe68a8c..067f3aa126 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/implementation-details.md +++ b/content/en/docs/reference/setup-tools/kubeadm/implementation-details.md @@ -108,7 +108,7 @@ In any case the user can skip specific preflight checks (or eventually all prefl - [warning] if extra arg flags for API server, controller manager, scheduler contains some invalid options - [warning] if connection to https://API.AdvertiseAddress:API.BindPort goes through proxy - [warning] if connection to services subnet goes through proxy (only first address checked) -- [warning] if connection to Pods subnet goes through proxy (only first address checked) +- [warning] if connection to Pods subnet goes through proxy (only first address checked) - If external etcd is provided: - [Error] if etcd version less than 3.0.14 - [Error] if etcd certificates or keys are specified, but not provided @@ -235,7 +235,6 @@ Other API server flags that are set unconditionally are: - `--allow-privileged` to `true` (required e.g. by kube proxy) - `--requestheader-client-ca-file` to `front-proxy-ca.crt` - `--enable-admission-plugins` to: - - [`Initializers`](/docs/reference/access-authn-authz/admission-controllers/#initializers-alpha) to enable [Dynamic Admission Control](/docs/reference/access-authn-authz/extensible-admission-controllers/). - [`NamespaceLifecycle`](/docs/reference/access-authn-authz/admission-controllers/#namespacelifecycle) e.g. to avoid deletion of system reserved namespaces - [`LimitRanger`](/docs/reference/access-authn-authz/admission-controllers/#limitranger) and [`ResourceQuota`](/docs/reference/access-authn-authz/admission-controllers/#resourcequota) to enforce limits on namespaces @@ -379,7 +378,7 @@ existing cluster; for more details see also [design proposal](https://github.com setting API server and controller flags as already described in previous paragraphs. Please note that: -1. TLS bootstrapping for nodes can be configured with the [`kubeadm init phase bootstrap-token`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-bootstrap-token) +1. TLS bootstrapping for nodes can be configured with the [`kubeadm init phase bootstrap-token`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-bootstrap-token) command, executing all the configuration steps described in following paragraphs; alternatively, each step can be invoked individually #### Create a bootstrap token diff --git a/content/en/examples/examples_test.go b/content/en/examples/examples_test.go index 5cf09809ee..1aabb6775c 100644 --- a/content/en/examples/examples_test.go +++ b/content/en/examples/examples_test.go @@ -89,9 +89,6 @@ func validateObject(obj runtime.Object) (errors field.ErrorList) { // Enable CustomPodDNS for testing utilfeature.DefaultFeatureGate.Set("CustomPodDNS=true") switch t := obj.(type) { - case *admissionregistration.InitializerConfiguration: - // cluster scope resource - errors = ar_validation.ValidateInitializerConfiguration(t) case *api.ConfigMap: if t.Namespace == "" { t.Namespace = api.NamespaceDefault