【k8s学习】布署Spring Boot项目到minikube上

目标是把Spring Boot项目布署到minikube上。

参考文章：

• https://www.baeldung.com/spring-boot-minikube
• https://blog.csdn.net/liuzhengyang1/article/details/121879460

1. 环境准备

1.1 minikube

MacOS环境，我是先安装了docker以及docker desktop，再用minikube start来启动。关于如何启动minikube，网上有很多教程。

Minikube Start

检查minikube状态：

minikube status

1.2 检查kubectl

关于kubectl，参考：https://kubernetes.io/zh/docs/reference/kubectl/

kubectl installed get nodes

2. Spring Boot项目通过Dockerfile构建image

查看我之前的文章：https://www.jianshu.com/p/dc1c4e2fc09c

3. push到Docker镜像仓库

Docker镜像仓库地址：https://hub.docker.com/

3.1 需要先注册一个个人帐号

3.2 会使用到以下两个命令：

• Docker tag命令：https://www.runoob.com/docker/docker-tag-command.html
• Docker push命令：https://www.runoob.com/docker/docker-push-command.html

docker tag：给我们本地的镜像加一个tag别名
将镜像spring-boot-docker-test标记成${名字为自己的docker hub的名字}/springboot-k8sdemo

docker tag spring-boot-docker-test <docker username>/springboot-k8sdemo

push镜像：

docker push <docker username>/springboot-k8sdemo

如果出现：denied: requested access to the resource is denied
需要先登陆，输入docker login，再提示再输入username，password即可：

docker login

再push镜像： push截图 push成功后，到docker hub上可以查到自己的repositories： repositories截图

4. kubernetes deployment

4.1 编写kubernetes deployment yaml文件

apiVersion: apps/v1
kind: Deployment
metadata:
  name: springboot-k8sdemo
spec:
  replicas: 1
  selector:
    matchLabels:
      app: springboot-k8sdemo
  template:
    metadata:
      labels:
        app: springboot-k8sdemo
    spec:
      containers:
        - image: <docker username>/spring-boot-docker-test
          name: springboot-k8sdemo
          ports:
            - containerPort: 8081

4.2 应用deployment

apply之后kubernetes内部就会部署springboot服务

kubectl apply -f kubernetes-deployment.yml

deployment

4.3 验证Deployment全使用到的命令

• kubectl get deployment
• kubectl get pods
• 如果想要看Spring Boot的日志，可以使用kubectl logs -f <pod_name>

4.4 问题排查（这章可跳过）

a. 使用kubectl get pods发现pod处于Error状态：

pod处于error状态

b. 查看pod日志，使用命令：kubectl logs -f <pod_name>
可以看到我在之前的文章中构建Dockerfile，使用的是动态传入VM options，在这边我先改下docker file，使得这个参数在images里面run的时候就set。

错误日志

c. 重新push之前，先把现有的deployment, pods都删掉

kubectl delete pods springboot-k8sdemo-66b85c897f-cvq95

kubectl delete deployment springboot-k8sdemo

d. 重新apply deployments后，发现pods正在运行了：

Pods list

4.5 创建公开Deployment的Service 对象

想要让Spring Boot项目的REST endpoint对外暴露，需要创建一个Service。

kubectl expose deployment springboot-k8sdemo --type=NodePort

service创建成功

可以看到创建的service，名字是springboot-k8sdemo，type是NodePort，在cluster-internal的IP是xx.xx.xx.xx（如10.106.11.133）。30539是NodePort。如果我们从外部（即我们的浏览器中访问），那么需要使用NodePort。
具体来说就是type=NodePort会把<NodeIP>:<NodePort>暴露给集群外部，所有来自<NodePort>的请求都会被转发到相应的Pods上。NodePort是自动生成的，一般范围在30000-32767之间。

这里有好多种IP， ClusterIP, NodeIP，可以看博文：https://blog.csdn.net/qq_21187515/article/details/101363521

可以调用进行测试：

minikube service springboot-k8sdemo

更多关于kubectl expose的学习：
官方文档：

• https://kubernetes.io/zh/docs/tutorials/stateless-application/expose-external-ip-address/
• https://jamesdefabia.github.io/docs/user-guide/kubectl/kubectl_expose/

kubectl expose命令：

kubectl expose (-f FILENAME | TYPE NAME) [--port=port] [--protocol=TCP|UDP] [--target-port=number-or-name] [--name=name] [--external-ip=external-ip-of-service] [--type=type]

kubectl expose的对象可以是rs（replicated），也可以是deployment，或是pod，或是service。
参数--type: Service的Type，可以是ClusterIP, NodePort, 或LoadBalancer，默认是ClusterIP。关于service type，更多可参考文章Kubernetes service 三种类型，上文中配置的NodePort表示在每个Node上分配一个端口作为外部访问入口。

另外，官网有个交互式教程，可以在线学习：交互式教程 - 暴露你的应用

教程 在线的命令行中，可以expose应用，然后再进行访问。可以看到kubectl expose后，通过curl访问成功！！ expose your deployment

4.6 也可使用端口转发（kubectl port-forward）来访问集群中的应用

如果4.5步骤expose后还是不能在本地浏览器中访问，可以通过端口转发，将service暴露到本地：

kubectl port-forward service/springboot-k8sdemo 8081:8081

这样就可以使用localhost:8081来访问了。