nrel/openstudio Docker 镜像 - 轩辕镜像

OpenStudio

![构建状态]([***]

本仓库提供OpenStudio的容器及多个依赖，包括Ruby 2.x、Bundler、构建工具（build-essentials）和各种gem支持所需的开发库。目前，项目支持两种目标容器：Docker和Singularity，同时正在开发精简版容器。

Docker标签

以下是此页面上可见的各种Docker标签及其含义的表格。

构建OpenStudio容器

这些镜像在TravisCI中自动构建。触发TravisCI进行新构建的步骤如下：

• 在develop分支上，更新.travis.yml中的OpenStudio新版本和SHA

  yaml
   - OPENSTUDIO_VERSION: 2.9.1
   - OPENSTUDIO_SHA: 3472e8b799
  

• 将更改推送到功能分支，创建并合并拉取请求到develop分支

• 等待CI完成，验证新的develop镜像在Docker Hub上可用

• （如需）本地测试

  bash
  docker pull nrel/openstudio:develop
  docker run -it --rm nrel/openstudio:develop bash
  irb
  require 'openstudio'
  puts OpenStudio.getOpenStudioCLI
  

本地构建

首先按照链接文档安装Docker Toolkit（版本17.03.1或更高）。安装并激活后，运行以下命令构建包含OpenStudio 2.6.1的基础镜像。

docker build --target base -t openstudio-local --build-arg OPENSTUDIO_VERSION=2.9.1 --build-arg OPENSTUDIO_SHA=3472e8b799 .

OpenStudio的版本和SHA列表可在此处查看。

如果未传递--target参数，则Docker构建将仅包含CLI。

执行OpenStudio容器

获取执行所需Docker容器有两种方式。两者均假设已安装Docker Toolkit（版本17.03.1或更高）。第一种方式是从GitHub检出代码构建容器，如上所述。此外，通常最好将生成的容器标记为nrel/openstudio:latest。关于latest标签及相关最佳实践的详细讨论，请参考这篇Medium文章。第二种方式是从DockerHub下载发布版，需要确定所需的docker-openstudio标签发布版，然后运行docker pull nrel/openstudio:<tag>。例如，要下载2.9.1版本的docker-openstudio镜像，命令为docker pull nrel/openstudio:2.9.1。

获取所需容器后（通过构建或拉取），下一步是运行容器。要访问标记为'tag'的容器（上文段落中的'tag'分别为'latest'或'2.9.1'），运行docker run -it --rm nrel/openstudio:tag /bin/bash。

要直接从命令行执行OpenStudio工作流，需要将必要文件挂载到容器，并调用OpenStudio CLI（命令行界面）。Docker容器默认在/var/simdata/openstudio目录中执行命令（在Dockerfile中定义）。如果主机上的OSW位于/Users/myuser/demo_os_files/example.osw，则执行该OSW的适当Docker命令为docker run -it --rm -v=/Users/myuser/demo_os_files:/var/simdata/openstudio nrel/openstudio /usr/bin/openstudio run -w example.osw

如果除OpenStudio打包的gem依赖外，CLI还需要其他gem依赖，请联系Kyle Benne、Tim Coleman或Nicholas Long的NREL***地址。

发布新容器

• 更新

问题

请在项目的Github页面提交问题。