bowerswilkins/awaitpostgres

awaitpostgres镜像说明

镜像概述

awaitpostgres是一个轻量级Docker镜像，用于在执行依赖PostgreSQL的操作前等待数据库实例完全启动。例如，在Kubernetes的initContainers功能中，可确保PostgreSQL就绪后再运行后续任务或部署。

核心功能

• 通过指定的PostgreSQL URL反复尝试连接
• 成功连接时正常退出，失败时返回非零状态
• 支持配置重试次数和间隔时间

使用场景

• Kubernetes中依赖PostgreSQL的任务或部署前的初始化等待
• 本地开发或测试环境中，确保数据库启动后再执行应用程序

配置说明

需通过环境变量配置以下参数：

• POSTGRES_URL（必填）：PostgreSQL连接URL，包含实例地址、用户、密码等信息（如postgresql://postgres:@postgres:5432/postgres?sslmode=disable）
• RETRIES（可选）：重试连接次数，默认值为10
• WAIT_SECS（可选）：每次重试间隔秒数，默认值为2

Docker部署示例

基础使用步骤

1. 启动PostgreSQL实例：

bash
docker run -d --name postgres --publish 5432:5432 postgres:9.5

2. 使用awaitpostgres等待连接：

bash
docker run --env 'POSTGRES_URL=postgresql://postgres:@postgres:5432/postgres?sslmode=disable' --link postgres:postgres bowerswilkins/awaitpostgres

Kubernetes initContainers示例

前提条件

确保已安装Docker、Minikube、kubectl和watch工具。

操作步骤

1. 打开终端，运行以下命令监控Pod状态：

bash
watch kubectl get pods

2. 另开终端，导航到awaitpostgres目录，创建带awaitpostgres的任务：

bash
kubectl create -f kubernetes/toy_job_with_await.yml

此时Pod状态为Init:0/1，等待PostgreSQL启动。 3. 启动PostgreSQL部署：

bash
kubectl create -f kubernetes/postgres/

PostgreSQL就绪后，任务将执行并完成。

使用tmux快速启动

前提条件（macOS）：

bash
brew install watch tmux

启动监控：

bash
./tmux.sh
kubectl create -f kubernetes/toy_job_with_await.yml
kubectl create -f kubernetes/postgres/

关闭tmux会话：

bash
tmux kill-session -t awaitpostgres