sorah/ruby

sorah-rbpkg/dockerfiles 镜像文档

一、镜像概述和主要用途

sorah-rbpkg/dockerfiles 是一个包含多个应用或工具的 Dockerfile 仓库（托管于 https://github.com/sorah-rbpkg/dockerfiles%EF%BC%89%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%8F%AF%E5%A4%8D%E7%94%A8%E7%9A%84 Docker 镜像构建配置。其主要用途是为开发者和运维人员提供标准化、可定制的镜像构建定义，简化基于 Docker 的服务部署流程，支持快速构建和部署各类应用环境或工具容器。

注意：由于 Docker Hub 速率限制问题，该仓库的镜像推送至 Docker Hub 可能不稳定。建议通过 GitHub 仓库获取 Dockerfile 自行构建镜像，而非直接从 Docker Hub 拉取（具体替代仓库请参考 GitHub 仓库 README 中的链接）。

二、核心功能和特性

基于仓库性质推断，主要特性包括：

• 多镜像支持：包含多个独立的 Dockerfile，可能覆盖不同应用场景（如工具链、服务端应用等）；
• 可定制化：Dockerfile 定义清晰，支持用户根据需求修改构建参数或基础镜像；
• 标准化构建：基于官方基础镜像（如 alpine、debian 等），遵循 Docker 最佳实践，确保镜像安全性和兼容性；
• 版本控制：通过 Git 仓库管理 Dockerfile 变更，便于追踪历史版本和回滚。

三、使用场景和适用范围

• 开发环境快速搭建：开发者可直接使用仓库中的 Dockerfile 构建本地开发环境，避免环境依赖冲突；
• CI/CD 流程集成：作为自动化构建环节的基础配置，用于在 CI 管道中生成应用镜像并部署；
• 服务容器化部署：为生产或测试环境提供标准化的容器镜像构建模板，简化服务部署流程；
• 多场景复用：适用于需要频繁使用多种 Docker 镜像的团队或个人，减少重复编写 Dockerfile 的工作量。

四、使用方法和配置说明

4.1 前提条件

• 已安装 Docker Engine（20.10+ 版本推荐）；
• 已安装 Git（用于克隆仓库）。

4.2 获取 Dockerfile

由于 Docker Hub 推送不稳定，不建议直接拉取镜像，请通过 GitHub 仓库获取 Dockerfile 并本地构建：

bash
# 克隆仓库
git clone https://github.com/sorah-rbpkg/dockerfiles.git
cd dockerfiles

# 进入目标应用的 Dockerfile 目录（以示例目录为例，具体目录需查看仓库结构）
cd <target-app-directory>  # 例如：cd ruby / cd nginx

4.3 构建镜像

在目标 Dockerfile 所在目录执行构建命令：

bash
# 基础构建命令（-t 指定镜像名称和标签）
docker build -t sorah-rbpkg/<app-name>:<tag> .

# 示例：构建 ruby 应用镜像，标签为 latest
docker build -t sorah-rbpkg/ruby:latest ./ruby

4.4 自定义配置

可通过以下方式调整构建参数：

• 修改 Dockerfile：直接编辑 Dockerfile 中的基础镜像版本（如 FROM ruby:3.2-slim）、依赖安装命令等；
• 构建时传参：使用 --build-arg 指定动态参数（需 Dockerfile 中定义 ARG）：

  bash
  docker build --build-arg APP_VERSION=1.0 -t sorah-rbpkg/app:1.0 .
  

五、Docker 部署方案示例

5.1 单镜像运行示例

构建完成后，通过 docker run 启动容器：

bash
# 示例：运行 ruby 镜像，挂载本地目录并暴露端口
docker run -d \
  --name ruby-app \
  -v $(pwd):/app \
  -p 3000:3000 \
  sorah-rbpkg/ruby:latest \
  ruby /app/main.rb

5.2 Docker Compose 配置示例

创建 docker-compose.yml，集成多个基于该仓库构建的镜像（以 ruby 和 nginx 为例）：

yaml
version: '3.8'
services:
  app:
    build:
      context: ./dockerfiles/ruby  # 指向仓库中 ruby 的 Dockerfile 目录
      args:
        RUBY_VERSION: 3.2  # 自定义 Ruby 版本
    volumes:
      - ./app:/app
    command: ruby /app/main.rb

  web:
    build: ./dockerfiles/nginx  # 指向仓库中 nginx 的 Dockerfile 目录
    ports:
      - "80:80"
    depends_on:
      - app

启动服务：

bash
docker-compose up -d

六、注意事项

1. Docker Hub 镜像可用性：由于 Docker Hub 速率限制，该仓库的镜像可能无法直接从 Docker Hub 拉取，务必通过 GitHub 仓库获取 Dockerfile 本地构建；
2. 镜像兼容性：不同 Dockerfile 可能依赖特定基础镜像或系统架构，构建前请查看对应 Dockerfile 的注释说明；
3. 安全更新：建议定期同步 GitHub 仓库更新，确保基础镜像和依赖组件为最新安全版本。

七、参考链接

• 官方仓库：https://github.com/sorah-rbpkg/dockerfiles
• Docker 构建文档：Docker Build 官方指南