【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状态:
1.2 检查kubectl
关于kubectl,参考:https://kubernetes.io/zh/docs/reference/kubectl/
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即可:
再push镜像: push截图 push成功后,到docker hub上可以查到自己的repositories: repositories截图docker login
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服务
deploymentkubectl apply -f kubernetes-deployment.yml
4.3 验证Deployment全使用到的命令
kubectl get deployment
kubectl get pods
- 如果想要看Spring Boot的日志,可以使用
kubectl logs -f <pod_name>
4.4 问题排查(这章可跳过)
a. 使用kubectl get pods
发现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正在运行了:
4.5 创建公开Deployment的Service 对象
想要让Spring Boot项目的REST endpoint对外暴露,需要创建一个Service。
service创建成功kubectl expose deployment springboot-k8sdemo --type=NodePort
可以看到创建的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上分配一个端口作为外部访问入口。
另外,官网有个交互式教程,可以在线学习:交互式教程 - 暴露你的应用
4.6 也可使用端口转发(kubectl port-forward)来访问集群中的应用
如果4.5步骤expose后还是不能在本地浏览器中访问,可以通过端口转发,将service暴露到本地:
kubectl port-forward service/springboot-k8sdemo 8081:8081
这样就可以使用localhost:8081来访问了。