[緊急のお知らせ] GitLab 17.1 へのアップデート失敗

GitLab 17.1 (2024年6月20日リリース) には、バックグラウンドマイグレーションの不具合があり、下記イシューで報告されているようなエラーでアップデートが失敗します。

Problem with upgrading to 17.1 due to epics.issue_id constraint (#468875)

17.1 へのアップデートはしばらくお待ちください

不具合を修正した版がリリースされるまで、17.1 へのアップデートはお待ちください。

修正版は既にマージされており、17.1.2 として 7月10日(水) にリリースされる見込みです。(日本時間では同日深夜になると思われます。)

既にアップデートを実施した場合

もし既にアップデートを実施し上述のエラーが発生している場合は、上記イシューに記載の下記暫定策を実行の上、GitLab を再起動してください。
(2024-07-04追記: gitlab-rake 実行後、gitlab-ctl reconfigure の実行も必要なことが判明しましたので追記しました。出典: Sidekiq keeps restarting after upgrade to 17.0.0 (#8545))

sudo gitlab-rake gitlab:background_migrations:finalize[BackfillEpicBasicFieldsToWorkItemRecord,epics,id,'[null]']
sudo gitlab-ctl reconfigure

アップデートに関するお勧め

最新版にはこういった不具合が残っている場合もありますので、より安定度が高い1つ前のマイナーバージョン (現時点では 17.0) の最新パッチリリース (現時点では 17.0.3) へのアップデートをお勧めします。

---

本件についてご支援が必要な場合は、GitLab お問い合わせフォームより、または、弊社プロフェッショナルサービスをご購入いただいているお客さまはサポートポータルより、お問い合わせください。