如何通过Webhook在Git推送配置后刷新Spring Config Server关联的K8s Pod

方案一：Spring Cloud Bus + Bitbucket Webhook（无重启刷新配置） #

这是Spring生态原生的配置动态刷新方案，无需重启Pod即可让应用加载最新配置。

1. 添加依赖配置 #

在Spring Config Server和所有需要刷新配置的客户端应用中，引入Spring Cloud Bus、消息中间件（以RabbitMQ为例）和Actuator依赖：

• Maven（pom.xml）：

  <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-bus-amqp</artifactId>
  </dependency>
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-actuator</artifactId>
  </dependency>
  

• Gradle（build.gradle）：

  implementation 'org.springframework.cloud:spring-cloud-starter-bus-amqp'
  implementation 'org.springframework.boot:spring-boot-starter-actuator'
  

2. 开启端点与消息中间件配置 #

在Config Server和客户端应用的配置文件（application.yml/application.properties）中，暴露Actuator刷新端点并配置RabbitMQ：

management:
  endpoints:
    web:
      exposure:
        include: bus-refresh, refresh
  endpoint:
    bus-refresh:
      enabled: true

spring:
  rabbitmq:
    host: rabbitmq-service.default.svc.cluster.local  # K8s内RabbitMQ服务地址
    port: 5672
    username: guest
    password: guest

同时，在客户端应用需要动态更新的配置类上添加@RefreshScope注解，确保配置变更能被感知：

@Configuration
@RefreshScope
public class AppConfig {
    @Value("${app.config.key}")
    private String configValue;
    // 其他配置逻辑
}

3. 配置Bitbucket Webhook #

登录Bitbucket目标仓库，进入Settings > Webhooks，点击Add webhook：

• 填写URL：Config Server在K8s中暴露的bus-refresh端点地址（需确保Bitbucket可访问，可通过Ingress或NodePort暴露），格式如http://config-server.example.com/actuator/bus-refresh
• 选择Triggers：仅勾选Repository push事件
• 保存Webhook

4. K8s部署注意事项 #

• 确保Config Server和所有客户端应用能通过K8s Service访问RabbitMQ
• 若通过Ingress暴露Config Server，需在Ingress规则中允许/actuator/bus-refresh路径的访问

方案二：K8s滚动更新（重启Pod加载新配置） #

若不想引入消息中间件，可通过CI/CD触发K8s Deployment滚动更新，让Pod重启后从Config Server拉取最新配置。

1. 配置CI/CD触发逻辑 #

在Bitbucket Pipelines（或其他CI/CD工具）中添加流水线，当配置仓库推送时执行以下操作：

# 更新Deployment的注解，触发滚动更新
kubectl set deployment <your-deployment-name> -n <namespace> annotation deployment.kubernetes.io/last-updated="$(date +%s)"

K8s会检测到Deployment的变更，自动重启所有Pod，Pod启动时将从Config Server拉取最新配置。

2. 确保启动时拉取最新配置 #

客户端应用需配置启动时从Config Server拉取配置：

spring:
  cloud:
    config:
      uri: http://config-server-service.default.svc.cluster.local
      name: your-app-config
      label: main  # 对应Bitbucket分支

方案三：定时轮询（简单但低效） #

适合对实时性要求不高的场景，通过定时任务触发配置刷新：

1. 客户端定时刷新配置 #

在客户端应用中添加定时任务，调用/actuator/refresh端点：

@Component
public class ConfigRefreshTask {
    @Autowired
    private RestTemplate restTemplate;

    @Scheduled(fixedRate = 300000) // 每5分钟执行一次
    public void refreshConfig() {
        restTemplate.postForObject("http://localhost:8080/actuator/refresh", null, String.class);
    }
}

2. Config Server定时拉取Git配置 #

在Config Server的配置文件中设置Git仓库拉取间隔：

spring:
  cloud:
    config:
      server:
        git:
          uri: git@bitbucket.org:your-repo/config-repo.git
          refresh-rate: 300  # 每5分钟拉取一次Git仓库

内容的提问来源于stack exchange，提问作者amit kumar