api: OpenAPI support (kubeflow#577)

* hack: Add openapi-gen

Signed-off-by: Ce Gao <gaoce@caicloud.io>

* api: Generate openapi model

Signed-off-by: Ce Gao <gaoce@caicloud.io>

* linter_config: Add

Signed-off-by: Ce Gao <gaoce@caicloud.io>

* openapi: Add k8s.io

Signed-off-by: Ce Gao <gaoce@caicloud.io>

* .travis: Ignore openapi

Signed-off-by: Ce Gao <gaoce@caicloud.io>

* dep: Update

Signed-off-by: Ce Gao <gaoce@caicloud.io>

.travis.yml

@@ -30,7 +30,7 @@ script:
   # For now though we just run all tests in pkg.
   # And we can not use ** because goveralls uses filepath.Match
   # to match ignore files and it does not support it.
-  - goveralls -service=travis-ci -v -package ./pkg/... -ignore "pkg/client/*/*.go,pkg/client/*/*/*.go,pkg/client/*/*/*/*.go,pkg/client/*/*/*/*/*.go,pkg/client/*/*/*/*/*/*.go,pkg/client/*/*/*/*/*/*/*.go,pkg/apis/tensorflow/*/zz_generated.*.go"
+  - goveralls -service=travis-ci -v -package ./pkg/... -ignore "pkg/client/*/*.go,pkg/client/*/*/*.go,pkg/client/*/*/*/*.go,pkg/client/*/*/*/*/*.go,pkg/client/*/*/*/*/*/*.go,pkg/client/*/*/*/*/*/*/*.go,pkg/apis/tensorflow/*/zz_generated.*.go,pkg/apis/tensorflow/*/*_generated.go"
 
 notifications:
   webhooks: https://www.travisbuddy.com/

Gopkg.toml

@@ -6,6 +6,7 @@ required = [
   "k8s.io/code-generator/cmd/lister-gen",
   "k8s.io/code-generator/cmd/deepcopy-gen",
   "k8s.io/code-generator/cmd/defaulter-gen",
+  "k8s.io/code-generator/cmd/openapi-gen",
 
   # needed by generated clientsets, but not an explicit dep in client-gen itself
   "k8s.io/apimachinery/pkg/apimachinery/registered",
@@ -19,17 +20,21 @@ required = [
   name = "k8s.io/client-go"
   version = "~6.0.0"
 
+[[constraint]]
+  name = "k8s.io/kube-openapi"
+  branch = "release-1.9"
+
 [[constraint]]
   name = "k8s.io/kubernetes"
   version = "~v1.9.0"
 
 [[constraint]]
-  branch = "release-1.9"
   name = "k8s.io/api"
+  branch = "release-1.9"
 
 [[constraint]]
-  branch = "release-1.9"
   name = "k8s.io/apimachinery"
+  branch = "release-1.9"
 
 [[constraint]]
   name = "k8s.io/code-generator"

hack/update-codegen.sh

@@ -41,3 +41,7 @@ ${GOPATH}/bin/defaulter-gen  --input-dirs github.com/kubeflow/tf-operator/pkg/ap
 echo "Generating defaulters for v1alpha2"
 ${GOPATH}/bin/defaulter-gen  --input-dirs github.com/kubeflow/tf-operator/pkg/apis/tensorflow/v1alpha2 -O zz_generated.defaults --go-header-file hack/boilerplate/boilerplate.go.txt "$@"
 cd - > /dev/null
+
+echo "Generating OpenAPI specification for v1alpha2"
+${GOPATH}/bin/openapi-gen --input-dirs github.com/kubeflow/tf-operator/pkg/apis/tensorflow/v1alpha2,k8s.io/api/core/v1 --output-package github.com/kubeflow/tf-operator/pkg/apis/tensorflow/v1alpha2 --go-header-file hack/boilerplate/boilerplate.go.txt "$@"
+cd - > /dev/null

linter_config.json

@@ -30,6 +30,7 @@
     "pkg/apis/tensorflow/validation/validation_test.go",
     "pkg/apis/tensorflow/v1alpha2/zz_generated.deepcopy.go",
     "pkg/apis/tensorflow/v1alpha2/zz_generated.defaults.go",
+    "pkg/apis/tensorflow/v1alpha2/openapi_generated.go",
     "pkg/controller.v2/controller_utils.go"
   ],
   "Deadline": "300s",

pkg/apis/tensorflow/v1alpha2/doc.go

@@ -14,6 +14,7 @@
 
 // +k8s:deepcopy-gen=package,register
 // +k8s:defaulter-gen=TypeMeta
+// +k8s:openapi-gen=true
 
 // Package v1alpha2 is the v1alpha2 version of the API.
 // +groupName=kubeflow.org