Skip to content

Commit

Permalink
Added documentation around creating the InitializerConfiguration for …
Browse files Browse the repository at this point in the history
…the persistent volume label controller in the cloud-controller-manager (#5255)
  • Loading branch information
Rob Rati authored and steveperry-53 committed Sep 8, 2017
1 parent 7c19f53 commit 733de0e
Show file tree
Hide file tree
Showing 2 changed files with 17 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
kind: InitializerConfiguration
apiVersion: admissionregistration.k8s.io/v1alpha1
metadata:
name: pvlabel.kubernetes.io
initializers:
- name: pvlabel.kubernetes.io
rules:
- apiGroups:
- ""
apiVersions:
- "*"
resources:
- persistentvolumes
4 changes: 4 additions & 0 deletions docs/tasks/administer-cluster/running-cloud-controller.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,3 +32,7 @@ To run `cloud-controller-manager`, add it to your existing Kubernetes cluster as
The `kube-controller-manager` should not run any cloud-specific controllers, since the `cloud-controller-manager` takes over this responsibility. To prevent the `kube-controller-manager` from running cloud-specific controllers, you must set the `--cloud-provider` flag in `kube-controller-manager` to `external`.

The `kube-apiserver` should not run the Persistent Volume Label admission controller either since the `cloud-controller-manager` takes over labeling persistent volumes. To prevent the Persistent Volume Label admission plugin from running, make sure the `kube-apiserver` has a `--admission-control` flag with a value that does not include `PersistentVolumeLabel`.

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:

{% include code.html language="yaml" file="persistent-volume-label-initializer-config.yaml" ghlink="/docs/tasks/administer-cluster/persistent-volume-label-initializer-config.yaml" %}

0 comments on commit 733de0e

Please sign in to comment.