Kubernetes发布SpringBoot项目过程总结

SpringBoot 项目创建完成后,通常会打成 jar 包运行,如果不使用 Kubernetes 可以直接通过 java -jar 或者脚本启动,如果需要发布到 Kubernetes 环境,那么需要编写 Dockerfile、构建镜像、推送到远程 harbor、编写 Kubernetes yaml 等步骤,假设目前你已经完成 SpringBoot 项目开发环境正常运行和打包,下面我会详细介绍如何完成镜像构建和运行这个过程。

1 编写 Dockerfile

  • 基于 centos7 构建 jdk 镜像,如果已经构建完成,请忽略该步骤,在构建 java 镜像过程建议使用 jdk 8u191 以上的版本,早期的 jdk 版本对容器的兼容性不好,严格来说,这是 java 本身的问题,早期的版本主要对内存和 CPU 的限制有问题,不支持自定义 CPU 数量以及设置 java heap 百分比;另外 java 虚拟机安装包中包含 jdk 和 jre 两部分,建议裁掉 jdk,只保留 jre 运行时环境,尽量减少镜像大小。

FROM docker.hub.com/dev/centos:7
MAINTAINER <[email protected]>
ADD java.tar.gz /usr/local/
ENV JAVA_HOME=/usr/local/java
ENV JRE_HOME=$JAVA_HOME/jre
ENV CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib:$CLASSPATH
ENV JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF8 -Duser.timezone=GMT+08"
ENV PATH=.:$JAVA_HOME/bin:$PATH
  • 在包含 Dockerfile 所在目录执行如下命令

docker build -t jdk:8u231 .
docker push jdk:8u231

2 基于java 镜像构建 jar 包镜像

  • 构建应用镜像,这里只展示应用 jar 包和启动脚本,可以通过 java -jar 启动,也可以使用脚本启动,建议使用脚本启动,这样更容易维护;另外创建 Kubernetes 资源对象时,可以利用 lifecycle 来管理运行前和关闭前的一些动作,比如在容器停止前优雅的关闭应用程序或者通知其它系统,可以通过在 PreStop 中完成。

FROM docker.hub.com/dev/jdk:8u231
MAINTAINER <[email protected]>
ADD elb.jar /usr/local/src/elb.jar
ADD startup.sh /usr/local/src/elb/
  • 在包含 Dockerfile 所在目录执行如下命令

docker build -t elb:2.0 .
docker push elb:2.0

3 编写 Kubernetes yaml

3.1 编写配置文件 ConfigMap yaml 文件

  • 配置建议存储到 Kubernetes ConfigMap 中,一来维护起来简单,不用修改镜像,二来对于后期的集群部署,一份配置多节点服务使用,降低运维成本。

apiVersion: v1
data:
  system.properties: |
    ######################系统配置######################
    server.tomcat.uri-encoding = UTF-8
    spring.http.encoding.charset = UTF-8
    spring.http.encoding.enabled = true
    .......
   db.properties: |
    ######################数据库配置#####################
    .......
  logback.xml: |     
    <?xml version="1.0" encoding="UTF-8"?>
    <configuration scan="true" scanPeriod="5 seconds" debug="false">
  .........
     </configuration>
kind: ConfigMap
metadata:
  name: elb-config
  namespace: default
  • 编写完成执行 kubectl apply -f yaml 文件。

3.2 编写配置文件 Department yaml 文件

  • 编写 Kubernetes Deployment 资源对象,Deployment 能够管理服务多个副本; 

  • 一定要把服务日志挂载到宿主机,这样出现服务出现异常后,便于查看日志分析问题;

  •  日志服务出现乱码,可以通过修改容器编码格式解决 en_US.utf8 ; 服务器时间不对,可以通过挂载本地时间或在 Dockerfile 镜像中添加时间环境变量解决。

  • 编写完成后执行 kubectl apply -f yaml 文件,通过 kubectl get pod 查看服务是否正常启动。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: elb-deployment
spec:
  selector:
    matchLabels:
      app: elb
  replicas: 1
  template:
    metadata:
      labels:
        app: elb
    spec:
      containers:
      - name: elb
        image: docker.hub.com/dev/elb:2.0
        imagePullPolicy: Always
        #command: ["/bin/bash","-c", "java -jar /usr/local/src/elb/elb.jar"]
        command: ["/bin/bash","-c", "/usr/local/src/elb/start.sh"]
        ports:
        - containerPort: 8080
        env:
         - name: LANG
           value: en_US.utf8
        volumeMounts:
        - mountPath: /etc/localtime
          name: date-config
        - mountPath: /conf/elb
          name: elb-config
        - mountPath: /logs/elb
          name: elb-log
      volumes:
      - name: date-config
        hostPath:
          path: /etc/localtime
      - name: elb-log
        hostPath:
          path: /logs/elb/
      - name: elb-config
        configMap: 
          name: elb-config
          items: 
          - key: system.properties
            path: system.properties
          - key: logback.xml
            path: logback.xml
          - key: db.properties
            path: db.properties

3.3 编写 Service 对外暴露端口

  • 正常线上环境应该使用 Service ClusterIP 类型,通过 Ingress-nginx 代理,因为通过 NodePort 对外暴露端口,不仅存在安全问题,而且不容易管理。这里是为了演示使用,对外暴露了 NodePort 端口,编写完成后,执行 kubectl apply -f yaml 文件,即完成了 svc 的创建。这时通过 IP 和 NodePort 即可访问服务。

apiVersion: v1
kind: Service
metadata:
  name: spt-service
  labels:
    app: sbt-service
spec:
  type: NodePort
  ports:
  - name: http
    port: 8080
    targetPort: 8080
    nodePort: 30111
  selector:
    app: elb

4 总结

如上所示已经完成 SpringBoot 项目的镜像构建以及 Kubernetes yaml 文件的编写和运行,即便如此,依然会遇到各种各样的问题,出现问题后注意通过 kubectl logs 观察服务日志输出,通过输出分析异常所在,一般情况下异常都是服务本身导致,比如镜像路径,执行脚本不存在等。如果从服务本身找不到问题,可以分析下基础镜像是否正常,比如运行一个简单服务,验证基础镜像正确性。

推荐阅读


如何使用 Ingress-nginx 进行前后端分离?

深入探究 K8S ConfigMap 和 Secret

Kubernetes入门培训(内含PPT)


原创不易,随手关注或者”在看“,诚挚感谢!

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章