Skip to content

Commit 836629c

Browse files
Bob Killenk8s-ci-robot
Bob Killen
authored andcommitted
Update extensible admission controller links (#9459)
* update extensible-admission-controller links * correct what-are-initializers link
1 parent 7960161 commit 836629c

File tree

7 files changed

+12
-12
lines changed

7 files changed

+12
-12
lines changed

content/en/blog/_posts/2017-06-00-Kubernetes-1.7-Security-Hardening-Stateful-Application-Extensibility-Updates.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Extensibility:
3636

3737
Additional Features:
3838

39-
- Alpha support for [external admission controllers](https://kubernetes.io/docs/admin/extensible-admission-controllers/) is introduced, providing two options for adding custom business logic to the API server for modifying objects as they are created and validating policy. 
39+
- Alpha support for [external admission controllers](https://kubernetes.io/docs/reference/access-authn-authz/extensible-admission-controllers/) is introduced, providing two options for adding custom business logic to the API server for modifying objects as they are created and validating policy. 
4040
- [Policy-based Federated Resource Placement](https://kubernetes.io/docs/tasks/federation/set-up-placement-policies-federation/) is introduced as Alpha providing placement policies for the federated clusters, based on custom requirements such as regulation, pricing or performance.
4141

4242
Deprecation: 

content/en/blog/_posts/2018-01-00-Introducing-Client-Go-Version-6.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ This blog post is one of a number of efforts to make client-go more accessible t
1717
The following API group promotions are part of Kubernetes 1.9:
1818

1919
- Workload objects (Deployments, DaemonSets, ReplicaSets, and StatefulSets) have been [promoted to the apps/v1 API group in Kubernetes 1.9](https://kubernetes.io/docs/reference/workloads-18-19/). client-go follows this transition and allows developers to use the latest version by importing the k8s.io/api/apps/v1 package instead of k8s.io/api/apps/v1beta1 and by using Clientset.AppsV1().
20-
- Admission Webhook Registration has been promoted to the admissionregistration.k8s.io/v1beta1 API group in Kubernetes 1.9. The former ExternalAdmissionHookConfiguration type has been replaced by the incompatible ValidatingWebhookConfiguration and MutatingWebhookConfiguration types. Moreover, the webhook admission payload type AdmissionReview in admission.k8s.io has been promoted to v1beta1. Note that versioned objects are now passed to webhooks. Refer to the admission webhook [documentation](https://kubernetes.io/docs/admin/extensible-admission-controllers/#external-admission-webhooks) for details.
20+
- Admission Webhook Registration has been promoted to the admissionregistration.k8s.io/v1beta1 API group in Kubernetes 1.9. The former ExternalAdmissionHookConfiguration type has been replaced by the incompatible ValidatingWebhookConfiguration and MutatingWebhookConfiguration types. Moreover, the webhook admission payload type AdmissionReview in admission.k8s.io has been promoted to v1beta1. Note that versioned objects are now passed to webhooks. Refer to the admission webhook [documentation](https://kubernetes.io/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks) for details.
2121

2222

2323

@@ -84,12 +84,12 @@ spec.version in body should be one of [v1.0.0 v1.0.1]
8484

8585

8686

87-
Note that with [Admission Webhooks](https://kubernetes.io/docs/admin/extensible-admission-controllers/#external-admission-webhooks), Kubernetes 1.9 provides another beta feature to validate objects before they are created or updated. Starting with 1.9, these webhooks also allow mutation of objects (for example, to set defaults or to inject values). Of course, webhooks work with CRDs as well. Moreover, webhooks can be used to implement validations that are not easily expressible with CRD validation. Note that webhooks are harder to implement than CRD validation, so for many purposes, CRD validation is the right tool.
87+
Note that with [Admission Webhooks](https://kubernetes.io/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks), Kubernetes 1.9 provides another beta feature to validate objects before they are created or updated. Starting with 1.9, these webhooks also allow mutation of objects (for example, to set defaults or to inject values). Of course, webhooks work with CRDs as well. Moreover, webhooks can be used to implement validations that are not easily expressible with CRD validation. Note that webhooks are harder to implement than CRD validation, so for many purposes, CRD validation is the right tool.
8888

8989

9090

9191
## Creating namespaced informers
92-
Often objects in one namespace or only with certain labels are to be processed in a controller. Informers [now allow](https://github.com/kubernetes/kubernetes/pull/54660) you to tweak the ListOptions used to query the API server to list and watch objects. Uninitialized objects (for consumption by [initializers](https://kubernetes.io/docs/admin/extensible-admission-controllers/#what-are-initializers)) can be made visible by setting IncludeUnitialized to true. All this can be done using the new NewFilteredSharedInformerFactory constructor for shared informers:
92+
Often objects in one namespace or only with certain labels are to be processed in a controller. Informers [now allow](https://github.com/kubernetes/kubernetes/pull/54660) you to tweak the ListOptions used to query the API server to list and watch objects. Uninitialized objects (for consumption by [initializers](https://kubernetes.io/docs/reference/access-authn-authz/extensible-admission-controllers/#what-are-initializers)) can be made visible by setting IncludeUnitialized to true. All this can be done using the new NewFilteredSharedInformerFactory constructor for shared informers:
9393

9494
```
9595

content/en/docs/concepts/extend-kubernetes/extend-cluster.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -155,8 +155,8 @@ Kubernetes provides several built-in authentication methods, and an [Authenticat
155155
After a request is authorized, if it is a write operation, it also goes through [Admission Control](/docs/admin/admission-controllers/) steps. In addition to the built-in steps, there are several extensions:
156156

157157
* The [Image Policy webhook](/docs/admin/admission-controllers/#imagepolicywebhook) restricts what images can be run in containers.
158-
* To make arbitrary admission control decisions, a general [Admission webhook](/docs/admin/extensible-admission-controllers/#admission-webhooks) can be used. Admission Webhooks can reject creations or updates.
159-
* [Initializers](/docs/admin/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.
158+
* 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.
159+
* [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.
160160

161161
## Infrastructure Extensions
162162

@@ -201,7 +201,7 @@ the nodes chosen for a pod.
201201
{{% capture whatsnext %}}
202202

203203
* Learn more about [Custom Resources](/docs/concepts/api-extension/custom-resources/)
204-
* Learn about [Dynamic admission control](/docs/admin/extensible-admission-controllers/)
204+
* Learn about [Dynamic admission control](/docs/reference/access-authn-authz/extensible-admission-controllers/)
205205
* Learn more about Infrastructure extensions
206206
* [Network Plugins](/docs/concepts/cluster-administration/network-plugins/)
207207
* [Device Plugins](/docs/concepts/cluster-administration/device-plugins/)

content/en/docs/reference/access-authn-authz/admission-controllers.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ is authenticated and authorized. The controllers consist of the
2626
administrator. In that list, there are two special controllers:
2727
MutatingAdmissionWebhook and ValidatingAdmissionWebhook. These execute the
2828
mutating and validating (respectively) [admission control
29-
webhooks](/docs/admin/extensible-admission-controllers.md#external-admission-webhooks)
29+
webhooks](/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks)
3030
which are configured in the API.
3131

3232
Admission controllers may be "validating", "mutating", or both. Mutating
@@ -325,7 +325,7 @@ In any case, the annotations are provided by the user and are not validated by K
325325
The admission controller determines the initializers of a resource based on the existing
326326
`InitializerConfiguration`s. It sets the pending initializers by modifying the
327327
metadata of the resource to be created.
328-
For more information, please check [Dynamic Admission Control](/docs/admin/extensible-admission-controllers.md).
328+
For more information, please check [Dynamic Admission Control](/docs/reference/access-authn-authz/extensible-admission-controllers/).
329329

330330
### LimitPodHardAntiAffinityTopology {#limitpodhardantiaffinitytopology}
331331

content/en/docs/reference/command-line-tools-reference/feature-gates.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -192,7 +192,7 @@ Each feature gate is designed for enabling/disabling a specific feature:
192192
- `GCERegionalPersistentDisk`: Enable the regional PD feature on GCE.
193193
- `HugePages`: Enable the allocation and consumption of pre-allocated [huge pages](/docs/tasks/manage-hugepages/scheduling-hugepages/).
194194
- `HyperVContainer`: Enable [Hyper-V isolation](https://docs.microsoft.com/en-us/virtualization/windowscontainers/manage-containers/hyperv-container) for Windows containers.
195-
- `Intializers`: Enable the [dynamic admission control](/docs/admin/extensible-admission-controllers/)
195+
- `Intializers`: Enable the [dynamic admission control](/docs/reference/access-authn-authz/extensible-admission-controllers/)
196196
as an extension to the built-in [admission controllers](/docs/admin/admission-controllers/).
197197
When the `Initializers` admission controller is enabled, this feature is automatically enabled.
198198
- `KubeletConfigFile`: Enable loading kubelet configuration from a file specified using a config file.

content/en/docs/reference/setup-tools/kubeadm/implementation-details.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -239,7 +239,7 @@ Other API server flags that are set unconditionally are:
239239
- `--allow-privileged` to `true` (required e.g. by kube proxy)
240240
- `--requestheader-client-ca-file` to `front-proxy-ca.crt`
241241
- `--enable-admission-plugins` to:
242-
- [`Initializers`](/docs/admin/admission-controllers/#initializers-alpha) to enable [Dynamic Admission Control](/docs/admin/extensible-admission-controllers/).
242+
- [`Initializers`](/docs/admin/admission-controllers/#initializers-alpha) to enable [Dynamic Admission Control](/docs/reference/access-authn-authz/extensible-admission-controllers/).
243243
- [`NamespaceLifecycle`](/docs/admin/admission-controllers/#namespacelifecycle) e.g. to avoid deletion of
244244
system reserved namespaces
245245
- [`LimitRanger`](/docs/admin/admission-controllers/#limitranger) and [`ResourceQuota`](/docs/admin/admission-controllers/#resourcequota) to enforce limits on namespaces

content/en/docs/tasks/administer-cluster/running-cloud-controller.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Successfully running cloud-controller-manager requires some changes to your clus
3939
* `kubelet` must run with `--cloud-provider=external`. This is to ensure that the kubelet is aware that it must be initialized by the cloud controller manager before it is scheduled any work.
4040
* `kube-apiserver` SHOULD NOT run the `PersistentVolumeLabel` admission controller
4141
since the cloud controller manager takes over labeling persistent volumes.
42-
* For the `cloud-controller-manager` to label persistent volumes, initializers will need to be enabled and an InitializerConifguration needs to be added to the system. Follow [these instructions](/docs/admin/extensible-admission-controllers.md#enable-initializers-alpha-feature) to enable initializers. Use the following YAML to create the InitializerConfiguration:
42+
* For the `cloud-controller-manager` to label persistent volumes, initializers will need to be enabled and an InitializerConifguration needs to be added to the system. Follow [these instructions](/docs/reference/access-authn-authz/extensible-admission-controllers/#enable-initializers-alpha-feature) to enable initializers. Use the following YAML to create the InitializerConfiguration:
4343

4444
{{< codenew file="admin/cloud/pvl-initializer-config.yaml" >}}
4545

0 commit comments

Comments
 (0)