bdwyertech/image-build-utils

Alpine Python with Ruby & Berkshelf 镜像文档

镜像概述

本镜像基于Alpine Linux构建，是一个轻量级Python运行环境，额外集成了最小化的Ruby环境和Berkshelf工具。它结合了Alpine Linux的轻量级特性（较小的镜像体积、高效的资源占用）与多语言工具链支持，适用于需要同时使用Python和Ruby相关工具的场景。

核心功能和特性

基础特性

• 轻量级基础：基于Alpine Linux，镜像体积小，启动速度快，资源占用低
• 多架构支持：支持常见CPU架构（如amd64、arm64），适配多种部署环境

Python环境

• 包含指定版本的Python运行时（具体版本需参考镜像标签，如3.9-alpine、3.11-alpine等）
• 预安装Python基础依赖工具（pip、setuptools）
• 支持通过pip扩展安装Python包

Ruby环境

• 最小化Ruby安装（仅包含核心运行时和必要依赖）
• 预安装gem包管理器，支持安装Ruby gems
• 精简的依赖树，减少不必要的系统库占用

Berkshelf集成

• 预安装Berkshelf（Chef生态的cookbook依赖管理工具）
• 支持通过berks命令管理Chef cookbook依赖、解析版本冲突
• 兼容主流Berkshelf工作流（如berks install、berks upload）

使用场景和适用范围

• 多语言开发环境：需要同时运行Python脚本和Ruby工具的本地化开发
• Chef生态开发：Chef cookbook开发中需使用Berkshelf管理依赖的场景
• CI/CD管道：轻量级CI/CD任务中执行跨语言脚本（如Python数据处理+Ruby工具链任务）
• 资源受限环境：边缘设备、嵌入式系统等对镜像体积和资源占用敏感的部署场景

使用方法和配置说明

基本使用

通过docker run命令启动交互式终端：

bash
docker run -it --rm [镜像名称]:[标签] sh

运行Python脚本示例：

bash
docker run --rm -v $(pwd):/app [镜像名称]:[标签] python /app/script.py

运行Berkshelf命令示例（管理Chef cookbooks）：

bash
docker run --rm -v $(pwd)/cookbooks:/cookbooks [镜像名称]:[标签] berks install -c /cookbooks/Berksfile

环境变量

持久化数据

通过挂载卷保存Python/Ruby依赖和Berkshelf缓存：

bash
docker run -it --rm \
  -v $(pwd)/python_deps:/usr/local/lib/pythonX.Y/site-packages \
  -v $(pwd)/ruby_gems:/usr/local/bundle \
  -v $(pwd)/berks_cache:/root/.berkshelf \
  [镜像名称]:[标签] sh

Docker Compose配置示例

yaml
version: '3'
services:
  app:
    image: docker.xuanyuan.run/[镜像名称]:[标签]
    volumes:
      - ./app:/app
      - python_deps:/usr/local/lib/pythonX.Y/site-packages
      - ruby_gems:/usr/local/bundle
    environment:
      - PYTHONUNBUFFERED=1
      - BERKSHELF_PATH=/app/.berkshelf
    command: sh -c "pip install -r /app/requirements.txt && berks install -c /app/Berksfile && python /app/main.py"

volumes:
  python_deps:
  ruby_gems:

自定义镜像构建

如需添加额外依赖，可基于此镜像构建自定义镜像：

dockerfile
FROM docker.xuanyuan.run/[镜像名称]:[标签]

# 安装Python依赖
RUN pip install requests numpy

# 安装Ruby gem
RUN gem install rake

# 安装系统依赖
RUN apk add --no-cache git openssh-client

注意事项

• 本镜像为最小化配置，部分高级Ruby/Python功能可能需要手动安装额外系统依赖（通过apk add）
• Berkshelf默认配置为非root用户使用，生产环境建议指定普通用户运行
• 镜像标签格式通常为[python版本]-alpine[alpine版本]-ruby[ruby版本]-berkshelf[berkshelf版本]，具体版本信息请参考镜像仓库说明