このガイドでは、Discourseインスタンスでソフトウェアアップデートを管理するための、サポートされているトラッキングブランチの設定方法を説明します。
必要なユーザーレベル：システム管理者
コンソールアクセスが必要です。
Discourseインスタンスのトラッキングブランチを管理することで、受信するアップデートの頻度と種類が決まります。このガイドでは、利用可能なさまざまなトラッキングブランチについて説明し、セットアップでブランチを変更するための段階的なアプローチを提供します。
概要
Discourseでは、ソフトウェアアップデートを追跡するために、latest、release、esr のいくつかのブランチとタグが提供されています。このドキュメントでは、それぞれの目的、主な機能、Discourseインスタンスでの設定方法について説明します。リリースモデルの詳細については、RFC: A new versioning strategy for Discourse を参照してください。
サポートされているブランチ
latest
推奨されるデフォルト
このブランチは、プラグインの最新のバグ修正と互換性アップデートを提供します。main ブランチからの合格したコミットはすべてビルドサーバーによってテストされ、検証が成功した後で latest ブランチに追加されます。
- 最新の状態を維持したいサイトに適しています。
- サイトはいつでも手動で更新できます。
release
月次リリースの利用を好むサイト向け
release タグは、Discourseの最新の月次リリースの追跡を行います。毎月、latest からリリースブランチ（例：release/2026.2）が切り出され、安定したスナップショットが提供されます。
- 毎月約1回リリースされます。
- 各リリースは、2つの完全なリリースサイクルにわたって重要な修正を受け取ります。
esr
Extended Support Release（延長サポートリリース）
esr タグは、頻繁なアップデートよりも長期的な安定性とセキュリティを優先するサイトを対象とした、最新の延長サポートリリースを追跡します。
- 月次リリースから約6か月ごとに宣言されます。
- 長期間にわたってセキュリティ修正と重要なバックポートを受け取ります。
- コミュニティプラグインやテーマコンポーネントとの互換性が限定的になる場合があります。
非推奨のエイリアス
後方互換性のために、次の古いブランチ/タグ名も機能しますが、非推奨と見なされます。
tests-passed→latestbeta→releasestable→esr
その他のブランチまたは参照
release/YYYY.MブランチやコミットSHA）を追跡することは可能ですが、専門知識が必要です。これらのブランチは、短期間にわたって重要な修正のみを受け取ります。
トラッキングブランチを設定するための手順
希望のブランチをDiscourseインスタンスで設定するには、次の手順に従います。
- 設定ファイルへのアクセス
コンソールで次のコマンドを実行して、app.yml設定ファイルを開きます。
cd /var/discourse
git pull
nano containers/app.yml
nano エディタで設定ファイルが開きます。
2. トラッキングブランチの編集
ファイル内で「version」という単語を検索して、version パラメータを見つけます。
params:
## Which Git revision should this container use? (default: latest)
#version: latest
versionの行のコメントアウトを解除します。latestを希望のブランチ名またはタグ名（例：esr）に置き換えます。例：
params:
## Which Git revision should this container use? (default: latest)
version: esr
- 保存して終了
- 変更を保存するには
Ctrl+Oを押します。 - 確認のために
Enterを押します。 - エディタを終了するには
Ctrl+Xを使用します。
- コンテナの再構築
変更が加えられ保存されたら、コンテナを再構築して新しい設定を適用します。
git pull
./launcher rebuild app