mattermost/mattermost-wait-for-dep

mattermost-wait-for-dep 镜像文档

镜像概述

mattermost-wait-for-dep是一个基于 https://github.com/dadarek/docker-wait-for-dependencies 项目构建的Docker镜像，主要用于在容器化环境中等待其他依赖容器启动并就绪，确保服务间的启动顺序正确。该镜像在 https://github.com/mattermost/mattermost-server 的官方Docker Compose配置中被使用。

核心功能与特性

• 依赖等待机制：能够检查指定的目标容器是否已启动并监听指定端口
• 轻量级设计：基于基础镜像构建，体积小，资源占用低
• 灵活配置：支持通过参数指定等待的目标主机、端口及超时时间
• 与Docker生态兼容：可无缝集成到Docker Compose等容器编排工具中

使用场景

• 多容器应用部署：在包含多个相互依赖服务的应用中（如Web服务依赖数据库），确保依赖服务完全启动后再启动当前服务
• Docker Compose环境：在docker-compose.yaml配置中协调服务启动顺序
• CI/CD流程：在自动化部署流程中确保服务依赖就绪后再执行后续步骤

使用方法

基本使用语法

bash
docker run mattermost/wait-for-dep [OPTIONS] <target-host>:<target-port>

常用参数说明

Docker Compose配置示例

以下是在Mattermost服务器部署中使用该镜像的示例（参考官方配置）：

yaml
version: '3'

services:
  mattermost:
    image: mattermost/server
    depends_on:
      - db
      - redis
    command: >
      sh -c "mattermost-wait-for-dep db:5432 &&
             mattermost-wait-for-dep redis:6379 &&
             /entrypoint.sh"
    # 其他配置...

  db:
    image: postgres:13
    # 数据库配置...

  redis:
    image: redis:6
    # Redis配置...

独立运行示例

等待名为db的容器的5432端口就绪，超时时间设为60秒：

bash
docker run mattermost/wait-for-dep --timeout 60 db:5432