Ruby 脚本，通过 API 将 GitHub 问题导入 Redmine。

Github-to-Redmine 导入脚本工具¶

先决条件¶

Ruby 1.9.3 或更高版本，rails 3.2.12 或更高版本，github_api 钩子，以及 pandoc 1.11.1。要安装钩子，请运行

gem install rails -v '3.2.14'
gem install github_api -v '0.11.3'

(Github_api 0.12 不能正确工作，我猜测是因为自动分页有问题).

要安装 Pandoc，您可以按照 源代码 安装的说明进行，或者使用此 ".deb 包":http://archive.ubuntu.com/ubuntu/pool/universe/p/pandoc/pandoc_1.11.1-2build2_amd64.deb

此外，您必须在 Redmine 中启用 Redmine Api，通过在 Redmine 的“管理>设置>身份验证”中勾选“启用 REST Web 服务”。

配置¶

将 `config.yml.example` 复制到 `config.yml`，并填写您的 Redmine 网站地址、Redmine API 密钥、GitHub 令牌和您的组织名称

完成此操作后，您可以通过运行 `config_creator.rb` 来帮助您编写配置。

用户必须是管理员。

您可以使用 `REPOSITORY_FILTER` 数组仅处理某些仓库。

您可以通过设置 `CLOSE_DATE` 为 `due_date` 来在 `due_date` 中存储问题关闭日期，您也可以将其存储在自定义字段中，自定义字段必须对所有项目可用，通过设置 `CLOSE_DATE` 为字段名称或通过设置 `CLOSE_DATE` 为 `none` 来忽略它。

您可以通过设置 `IMPORT_IMAGES` 来选择是否从 GitHub 导入图像。

在运行脚本之前，您可以通过填充 USER_MAPPING 哈希来完成用户映射。

运行脚本¶

您可以使用以下方式运行脚本

ruby import.rb

脚本将引导您完成导入。

已知问题¶

• 在运行脚本之前必须创建用户
• 只有具有问题的标签/里程碑将被导入
• 创建和关闭日期无法设置，这也适用于备注。
• 如果您不想收到大量电子邮件，请在运行脚本之前禁用电子邮件通知
• 如果您在 GitHub 上没有分配者的问题时遇到问题，请从活动工作流程中禁用“要求分配者”