Merge pull request #9 from Electronic-Waste/feat/openapi-gen

feat: Generate OpenAPI specification for Tenant and Warehouse APIs.

Author: hantmac

hack/update-codegen.sh

@@ -27,3 +27,16 @@ kube::codegen::gen_client \
   --with-watch \
   --with-applyconfig \
   "${DATABEND_OPERATOR_ROOT}/pkg/apis"
+
+# Get the kube-openapi binary.
+OPENAPI_PKG=$(go list -m -mod=readonly -f "{{.Dir}}" k8s.io/kube-openapi)
+echo ">> Using ${OPENAPI_PKG}"
+
+echo "Generating OpenAPI specification for databendlabs.io/v1alpha1"
+go run ${OPENAPI_PKG}/cmd/openapi-gen \
+  --go-header-file "${DATABEND_OPERATOR_ROOT}/hack/boilerplate.go.txt" \
+  --output-pkg "${DATABEND_OPERATOR_PKG}/pkg/apis/databendlabs.io/v1alpha1" \
+  --output-dir "${DATABEND_OPERATOR_ROOT}/pkg/apis/databendlabs.io/v1alpha1" \
+  --output-file "zz_generated.openapi.go" \
+  --report-filename "${DATABEND_OPERATOR_ROOT}/hack/violation_exception_v1alpha1.list" \
+  "${DATABEND_OPERATOR_ROOT}/pkg/apis/databendlabs.io/v1alpha1"

hack/violation_exception_v1alpha1.list

@@ -0,0 +1,9 @@
+API rule violation: list_type_missing,github.com/databendcloud/databend-operator/pkg/apis/databendlabs.io/v1alpha1,MetaConfig,Endpoints
+API rule violation: list_type_missing,github.com/databendcloud/databend-operator/pkg/apis/databendlabs.io/v1alpha1,WarehouseSpec,PodTolerations
+API rule violation: names_match,github.com/databendcloud/databend-operator/pkg/apis/databendlabs.io/v1alpha1,DiskCacheSpec,MaxBytes
+API rule violation: names_match,github.com/databendcloud/databend-operator/pkg/apis/databendlabs.io/v1alpha1,MetaConfig,TimeoutInSeconds
+API rule violation: names_match,github.com/databendcloud/databend-operator/pkg/apis/databendlabs.io/v1alpha1,WarehouseSpec,Cache
+API rule violation: names_match,github.com/databendcloud/databend-operator/pkg/apis/databendlabs.io/v1alpha1,WarehouseSpec,PodLabels
+API rule violation: names_match,github.com/databendcloud/databend-operator/pkg/apis/databendlabs.io/v1alpha1,WarehouseSpec,PodResource
+API rule violation: names_match,github.com/databendcloud/databend-operator/pkg/apis/databendlabs.io/v1alpha1,WarehouseSpec,PodTolerations
+API rule violation: names_match,github.com/databendcloud/databend-operator/pkg/apis/databendlabs.io/v1alpha1,WarehouseStatus,Conditions

pkg/apis/databendlabs.io/v1alpha1/doc.go

@@ -0,0 +1,24 @@
+/*
+Copyright 2024.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// +k8s:defaulter-gen=TypeMeta
+// +k8s:openapi-gen=true
+// +k8s:deepcopy-gen=package
+
+// Package v1alpha1 is the v1alpha1 version of the API.
+// +groupName=databendlabs.io
+
+package v1alpha1