Iterait Docker镜像文档

镜像概述与主要用途

本仓库包含Iterait a.s.提供的开源Docker镜像，基于ArchLinux定制，支持CPU与GPU环境，适用于部署、开发及TensorFlow应用等场景。镜像设计兼顾灵活性与性能，可满足基础环境部署、开发工具链集成及深度学***任务（如GPU加速）等需求。

核心功能与特性

• 定制化ArchLinux环境：基于ArchLinux构建，集成yay包管理器，支持灵活扩展。
• 双环境支持：提供CPU-only与GPU-enabled两种版本，GPU版本通过nvidia-docker实现CUDA加速。
• 场景化镜像：包含基础部署环境、开发环境（集成base-devel）及TensorFlow运行环境。
• 灵活构建选项：支持通过构建参数指定是否启用CUDA，适配不同硬件需求。

使用场景与适用范围

详细使用方法与配置说明

镜像列表

Iterait提供的镜像已发布至DockerHub，包含以下版本：

构建指南

所有镜像支持通过标准Docker构建流程生成，可指定CPU或GPU版本。

1. 构建CPU-only镜像

使用常规Docker构建命令，可选择添加--squash参数压缩镜像层：

bash
docker build -t <镜像名称> -f <Dockerfile路径> --squash .

2. 构建GPU-enabled（CUDA）镜像

如需启用CUDA支持，通过--build-arg tag=cuda指定构建参数：

bash
docker build --build-arg tag=cuda -t <镜像名称>:cuda -f <Dockerfile路径> .

运行指南

1. CPU环境运行

直接通过docker run启动容器，示例如下：

bash
docker run -it <镜像名称> /bin/bash  # -it：交互式终端；/bin/bash：启动bash shell

2. GPU环境运行

需使用nvidia-docker（或Docker的nvidia运行时）启用GPU支持，关键配置如下：

• 运行时指定：--runtime=nvidia
• GPU设备控制：通过环境变量NVIDIA_VISIBLE_DEVICES指定可用GPU（如0,1表示第1、2块GPU）

示例（使用2块GPU并启动bash）：

bash
docker run --runtime=nvidia \
  -e NVIDIA_VISIBLE_DEVICES=0,1 \  # 指定使用GPU 0和1
  -it <镜像名称>:cuda /bin/bash    # 使用带cuda标签的镜像

关键参数说明