Redmine

在 Bitbucket 中參考 Redmine 議題。

這是一個 Redmine 外掛 和一個相容於 Atlassian Connect for Bitbucket Cloud 的附加元件。

功能¶

• 一個 Bitbucket 連結器，它讓 Bitbucket 將使用指定正規表達式對議題的參考轉換為 Redmine 中議題的連結；
• Bitbucket webhook，用於推送、提交註解、拉取請求和拉取請求註解。這些 webhook 會在 Redmine 外掛中處理，為包含提交訊息或註解以及有用連結和中繼資料的議題建立日誌條目。

由於連結器和 webhook 是使用附加元件註冊的，因此它們會自動為安裝附加元件的使用者/團隊的所有儲存庫工作。

限制¶

• 目前，正規表達式被硬編碼為 `(?<!&)#([0-9]+)`，這表示必須使用 `#<議題編號>` 來參考議題。負向預查是 Bitbucket bug 13642 的解決方法。
• 目前，由於 Bitbucket 的推送 webhook 的限制，每次推送最多支援 5 個提交。
• 拉取請求編輯、拉取請求註解編輯或提交註解編輯中的議題參考不會導致 Redmine 日誌被更新或添加。

首先，在 Redmine 中安裝外掛¶

從您的 Redmine 安裝 目錄

• 下載或複製此儲存庫

    mkdir plugins/bitbucket_reference_redmine
    wget -qO - https://bitbucket.org/productize/bitbucket_reference_redmine/get/master.tar.bz2 | tar jx --strip-components=1 -C plugins/bitbucket_reference_redmine

    git clone https://bitbucket.org/productize/bitbucket_reference_redmine.git plugins/bitbucket_reference_redmine

• 安裝外掛的依賴項

    bundle install

• 執行遷移

    bundle exec rake redmine:plugins:migrate

• 重新啟動 Redmine

  例如，如果 Redmine 作為 Apache 2 passenger 安裝

    sudo service apache2 restart

    sudo service redmine restart

接下來，在您的 Bitbucket 使用者/團隊中安裝附加元件：¶

• 導航至 https://bitbucket.org/account/user/user_or_team_name/addon-management
• 點選「從網址安裝附加元件」
• 輸入 <您的 Redmine 安裝的基底網址>/bitbucket-references
• 點選「安裝」
• 點選「授予存取權」
• 您現在將被重新導向至 Redmine 執行個體中的外掛設定頁面，這可能需要您登入。
• 在您剛才新增的 Bitbucket 連線中點選「允許」。

備註¶

• Bitbucket Connect 系統要求您的 Redmine 安裝使用 HTTPS。
• 要新增第二個 Bitbucket 帳戶，請確保在外掛的設定頁面上啟用了「允許新的 Bitbucket 連線」選項。