zaaksam/alpine

镜像概述

本镜像基于alpine:3.8构建，集成了wait-for-it.sh脚本和zoneinfo.zip文件，主要用于Golang应用场景。wait-for-it.sh是一个纯bash脚本，用于等待指定主机和TCP端口可用，解决Docker容器间依赖服务启动同步问题；zoneinfo.zip为Golang应用提供时区支持，同时镜像已配置上海时区，确保时间一致性。

核心功能与特性

• 轻量级基础：基于Alpine 3.8，镜像体积小，资源占用低
• 服务依赖管理：集成wait-for-it.sh脚本，无需外部依赖，可等待其他服务端口就绪后再启动当前服务
• 时区配置：内置上海时区文件(/etc/localtime)，并设置/etc/timezone为Asia/Shanghai，支持Golang应用时区需求
• 优化源配置：使用中科大Alpine镜像源(https://mirrors.ustc.edu.cn/alpine/v3.8/main/)，提升包安装速度
• 基础工具集成：预装ca-certificates、openssh、bash等常用工具，满足基础操作需求

使用场景

• 需要在Docker环境中同步启动依赖服务的场景（如等待数据库、缓存服务就绪）
• Golang应用需要正确时区支持的部署场景
• 轻量级容器环境中需要基础网络工具和bash环境的场景

标签

• 3.8

Dockerfile

dockerfile
FROM alpine:3.8
LABEL maintainer="zaaksam@qq.com"
COPY zoneinfo.zip /usr/local/go/lib/time/zoneinfo.zip
COPY wait-for-it.sh /usr/local/bin/wait-for-it.sh
COPY zoneinfo/Asia/Shanghai /etc/localtime
RUN echo "Asia/Shanghai" > /etc/timezone \
    && echo "https://mirrors.ustc.edu.cn/alpine/v3.8/main/" > /etc/apk/repositories \
    && chmod 777 /usr/local/bin/wait-for-it.sh \
    && apk add --no-cache \
    ca-certificates \
    openssh \
    bash

使用方法示例

基本用法（等待服务就绪）

使用wait-for-it.sh等待目标服务（如MySQL）启动：

bash
docker run --rm zaaksam/wait-for-it:3.8 wait-for-it.sh mysql:3306 -t 60 -- echo "MySQL is ready"

在Docker Compose中使用

配合docker-compose管理多服务依赖，确保应用服务在数据库之后启动：

yaml
version: '3'
services:
  db:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: password
    ports:
      - "3306:3306"
  
  app:
    image: zaaksam/wait-for-it:3.8
    command: wait-for-it.sh db:3306 -t 30 -- /path/to/your/golang/app
    depends_on:
      - db

参数说明

wait-for-it.sh常用参数：

• <host>:<port>: 必选，目标服务的主机和端口
• -t <timeout>: 可选，超时时间（秒），默认15秒
• -- <command>: 可选，端口就绪后执行的命令

注意事项

• 确保目标服务的网络在容器间可达（如通过Docker Compose的服务名或自定义网络）
• zoneinfo.zip需与Golang运行时版本匹配，本镜像默认放置于/usr/local/go/lib/time/路径下
• 如需修改时区，可通过挂载自定义/etc/localtime文件或修改/etc/timezone实现