From 735feeca9073c989e130843eec784faa7756a90d Mon Sep 17 00:00:00 2001
From: Nikhita Raghunath <nikitaraghunath@gmail.com>
Date: Mon, 8 Jan 2018 14:44:48 +0530
Subject: [PATCH] Add CustomResourceValidation example in sample-controller

- Mention the schema in the example CRD.
- Update README and mention about feature gates.

Kubernetes-commit: 74c9efa148ac6591a1dcf8f95c7fdac35aa603d0
---
 README.md                   | 16 ++++++++++++++++
 artifacts/examples/crd.yaml |  9 +++++++++
 2 files changed, 25 insertions(+)

diff --git a/README.md b/README.md
index d2aaf2b3..95ba305a 100644
--- a/README.md
+++ b/README.md
@@ -73,6 +73,22 @@ type User struct {
 }
 ```
 
+## Validation
+
+To validate custom resources, use the [`CustomResourceValidation`](https://kubernetes.io/docs/tasks/access-kubernetes-api/extend-api-custom-resource-definitions/#validation) feature.
+
+This feature is beta and enabled by default in v1.9. If you are using v1.8, enable the feature using
+the `CustomResourceValidation` feature gate on the [kube-apiserver](https://kubernetes.io/docs/admin/kube-apiserver):
+
+```sh
+--feature-gates=CustomResourceValidation=true
+```
+
+### Example
+
+The schema in the [example CRD](./artifacts/examples/crd.yaml) applies the following validation on the custom resource:
+`spec.replicas` must be an integer and must have a minimum value of 1 and a maximum value of 10.
+
 ## Cleanup
 
 You can clean up the created CustomResourceDefinition with:
diff --git a/artifacts/examples/crd.yaml b/artifacts/examples/crd.yaml
index 4a457068..36469161 100644
--- a/artifacts/examples/crd.yaml
+++ b/artifacts/examples/crd.yaml
@@ -9,3 +9,12 @@ spec:
     kind: Foo
     plural: foos
   scope: Namespaced
+  validation:
+    openAPIV3Schema:
+      properties:
+        spec:
+          properties:
+            replicas:
+              type: integer
+              minimum: 1
+              maximum: 10