boky/alpine-bootstrap

镜像概述

本镜像基于Alpine构建，集成了多种常用工具，旨在为Docker和Kubernetes环境提供便捷的初始化容器支持及容器调试能力。适用于需要基础工具集的场景，如依赖服务等待、资源获取、容器内调试等。

核心功能与特性

内置工具集

• 文本处理工具：awk (gawk)、sed、vim
• 网络工具：curl、wget、busybox（含多种工具别名）
• 压缩工具：gzip、bzip2、xz
• 数据处理：jq（轻量级JSON处理器）
• 云原生工具：kubectl（Kubernetes客户端）
• 数据库工具：psql（PostgreSQL客户端）
• 安全工具：libressl（OpenSSL分支）

AWS专用脚本

• s3：无需完整AWS客户端，从AWS S3下载安全文件的bash脚本
• ecr-get-authorization-token：获取AWS ECR仓库授权令牌的脚本
• ecr-get-login：模拟aws ecr get-login输出的脚本
• ecr-describe-repositories：调用ECR DescribeRepositories API的脚本
• ecr-create-repository：调用ECR CreateRepository API的脚本

使用场景

• Kubernetes初始化容器：作为init容器等待依赖服务就绪
• 容器调试：临时进入容器执行命令、查看日志、网络诊断
• AWS资源操作：通过简化脚本操作S3、ECR等AWS服务
• 服务依赖管理：等待数据库、HTTP服务等依赖组件启动

使用方法

AWS脚本使用

环境变量要求

使用AWS脚本前需设置以下环境变量：

• AWS_ACCESS_KEY_ID：AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY：AWS密钥
• AWS_REGION：AWS区域

使用示例

bash
export AWS_ACCESS_KEY_ID=xxx 
export AWS_SECRET_ACCESS_KEY=yyy 
export AWS_REGION=eu-central-2 

# 从S3下载文件
s3 bucket path/file.ext > file.ext

# 获取ECR授权令牌
ecr-get-authorization-token

# 登录ECR
$(ecr-get-login)

wait-for-service脚本使用

wait-for-service脚本用于等待指定服务就绪，兼容fabric8-dependency-wait-service，具有体积小、跨平台的特点。

环境变量

命令参数

wait-for-service [参数] [服务地址] [-- 命令参数]

参数说明：
  -t, --timeout=TIMEOUT           脚本超时时间（同SCRIPT_TIMEOUT）
  -v, --verbose                   启用详细日志（同DEPENDENCY_LOG_VERBOSE=true）
  -q, --quiet                     禁用详细日志（同DEPENDENCY_LOG_VERBOSE=false）
  -c, --connection-timeout=TIMEOUT 连接超时时间（同DEPENDENCY_CONNECT_TIMEOUT）
  -p, --poll-interval=INTERVAL    轮询间隔（同DEPENDENCY_POLL_INTERVAL）
  -C, --color                     强制彩色输出

服务地址格式：
  tcp://host:port                 等待TCP服务（使用netcat）
  postgres://[user@]host[:port]   等待PostgreSQL服务（使用pg_isready）
  http[s]://host[:port]           等待HTTP/HTTPS服务（使用curl）

-- 命令参数                       服务就绪后执行的命令

支持的协议

• HTTP/HTTPS：发送HEAD请求，返回2xx状态码视为就绪，curl不可用时自动降级为TCP检查
• PostgreSQL：使用pg_isready检查，返回0退出码视为就绪，pg_isready不可用时自动降级为TCP检查
• TCP：使用netcat或/dev/tcp检查端口连通性，成功连接视为就绪

Kubernetes使用示例

yaml
spec:
  initContainers:
    - name: wait-for-dependencies
      image: "docker.xuanyuan.run/boky/alpine-bootstrap"
      command: [ 
        'wait-for-service', 
        '-p', '10',  # 轮询间隔10秒
        '-c', '10',  # 连接超时10秒
        'postgres://user@postgres:5432',  # 等待PostgreSQL
        'https://api-service:8080/health',  # 等待HTTP服务
        'tcp://redis:6379',  # 等待Redis TCP端口
        '--', 'echo', 'All dependencies are ready'  # 就绪后执行命令
      ]
      env:
        - name: DEPENDENCY_LOG_VERBOSE
          value: "false"  # 禁用详细日志

也可使用fabric8兼容的符号链接：

yaml
command: [ 'fabric8-dependency-wait-service-linux-amd64', 'postgres://user@postgres:5432' ]