wunderio/silta-deployment-remover

镜像概述

本容器暴露GIT网络钩子（webhooks），当接收到分支删除事件的网络钩子请求时，将登录Google Kubernetes集群并移除对应的Helm部署。主要用于自动清理与已删除分支关联的Kubernetes资源，提高集群资源利用率。

核心功能和特性

• 监听GIT仓库分支删除事件，自动触发Helm部署移除
• 支持任务队列机制，依赖Redis实现请求处理排队
• 可与多种GIT服务平台集成，响应网络钩子请求
• 基于Kubernetes权限控制，安全执行部署移除操作

兼容性

Github网络钩子

• https://docs.github.com/en/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#push
• 有效负载URL：<domain>/webhooks
• 内容类型：application/x-www-form-urlencoded
• 密钥：<与WEBHOOKS_SECRET相同>
• 事件类型：Branch or tag deletion（分支或标签删除）

Azure Repos服务钩子

• 网络钩子文档
• 服务类型：Web Hooks
• 触发事件：Code pushed（代码推送）
• URL：<domain>/webhooks
• 基本认证用户名：<任意值>
• 基本认证密码：<与WEBHOOKS_SECRET相同>

GitLab（未测试）

• 网络钩子文档

Bitbucket（未测试）

• 网络钩子文档

部署要求

1. Redis服务器：用于任务队列管理

2. 环境变量：容器需配置以下环境变量

   • WEBHOOKS_SECRET：网络钩子验证密钥
   • REDIS_HOST：Redis服务器地址
   • REDIS_PASSWORD：Redis访问密码

3. Kubernetes权限：部署时需使用具有以下权限的serviceAccountName：

   • 删除其他Pod的权限
   • 移除Helm发布的权限

配置步骤

Github组织应用配置

1. 在Github组织中创建自定义应用：
   https://github.com/organizations/<组织名称>/settings/apps/new

2. 基本配置：

   • 填写Webhook URL
   • 设置Webhook secret（可选，需与WEBHOOKS_SECRET一致）

3. 权限与事件配置：

   • 在"Application permissions"中，为"Repository contents"授予只读权限（r/o）
   • 在"Subscribe to events"中，勾选"Delete (Branch or tag deleted.)"事件

4. 启用应用：
   访问https://github.com/organizations/<组织名称>/settings/apps/<应用名称>/installations，设置网络钩子URL为<host>/webhooks（端口80）

Docker镜像构建

自动构建

通过Github标签触发自动构建：在Github中标记新的发布版本，Docker Hub集成将自动构建并发布镜像。

手动构建（仅自动构建失败时使用）

bash
docker build --tag 'wunderio/silta-deployment-remover:latest' \
             --tag 'wunderio/silta-deployment-remover:v1' \
             --tag 'wunderio/silta-deployment-remover:v1.X' \
             --tag 'wunderio/silta-deployment-remover:v1.X.Y' .

docker push wunderio/silta-deployment-remover:latest
docker push wunderio/silta-deployment-remover:v1
docker push wunderio/silta-deployment-remover:v1.X
docker push wunderio/silta-deployment-remover:v1.X.Y