vanessa/singularity

docker2singularity镜像说明

镜像概述

本镜像基于https://github.com/singularityware/docker2singularity%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%9B%86%E6%88%90Singularity%E5%9F%BA%E7%A1%80%E7%8E%AF%E5%A2%83%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%B0%86Docker%E9%95%9C%E5%83%8F%E8%BD%AC%E6%8D%A2%E4%B8%BASingularity%E5%AE%B9%E5%99%A8%E6%A0%BC%E5%BC%8F%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8D%E9%95%9C%E5%83%8F%E7%B1%BB%E5%9E%8B%E4%BB%A5%E9%80%82%E9%85%8D%E4%B8%8D%E5%90%8C%E5%9C%BA%E6%99%AF%E9%9C%80%E6%B1%82%E3%80%82

核心功能

1. 多格式支持：
   • squashfs（默认，推荐生产）：压缩只读、体积小且稳定。
   • sandbox（-f参数）：沙箱文件夹格式，便于开发调试。
   • ext3（-w参数）：遗留可写格式，适配旧版环境（不推荐生产）。
2. 自定义挂载点：通过-m参数指定镜像内需要创建的挂载路径。
3. 镜像检查：支持查看生成镜像的标签、运行脚本及环境变量。
4. 格式转换：生成的镜像可在不同格式间转换（如沙箱转squashfs）。

使用场景

• 生产环境：用squashfs格式构建压缩可靠的Singularity镜像。
• 开发调试：用sandbox格式修改测试镜像内容。
• 遗留系统：用ext3格式适配旧版Singularity环境。

配置说明

构建镜像

bash
# 开发版本
docker build -f Dockerfile.dev -t vanessa/singularity:2docker-dev .
# 稳定版本
docker build -f Dockerfile.dev -t vanessa/singularity:2docker .

基本使用

bash
docker run vanessa/singularity:2docker-dev
USAGE: docker2singularity [-m "/mount_point1 /mount_point2"] [options] docker_image_name
OPTIONS:
          Image Format
              -f: 构建开发沙箱（文件夹）
              -w: 构建非生产可写镜像（ext3）         
              默认：squashfs（推荐）

部署示例

构建squashfs镜像（推荐）

bash
docker run -v /var/run/docker.sock:/var/run/docker.sock \
-v /本地输出路径:/output \
--privileged -t --rm \
vanessa/singularity:2docker \
ubuntu:14.04

说明：替换/本地输出路径为保存镜像的本地路径，ubuntu:14.04为目标Docker镜像。

构建沙箱镜像（开发）

bash
docker run -v /var/run/docker.sock:/var/run/docker.sock \
-v /本地输出路径:/output \
--privileged -t --rm \
vanessa/singularity:2docker \
-f \
ubuntu:14.04

构建ext3镜像（遗留）

bash
docker run -v /var/run/docker.sock:/var/run/docker.sock \
-v /本地输出路径:/output \
--privileged -t --rm \
vanessa/singularity:2docker \
-w \
ubuntu:14.04

镜像检查

查看标签：

bash
singularity inspect 生成的镜像名称.simg

查看运行脚本与环境：

bash
singularity inspect --json -e -r 生成的镜像名称.simg

常见问题

"client is newer than server"错误

根据本地Docker版本选择对应镜像版本（如1.11）：

bash
docker run \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /本地输出路径:/output \
--privileged -t --rm \
vanessa/singularity:1.11 \
ubuntu:14.04

集群自定义挂载点

添加所需挂载路径：

bash
docker run \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /本地输出路径:/output \
--privileged -t --rm \
vanessa/singularity:2docker \
-m "/shared_fs /custom_mount" \
ubuntu:14.04

致谢

本镜像基于https://github.com/vsoch%E5%92%8Chttps://github.com/gmkurtzer%E7%9A%84docker2singularity%E9%A1%B9%E7%9B%AE%E5%BC%80%E5%8F%91%EF%BC%8C%E6%84%9F%E8%B0%A2%E4%BB%96%E4%BB%AC%E7%9A%84%E8%B4%A1%E7%8C%AE%E3%80%82