[KYUUBI apache#844] Exposing Kyuubi as a NodePort service

hddong · yaooqinn · commit ab18262d190f · 2021-07-22T18:17:43.000+08:00
### _Why are the changes needed?_  `kubectl port-forward` usually use to test, use `NodePort` to visit kyuubi service in pod. ### _How was this patch tested?_ - [ ] Add some test cases that check the changes thoroughly including negative and positive cases if possible - [ ] Add screenshots for manual tests if appropriate - [X] [Run test](https://kyuubi.readthedocs.io/en/latest/tools/testing.html#running-tests) locally before make a pull request Closes apache#858 from hddong/kyuubi-844. Closes apache#844 d149226 [hongdongdong] modify comments 72d51d6 [hongdongdong] fix comments 9172798 [hongdongdong] fix a169332 [hongdongdong] fix comments 74cec93 [hongdongdong] [KYUUBI#844]Use NodePort to expose kyuubi port on k8s Authored-by: hongdongdong <hongdongdong@cmss.chinamobile.com> Signed-off-by: Kent Yao <yao@apache.org>
diff --git a/docker/kyuubi-pod.yaml b/docker/kyuubi-pod.yaml
@@ -17,20 +17,25 @@
 
 # Usage:
 # Start:
-#   kubectl apply -f https://raw.githubusercontent.com/apache/incubator-kyuubi/master/docker/example.yaml
-# Connect:
+#   kubectl apply -f https://raw.githubusercontent.com/apache/incubator-kyuubi/master/docker/kyuubi-pod.yaml
+# Expose port:
+# 1. Expose the Pod by port-forward, for temporary test
 #   kubectl port-forward kyuubi-example --address localhost 10009:10009
-# Or
-#   kubectl exec -it kyuubi-example -- /bin/bash
+#   Connect:
+#     kubectl exec -it kyuubi-example -- /bin/bash
 #
-#   ${SPARK_HOME}/bin/beeline -u 'jdbc:hive2://localhost:10009'
+#     ${SPARK_HOME}/bin/beeline -u 'jdbc:hive2://localhost:10009'
+# 2. Expose the Pod as a service with NodePort
+#   see usage of kyuubi-service.yaml
 # Logging
 #   kubectl logs -f kyuubi-example
 
 apiVersion: v1
 kind: Pod
 metadata:
   name: kyuubi-example
+  labels:
+    app: kyuubi-server
 spec:
   containers:
     - name: kyuubi-server
diff --git a/docker/kyuubi-service.yaml b/docker/kyuubi-service.yaml
@@ -0,0 +1,41 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+#
+
+# Usage:
+# Start:
+#   kubectl apply -f https://raw.githubusercontent.com/apache/incubator-kyuubi/master/docker/kyuubi-service.yaml
+# Connect:
+#   ${SPARK_HOME}/bin/beeline -u 'jdbc:hive2://${any_hostname_of_k8s_nodes}:30009'
+
+apiVersion: v1
+kind: Service
+metadata:
+  name: kyuubi-example-service
+spec:
+  ports:
+    # The default port limit is 30000-32767
+    # to change:
+    #   vim kube-apiserver.yaml (usually under path: /etc/kubernetes/manifests/)
+    #   add or change line 'service-node-port-range=1-32767' under kube-apiserver
+    - nodePort: 30009
+      # same of containerPort in pod yaml
+      port: 10009
+      protocol: TCP
+  type: NodePort
+  selector:
+    # same of pod label
+    app: kyuubi-server
