From 12193177af89dd6819f9dda78b05b51ba4758e5e Mon Sep 17 00:00:00 2001 From: Jingfang Liu Date: Thu, 24 May 2018 11:47:58 -0700 Subject: [PATCH] README.md for adding a new sample project --- samples/README.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 samples/README.md diff --git a/samples/README.md b/samples/README.md new file mode 100644 index 00000000000..46bd6e87d34 --- /dev/null +++ b/samples/README.md @@ -0,0 +1,24 @@ +# Sample Project + +Sample project is a project that created by kubebuilder and moved into `samples` folder. It contains resources and controllers. The main purpose of sample projects is to test and validate the behavior of kubebuilder. Specifically, the new built kubebuilder commands don't break existing projects created by older version of kubebuilder commands. + +## Current Sample Projects +- memcached-api-apiserver + +## Test Sample Project +Run following command to test a sample project such as memcached-api-apiserver +``` +go test -v ./samples/memcached-api-apiserver +``` + +## Add Sample Project +We can test different aspects of kubebuilder in different sample projects. For example, we can test and validate how kubebuilder handles validation annotations in one sample project and validate how kubebuilder handles rbac rules in a different sample project. Here are steps to add a new project. + +- Create a new subdirectory under samples to hold the new sample project and change directory to it +- run `kubebuilder init` to init a project +- run `kubebuilder create resource` to create resources you want to add +- Update the resource or controller files for your test purpose. For example, add validation annotations in resource file. +- Create the expected files under `test`. For example, memcached-api-server has an expected file `test/hack/install.yaml`, which is used to compare with the output of `kubebuilder create config`. +- Write `_test.go` file to test the new sample project similar to memcached_test.go. + +