【K3S】07 - SpringBoot改造

前言

这一部分我们将改造SpringBoot，让它接入k3s的特性

优雅关机

概念

Kubernetes 中，Pod 的停止分为两种情况：

Graceful Termination：这种情况下，Kubernetes 会尽量通知 Pod 中的应用程序，让它们在关闭前优雅地完成正在进行的任务。具体来说，Kubernetes 会发送一个 TERM 信号给容器里的进程，然后等待一段时间（由 terminationGracePeriodSeconds 参数指定，默认值为 30 秒）以便让进程完成清理工作

Forceful Termination：如果在上述时间到期后，容器中的进程仍未退出，则 Kubernetes 会直接发送 KILL 信号给它们，强制终止容器

spring-boot-starter-actuator 是一个 Spring Boot 的扩展模块，它可以让你方便地监控和管理应用程序。该模块提供了一些 RESTful 接口和 JMX Beans，可以帮助你更好地了解和管理应用程序的运行状况。

以下是 spring-boot-starter-actuator 的一些常用特性：

/health：该接口可以用来检查应用程序的健康状态。默认情况下，当所有的 HealthIndicator 都返回 UP 时，应用程序被认为是健康的。
/info：该接口可以用来获取应用程序的信息。你可以通过设置 application.properties 文件中的信息来自定义输出的内容。
/metrics：该接口可以用来获取应用程序的指标数据，如 CPU 使用率、内存使用情况等。
/trace：该接口可以用来获取应用程序的请求跟踪日志。它可以帮助你定位应用程序中的问题。
/auditevents：该接口可以用来获取应用程序的审计事件。
/env：该接口可以用来获取应用程序的环境变量。
/loggers：该接口可以用来获取应用程序的日志配置，并修改日志级别。
/jolokia：该接口可以用来访问 JMX MBeans。

使用 spring-boot-starter-actuator，可以方便地通过 RESTful 接口和 JMX Beans 来监控和管理应用程序，这对于实时追踪应用程序的运行状况、快速排查问题都非常有帮助。

Spring Boot HealthIndicator 可以用于检查应用程序的健康状况，并将该信息公开，以便其他服务和负载均衡器可以使用。

在默认情况下，Spring Boot提供了以下HealthIndicator实现：

DiskSpaceHealthIndicator：检查磁盘空间是否足够。
DataSourceHealthIndicator：检查数据库连接是否正常。
RedisHealthIndicator：检查Redis连接是否正常。
MongoHealthIndicator：检查MongoDB连接是否正常。
ElasticsearchHealthIndicator：检查Elasticsearch连接是否正常。
RabbitHealthIndicator：检查RabbitMQ连接是否正常。
CassandraHealthIndicator：检查Cassandra连接是否正常。
SolrHealthIndicator：检查Solr连接是否正常。

当然，你也可以自定义HealthIndicator实现来检查其他服务或组件的健康状况。

实操

引入依赖

<dependency>
	<groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

修改application/yaml

我曾设置了 management.server.host:127.0.0.1 导致健康检查一直失败

spring:
  application:
    name: demo
  # 停机过程超时时长设置了20s，超过20s，直接停机
  lifecycle:
    timeout-per-shutdown-phase: 20s

server:
  port: 8080
  #  默认为IMMEDIATE，表示立即关机；GRACEFUL表示优雅关机
  shutdown: graceful

management:
  server:
    port: 50000
  # 开启shutdown endpoint
  endpoint:
    shutdown:
      enabled: true
  endpoints:
    web:
      base-path: /actuator
      exposure:
                # 暴露shutdown endpoint
        include: health,shutdown

修改 deployment

SpringBoot可不用配置

apiVersion: v1 
kind: Pod 
metadata:
  name: demopod
spec:
  containers:
  - image: springboot-demo:v1.10
    name: demo-container
    ports:
    - containerPort: 8080
    lifecycle:
      preStop:
        exec:
          command: ["curl", "-XPOST", "127.0.0.1:50000/private-url/shutdown"]

测试

未配置优雅关机

配置了优雅关机

健康检查

apiVersion: apps/v1
kind: Deployment
spec:
  template:
    spec:
      containers:
      - name: {APP_NAME}
        image: {IMAGE_URL}
        imagePullPolicy: Always
        ports:
        - containerPort: {APP_PORT}
        - name: management-port
          containerPort: 50000         # 应用管理端口
        readinessProbe:                # 就绪探针
          httpGet:
            path: /actuator/health/readiness
            port: management-port
          initialDelaySeconds: 30      # 延迟加载时间
          periodSeconds: 10            # 重试时间间隔
          timeoutSeconds: 1            # 超时时间设置
          successThreshold: 1          # 健康阈值
          failureThreshold: 6          # 不健康阈值
        livenessProbe:                 # 存活探针
          httpGet:
            path: /actuator/health/liveness
            port: management-port
          initialDelaySeconds: 30      # 延迟加载时间
          periodSeconds: 10            # 重试时间间隔
          timeoutSeconds: 1            # 超时时间设置
          successThreshold: 1          # 健康阈值
          failureThreshold: 6          # 不健康阈值