ornladios/adios2

ADIOS 2 Docker镜像文档

镜像概述和主要用途

ADIOS 2 Docker镜像用于测试和部署ADIOS 2框架。ADIOS 2（Adaptable Input/Output System version 2）是美国能源部Exascale计算计划的一部分，是一个面向科学数据I/O的发布/订阅（put/get）框架。该镜像支持在不同环境（超级计算机、云系统、个人电脑）中快速部署ADIOS 2，便于开发、测试和运行依赖科学数据I/O的高性能计算（HPC）应用。

核心功能和特性

ADIOS 2框架的核心功能和特性包括：

1. 高性能I/O

• 针对HPC应用优化的I/O可扩展性，支持大规模并行数据传输。

2. 多模式数据传输

• 统一接口支持多种传输介质，包括文件、广域网、远程直接内存访问（RDMA）等。
• 通过"数据引擎"（Engine）抽象，无需大幅修改代码即可切换传输模式。

3. 易用的两级API设计

• 全功能API：面向HPC应用，支持C++11、Fortran 90、C 99、Python 2/3。
• 简化高级API：面向数据分析，支持Python 2/3、C++11、Matlab。

4. 数据组织与管理

• 数据组（Data Groups）：默认采用延迟/预取/分组变量传输模式，最大化数据请求效率；单变量同步传输作为特例支持。
• 数据步骤（Data Steps）：通过I/O"步骤"抽象跟踪数据生产/消费过程，无需额外索引管理。

5. 跨平台与兼容性

• 基于MPI构建，支持MPI环境和非MPI串行代码（可选纯串行构建）。
• 兼容超级计算机、云平台及个人电脑。

使用场景和适用范围

• HPC应用开发与测试：超级计算机环境下科学数据I/O性能验证。
• 数据分析工具集成：通过简化API快速接入Python/Matlab等数据分析流程。
• 跨平台部署验证：在云系统或个人电脑上模拟HPC数据传输场景。
• 科学数据管道构建：实现文件、内存、网络等多介质数据流转。

详细使用方法和配置说明

获取ADIOS 2 Docker镜像

从源码构建镜像

ADIOS 2 Dockerfile位于项目源码仓库中，可通过以下步骤构建：

1. 克隆ADIOS 2源码仓库：

   bash
   git clone https://github.com/ornladios/ADIOS2.git
   cd ADIOS2
   

2. 进入Dockerfile目录（以Ubuntu 18.04为例）：

   bash
   cd scripts/docker/images/ubuntu18.04
   

3. 构建Docker镜像：

   bash
   docker build -t adios2:ubuntu18.04 .
   

基本使用示例

启动容器（测试环境）

bash
docker run -it --rm adios2:ubuntu18.04 /bin/bash

在容器内可运行ADIOS 2示例程序或测试脚本，验证框架功能。

集成到应用部署

可基于ADIOS 2镜像构建应用镜像，例如在Dockerfile中：

dockerfile
FROM adios2:ubuntu18.04
COPY ./your-hpc-app /app
WORKDIR /app
CMD ["./your-hpc-app"]

依赖与配置要求

• 构建镜像需Docker 18.09+。
• 运行HPC应用时，建议配置MPI环境（如容器内安装OpenMPI）。
• 如需支持特定传输模式（如RDMA），需在构建时启用对应引擎（通过CMake配置）。

文档与资源

• 官方用户指南：ADIOS 2 Read the Docs
• 源码与Dockerfile：https://github.com/ornladios/ADIOS2
• 安装文档：ADIOS 2安装指南