nrel/openstudio

OpenStudio

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

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

Docker标签

以下是https://hub.docker.com/r/nrel/openstudio/tags/%E4%B8%8A%E5%8F%AF%E8%A7%81%E7%9A%84%E5%90%84%E7%A7%8DDocker%E6%A0%87%E7%AD%BE%E5%8F%8A%E5%85%B6%E5%90%AB%E4%B9%89%E7%9A%84%E8%A1%A8%E6%A0%BC%E3%80%82

构建OpenStudio容器

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

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

  yaml
   - OPENSTUDIO_VERSION: 2.9.1
   - OPENSTUDIO_SHA: 3472e8b799
  

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

• 等待CI完成，验证新的develop镜像在https://hub.docker.com/r/nrel/openstudio/tags/%E4%B8%8A%E5%8F%AF%E7%94%A8

• （如需）本地测试

  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列表可在https://github.com/NREL/OpenStudio/wiki/OpenStudio-Version-Compatibility-Matrix%E6%9F%A5%E7%9C%8B%E3%80%82

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

执行OpenStudio容器

获取执行所需Docker容器有两种方式。两者均假设已安装Docker Toolkit（版本17.03.1或更高）。第一种方式是从GitHub检出代码构建容器，如上所述。此外，通常最好将生成的容器标记为nrel/openstudio:latest。关于latest标签及相关最佳实践的详细讨论，请参考这篇Medium文章。第二种方式是从DockerHub下载发布版，需要确定所需的https://hub.docker.com/r/nrel/openstudio/tags/%EF%BC%8C%E7%84%B6%E5%90%8E%E8%BF%90%E8%A1%8C%60docker pull nrel/openstudio:。例如，要下载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工作流，需要将必要文件挂载到容器，并调用https://nrel.github.io/OpenStudio-user-documentation/reference/command_line_interface/%EF%BC%88%E5%91%BD%E4%BB%A4%E8%A1%8C%E7%95%8C%E9%9D%A2%EF%BC%89%E3%80%82Docker%E5%AE%B9%E5%99%A8%E9%BB%98%E8%AE%A4%E5%9C%A8%60/var/simdata/openstudio%60%E7%9B%AE%E5%BD%95%E4%B8%AD%E6%89%A7%E8%A1%8C%E5%91%BD%E4%BB%A4%EF%BC%88%E5%9C%A8Dockerfile%E4%B8%AD%E5%AE%9A%E4%B9%89%EF%BC%89%E3%80%82%E5%A6%82%E6%9E%9C%E4%B8%BB%E6%9C%BA%E4%B8%8A%E7%9A%84OSW%E4%BD%8D%E4%BA%8E%60/Users/myuser/demo_os_files/example.osw%60%EF%BC%8C%E5%88%99%E6%89%A7%E8%A1%8C%E8%AF%A5OSW%E7%9A%84%E9%80%82%E5%BD%93Docker%E5%91%BD%E4%BB%A4%E4%B8%BA%60docker run -it --rm -v=/Users/myuser/demo_os_files:/var/simdata/openstudio nrel/openstudio /usr/bin/openstudio run -w example.osw`

如果除https://github.com/NREL/OpenStudio/blob/develop/dependencies/ruby/Gemfile%E5%A4%96%EF%BC%8CCLI%E8%BF%98%E9%9C%80%E8%A6%81%E5%85%B6%E4%BB%96gem%E4%BE%9D%E8%B5%96%EF%BC%8C%E8%AF%B7%E8%81%94%E7%B3%BBKyle Benne、Tim Coleman或Nicholas Long的NREL***地址。

发布新容器

• 更新

问题

请在项目的https://github.com/nrel/docker-openstudio%E9%A1%B5%E9%9D%A2%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E3%80%82