coolprop/manylinux

CoolProp Docker镜像

镜像概述和主要用途

CoolProp/Dockerfiles仓库提供预配置的Docker镜像，用于构建和使用CoolProp流体属性数据库。这些镜像基于Debian稳定版系统，集成了编译CoolProp所需的基础开发环境，支持多种语言包装器的开发与应用，为流体属性相关的开发工作提供便捷的容器化解决方案。

核心功能和特性

• 基于稳定系统：大多数镜像以Debian稳定版为基础，确保环境稳定性和兼容性
• 完整开发环境：包含GCC编译套件、版本控制系统（如Git）和精简Python安装，满足CoolProp编译需求
• 多架构支持：提供64位（debian、basesystem等）和32位（debian32、basesystem32等）版本镜像
• 多语言支持：已测试支持Octave、C#、Java、JavaScript等语言包装器（Scilab和Julia尚未测试）
• 分层构建：通过基础镜像（debian）→ 基础系统镜像（basesystem）→ 应用镜像（slaveopen等）的分层结构，优化镜像管理

仓库结构

基础镜像

• debian/debian32：基于Debian稳定版，通过chroot环境构建，二进制文件发布于Docker Hub的https://hub.docker.com/r/coolprop/debian/%E5%92%8Chttps://hub.docker.com/r/coolprop/debian32/%E4%BB%93%E5%BA%93

基础系统镜像

• basesystem/basesystem32：基于debian/debian32镜像构建，包含编译CoolProp的基础工具链，在Git仓库有新提交时自动构建，发布于https://hub.docker.com/r/coolprop/basesystem/%E5%92%8Chttps://hub.docker.com/r/coolprop/basesystem32/

应用镜像

• slaveopen/slaveopen32：包含构建开源包装器的所有依赖，需手动构建和上传，不参与自动构建流程

使用场景和适用范围

• CoolProp流体属性数据库的编译与开发
• 多语言包装器（Octave、C#、Java等）的测试与部署
• 需要隔离环境的流体热力学相关应用开发
• 包含MATLAB等专有软件的本地化开发环境构建

使用方法和配置说明

磁盘空间调整

在Windows或OSX的Docker虚拟机中遇到磁盘空间不足时，可执行以下命令调整磁盘大小（以50GB为例）：

bash
docker-machine stop default
cd .docker/machine/machines/default/
VBoxManage clonehd disk.vmdk disk-temp.vdi --format vdi
VBoxManage modifymedium disk disk-temp.vdi --resize 51200  # 调整为50GB
VBoxManage clonehd disk-temp.vdi disk-resized.vmdk --format vmdk
mv disk.vmdk disk.vmdk.old
mv disk-resized.vmdk disk.vmdk
docker-machine start default

操作成功后可删除旧文件：rm disk.vmdk.old disk-temp.vdi。Windows系统需确保VirtualBox路径已添加到环境变量：set PATH=%PATH%;C:\Program Files\Oracle\VirtualBox

专有软件安装

包含MATLAB等专有软件的镜像需本地构建：

1. 从slavefull目录获取构建文件和说明
2. 执行本地构建命令（需拥有相应软件许可）
3. 或在容器启动后通过docker exec -it <容器ID> <安装命令>手动安装

发布周期管理

完整发布流程

1. 清理旧镜像：make delete（或docker stop $(docker ps -aq); docker rm $(docker ps -aq); docker rmi $(docker images -q);）
2. 在buildsteps/base.txt和Makefile中设置版本号（如vX.X.X）
3. 构建发布：make full-release
4. 推送镜像：make full-push
5. 提交代码并打标签后推送到远程仓库
6. 重置版本为latest：在buildsteps/base.txt和Makefile中设置为"latest"
7. 重新构建：make all
8. 提交更改并更新manylinux构建器：wrappers/Python/manylinux/00_prepare_docker.sh

自动构建流程

按依赖顺序推送镜像，等待前序镜像构建完成：

bash
TAG=v1.4.2
make debian push-debian
make all
git commit manylinux/32bit/Dockerfile manylinux/64bit/Dockerfile -m "Updated manylinux for ${TAG}" 
git commit basesystem/32bit/Dockerfile basesystem/64bit/Dockerfile -m "Updated basesystem for ${TAG}" && git push
# 等待basesystem构建完成
git commit slavebase/32bit/Dockerfile slavebase/64bit/Dockerfile -m "Updated slavebase for ${TAG}" && git push
# 等待slavebase构建完成
git commit slavepython/32bit/Dockerfile slavepython/64bit/Dockerfile -m "Updated slavepython for ${TAG}" && git push

DNS问题解决

若遇到域名解析问题（如Could not resolve 'httpredir.debian.org'）：

1. 编辑/etc/default/docker，取消注释DOCKER_OPTS="--dns 8.8.8.8 --dns 8.8.4.4"
2. 如需添加本地DNS服务器，修改配置文件后重启Docker：sudo /etc/init.d/docker restart

额外信息

• 更多开发信息参见CoolProp官网开发者文档
• 仓库中的Dockerfile由makefile自动生成，不建议手动编辑
• 所有镜像可通过Docker Hub获取，部分大型镜像需手动构建