craftypenguins/k8s-init-mysql

Kubernetes初始化容器助手 - MySQL探针

这是一个简单的Go应用，可静态编译并构建为Scratch Docker容器，用作Kubernetes初始化容器，以检查MySQL服务是否存活且可用（使用提供的凭据），并可选择运行返回非空结果的SQL查询。

核心功能

• 验证MySQL服务的TCP连接可用性
• 使用指定用户名和密码登录数据库
• 执行自定义SQL查询并检查结果是否非空
• 静态编译，体积轻量，可在最小化Scratch容器中运行

使用场景

适用于Kubernetes集群中，在启动依赖MySQL的应用容器前，确保MySQL服务已完全就绪（包括连接正常、凭据有效、数据可访问），避免应用容器因数据库未准备好而启动失败。

配置说明

命令行参数

/k8s-init-mysql的使用方法：
  -dbhost string
    	要连接的主机IP或DNS（仅支持TCP，必填）
  -dbname string
    	数据库名称（必填）
  -dbpassword string
    	连接密码（必填）
  -dbsql string
    	测试用SQL（默认"select 1;"）
  -dbuser string
    	连接用户名（必填）

环境变量

支持通过以下环境变量配置（与命令行参数对应）：

• DBHOST
• DBNAME
• DBPASSWORD
• DBSQL
• DBUSER

注意：SQL语句需自行转义特殊字符。

部署示例

Docker运行示例

bash
docker run -t -e DBHOST=db.default.svc.cluster.local -e DBUSER=someone \
            -e DBPASSWORD=somepass -e DBNAME=somedb \
            craftypenguins/k8s-init-mysql:latest

Kubernetes初始化容器示例

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 1
  template:
    spec:
      initContainers:
      - name: check-mysql
        image: craftypenguins/k8s-init-mysql:latest
        env:
        - name: DBHOST
          value: "mysql-service.default.svc.cluster.local"
        - name: DBUSER
          value: "root"
        - name: DBPASSWORD
          valueFrom:
            secretKeyRef:
              name: mysql-secret
              key: password
        - name: DBNAME
          value: "mydb"
      containers:
      - name: my-app-container
        image: my-app-image:latest

许可证

本项目采用MIT许可证，详情请查看LICENSE.md文件。