如何通过kubectl运行Postgres官方镜像作为CLI客户端连接集群内服务排查问题

• 第一步：确认操作上下文匹配
  确保kubectl当前上下文对应的集群、命名空间和目标Postgres服务所在的集群、命名空间一致，如需指定命名空间，所有kubectl命令后添加-n <目标命名空间>参数即可。
• 第二步：启动带Postgres客户端的临时调试Pod
  执行以下命令启动临时Pod，同时将数据库密码注入环境变量PGPASSWORD，避免后续连接时重复输入密码：

kubectl run -i --tty --rm debug --image=postgres --restart=Never --env="PGPASSWORD=12345" -- sh

命令执行成功后会自动进入临时Pod的shell终端。

• 第三步：连接目标Postgres服务
  在临时Pod的终端中执行psql命令连接服务：

psql -h mypostgres -p 5432 -U postgres

连接成功后即可进入Postgres交互终端执行SQL语句排查问题。

• 常用排查操作参考
  • 查看所有数据库：输入\l
  • 切换到指定数据库：输入\c <数据库名>
  • 查看当前库所有表：输入\dt
  • 查询当前数据库连接数：执行SQL select count(*) from pg_stat_activity;
  • 退出Postgres终端：输入\q
  • 退出临时Pod：输入exit，Pod会自动删除无需手动清理
• 快捷操作（无需进入shell直接执行SQL）
  如果仅需执行单条SQL查询，可以直接在kubectl命令中指定psql执行逻辑，执行完成后Pod自动销毁：

# 示例：直接查询所有数据库列表
kubectl run -i --tty --rm debug --image=postgres --restart=Never --env="PGPASSWORD=12345" -- psql -h mypostgres -p 5432 -U postgres -c '\l'

• 连接失败排查点
  • 若临时Pod和目标Postgres不在同一命名空间，将连接host改为mypostgres.<目标命名空间>.svc.cluster.local即可
  • 确认集群内没有网络策略限制临时Pod访问Postgres服务的5432端口

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