siffra/quasar-base

quasar-base Docker镜像文档

概述

quasar-base是一个通用的基础Docker镜像，设计用于作为其他应用程序镜像的基础。该镜像提供了精简而完整的运行环境，包含了常用的系统工具和核心依赖，旨在简化应用程序的容器化过程并确保环境一致性。

核心功能和特性

• 基于轻量级Linux发行版构建，体积小巧
• 包含常用系统工具和库，减少基础依赖安装时间
• 优化的镜像层结构，提高构建效率
• 预设安全最佳实践，降低容器运行风险
• 支持多架构，可在不同硬件平台上运行

使用场景和适用范围

• 作为自定义应用镜像的基础层
• 开发环境的统一基础
• CI/CD流程中的标准化构建环境
• 需要精简基础镜像的生产部署场景
• 微服务架构中的基础镜像统一

使用方法和配置说明

基本使用

作为基础镜像在Dockerfile中引用：

dockerfile
FROM docker.xuanyuan.run/quasar-base:latest

# 后续的自定义构建步骤

构建自定义镜像示例

dockerfile
# 使用quasar-base作为基础镜像
FROM docker.xuanyuan.run/quasar-base:latest

# 设置工作目录
WORKDIR /app

# 复制应用代码
COPY . .

# 安装应用依赖
RUN apt-get update && apt-get install -y \
    some-dependency \
    another-dependency && \
    rm -rf /var/lib/apt/lists/*

# 设置启动命令
CMD ["python", "app.py"]

docker-compose配置示例

yaml
version: '3'

services:
  my-app:
    build:
      context: .
      dockerfile: Dockerfile
    image: docker.xuanyuan.run/my-app:latest
    ports:
      - "8080:8080"
    depends_on:
      - db
    environment:
      - NODE_ENV=production

  db:
    image: docker.xuanyuan.run/postgres:13
    volumes:
      - db-data:/var/lib/postgresql/data

volumes:
  db-data:

环境变量

quasar-base镜像本身不依赖特定的环境变量，但可以通过以下方式在构建或运行时设置环境变量，以满足后续应用的需求：

构建时设置环境变量

dockerfile
FROM docker.xuanyuan.run/quasar-base:latest
ENV APP_HOME /app
WORKDIR $APP_HOME

运行时设置环境变量

bash
docker run -e "APP_ENV=production" docker.xuanyuan.run/my-app:latest

注意事项

• 定期更新基础镜像以获取安全补丁和更新
• 在生产环境中使用特定版本标签而非latest，确保构建一致性
• 基于此镜像构建应用时，注意清理临时文件和缓存，以减小最终镜像体积
• 如需添加额外系统依赖，建议在单一RUN指令中完成，以减少镜像层数

维护和更新

quasar-base镜像应定期更新以包含最新的安全补丁和系统更新。建议在Dockerfile中使用特定版本标签，并定期检查更新。

dockerfile
# 推荐使用特定版本而非latest
FROM quasar-base:1.2.3