Kubernetes Init 容器:实现 Nginx 和 PHP 对 MySQL 的依赖检查

在设计 Kubernetes Pod 时,如果需要在启动 Nginx 和 PHP 之前等待 MySQL 启动完成,可以通过 初始化容器(initC) 来实现。初始化容器可以用于检查 MySQL 是否可用,只有在 MySQL 可用后,才会继续启动主容器(Nginx 和 PHP)。


设计思路

  1. 初始化容器(initC):

    • 使用一个简单的脚本或工具(如 mysql-client)来检查 MySQL 服务是否可用。

    • 如果 MySQL 可用,初始化容器成功退出(返回码 0),Kubernetes 会继续启动主容器。

    • 如果 MySQL 不可用,初始化容器会失败(返回码非 0),Kubernetes 会重试,直到 MySQL 可用或超时。

  2. 主容器:

    • 主容器包括 Nginx 和 PHP,它们会在初始化容器成功完成后启动。

具体实现

1. 编写初始化容器的脚本

创建一个脚本(如 wait-for-mysql.sh),用于检查 MySQL 是否可用。脚本内容如下:

bash 复制代码
#!/bin/sh
# wait-for-mysql.sh

set -e

host="$1"
port="$2"
shift 2
cmd="$@"

until nc -z -v -w30 "$host" "$port"; do
  echo "Waiting for MySQL to be available at $host:$port..."
  sleep 5
done

echo "MySQL is up - executing command"
exec $cmd
  • 该脚本使用 nc(netcat)工具检查 MySQL 的端口是否开放。

  • 如果 MySQL 不可用,脚本会每 5 秒重试一次,直到 MySQL 可用。


2. 创建 Kubernetes Pod 配置文件

以下是一个示例的 Pod 配置文件,包含初始化容器和主容器:

bash 复制代码
apiVersion: v1
kind: Pod
metadata:
  name: web-app
spec:
  initContainers:
    - name: wait-for-mysql
      image: busybox:latest
      command: ["sh", "-c", "/scripts/wait-for-mysql.sh mysql 3306"]
      volumeMounts:
        - name: scripts
          mountPath: /scripts
  containers:
    - name: nginx
      image: nginx:latest
      ports:
        - containerPort: 80
    - name: php
      image: php:7.4-fpm
      ports:
        - containerPort: 9000
  volumes:
    - name: scripts
      configMap:
        name: init-scripts

3. 创建 ConfigMap 存储脚本

将 wait-for-mysql.sh 脚本存储到 Kubernetes 的 ConfigMap 中:

bash 复制代码
apiVersion: v1
kind: ConfigMap
metadata:
  name: init-scripts
data:
  wait-for-mysql.sh: |
    #!/bin/sh
    set -e
    host="$1"
    port="$2"
    shift 2
    cmd="$@"
    until nc -z -v -w30 "$host" "$port"; do
      echo "Waiting for MySQL to be available at $host:$port..."
      sleep 5
    done
    echo "MySQL is up - executing command"
    exec $cmd

4. 部署 Pod
  1. 创建 ConfigMap:

    XML 复制代码
    kubectl apply -f init-scripts-configmap.yaml
  2. 创建 Pod:

    XML 复制代码
    kubectl apply -f web-app-pod.yaml

5. 运行逻辑

  1. 初始化容器:

    • 初始化容器会运行 wait-for-mysql.sh 脚本,检查 MySQL 服务是否可用。

    • 如果 MySQL 可用,初始化容器成功退出。

    • 如果 MySQL 不可用,初始化容器会不断重试,直到 MySQL 可用或超时。

  2. 主容器:

    • 当初始化容器成功退出后,Kubernetes 会启动主容器(Nginx 和 PHP)。

    • Nginx 和 PHP 可以安全地连接到 MySQL,因为 MySQL 已经可用。


6. 注意事项

  • MySQL 服务地址 : 确保 wait-for-mysql.sh 脚本中的 MySQL 地址(mysql)是正确的。如果 MySQL 运行在另一个 Pod 或外部服务中,需要使用正确的服务名称或 IP。

  • 超时机制 : 如果 MySQL 长时间不可用,初始化容器会一直重试。可以通过设置 activeDeadlineSeconds 来限制初始化容器的最大运行时间。

  • 工具依赖 : 确保初始化容器中安装了 nc(netcat)工具,或者使用其他工具(如 curl 或自定义脚本)来检查 MySQL 的可用性。


总结

通过初始化容器,可以确保 MySQL 服务可用后再启动 Nginx 和 PHP。这种方式非常适合依赖外部服务的应用场景,能够有效避免主容器启动时依赖服务未就绪的问题。

相关推荐
Csvn2 小时前
认识 Nginx
后端·nginx
云和数据.ChenGuang4 小时前
LangGraph 异步 Node 的设计与写法实践
开发语言·人工智能·python·机器学习·php
闲云自留地13 小时前
K8s 的记忆大脑!ETCD 集群部署、etcdctl 命令与备份恢复全通关
容器·kubernetes·etcd
大白玉米14 小时前
MoxPlayer 弹幕播放器源码智能解析线路管理系统自研内核
php
weirong16 小时前
Operator 上生产前补的 6 件事,和 5 件我明确不做的
kubernetes
陈希12316 小时前
Nginx 从入门到能扛事:反向代理、负载均衡与 HTTPS 实战
nginx·https·负载均衡
孙克旭_17 小时前
k8s基础组件与创建资源
运维·docker·容器·kubernetes
木头左1 天前
【Nginx】内网服务源 IP 白名单实战:动态域名解析放行网段 + 端口接管零改造
运维·nginx·白名单·反向代理
skywalk81631 天前
把 去也网站 从 Ubuntu 搬到 FreeBSD:一次 Service Jail + nginx 的部署实录
linux·运维·nginx·ubuntu·freebsd
吴声子夜歌1 天前
Kubernetes权威指南——网络原理(一)
网络·容器·kubernetes