nextstrain/base

Nextstrain Docker 基础镜像文档

1. 镜像概述和主要用途

该镜像为 Nextstrain 项目的 Docker 运行时基础镜像，主要用于支撑 Nextstrain CLI（命令行工具）的运行环境。作为基础镜像，它提供了 Nextstrain 工具链所需的底层系统依赖和运行时配置，确保 Nextstrain CLI 能够在标准化、一致的环境中稳定工作。

2. 核心功能和特性

• 基础运行环境：预配置 Nextstrain CLI 所需的系统依赖（如基础系统库、运行时工具等），减少用户环境配置复杂度。
• 兼容性保障：与 Nextstrain 工具链（包括 CLI 及相关分析工具）深度兼容，确保功能一致性。
• 标准化部署：作为官方指定基础镜像，支持 Nextstrain 工作流的可重复部署和跨环境迁移。

3. 使用场景和适用范围

• Nextstrain CLI 运行环境：作为 Nextstrain CLI 的底层依赖，提供其运行所需的完整环境。
• 生物信息学分析场景：适用于基于 Nextstrain 工具链的病原体基因组数据（如病毒、细菌）分析，包括进化树构建、传播动态可视化等任务。
• 开发与测试环境：为 Nextstrain 工具链的开发者提供标准化的本地开发和测试环境。

4. 使用方法和配置说明

4.1 基础信息参考

详细使用方法和配置请参考官方源码仓库的 https://github.com/nextstrain/docker-base#readme%E3%80%82

4.2 典型使用示例

4.2.1 作为 Nextstrain CLI 的依赖自动使用

Nextstrain CLI 会在运行时自动拉取并使用该基础镜像，无需手动配置。例如：

bash
# 通过 Nextstrain CLI 运行分析任务（自动依赖本基础镜像）
nextstrain build . --docker

4.2.2 手动运行镜像（调试或定制场景）

如需手动调试或基于该镜像构建定制环境，可直接运行：

bash
docker run --rm -it nextstrain/base:latest /bin/bash

4.2.3 在 Docker Compose 中作为基础镜像

如需将该镜像集成到自定义 Docker 工作流，可在 docker-compose.yml 中引用：

yaml
version: "3"
services:
  nextstrain-analysis:
    build:
      context: .
      dockerfile: Dockerfile  # 自定义 Dockerfile 中需以 `FROM nextstrain/base:latest` 开始
    volumes:
      - ./data:/data  # 挂载本地数据目录
    command: nextstrain build /data --docker

4.3 配置参数与环境变量

该镜像的核心配置由 Nextstrain 官方维护，具体环境变量和参数说明请参见 https://github.com/nextstrain/docker-base#readme%E3%80%82

5. 源码与更新

镜像源码托管于 https://github.com/nextstrain/docker-base%EF%BC%8C%E5%BB%BA%E8%AE%AE%E5%AE%9A%E6%9C%9F%E5%85%B3%E6%B3%A8%E8%AF%A5%E4%BB%93%E5%BA%93%E4%BB%A5%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E5%92%8C%E5%AE%89%E5%85%A8%E6%9B%B4%E6%96%B0%E3%80%82