添付ファイルのストレージの設定

既定では、Confluence は添付ファイルをホームディレクトリ (ファイルシステムなど) に保存します。 

以前の Confluence バージョンからアップグレードした場合は、データベースまたは WebDAV に添付ファイルがまだ保存されている可能性があります。この保存方法はサポートされなくなりました。

サポートされている保管方法への移行手順については、下記をご参照ください。 

On this page:

関連ページ

添付ファイルの保存方法

ローカルのファイル システム

既定では、Confluence は添付ファイルを、構成済みの Confluence ホーム フォルダの attachments ディレクトリに保存します。

S3 オブジェクト ストレージ

Confluence 8.1 以降は、添付ファイル データを Amazon S3 オブジェクト ストレージに保存することもできます。大きなデータがあるチームやデータの増加が必要なチームで、効率的に拡張する機能が求められている場合は、この方法をお勧めします。詳細は、S3 オブジェクト ストレージの構成をご確認ください。

添付ファイル データを移行する

ファイル システムから S3 オブジェクト ストレージへ

既存の添付ファイル データがあって Amazon S3 を使用する場合は、添付ファイルを Confluence が使用できるように S3 バケットに移行する必要があります。

移行するには、以下の手順を実行します。

  1. Confluence 8.1 以降を使用していることを確認します。
  2. v4 階層の添付ファイル ストレージ構造への移行が完了していることを確認します。その方法をご確認ください。
  3. Confluence 用の新しい Amazon S3 バケットを作成します (S3 オブジェクト ストレージの設定の手順 1 に従います)。
  4. v4 添付ファイル データ (${confluenceHome}/attachments/v4) を物理ソースから S3 バケットのルート プレフィックス confluence/attachments/ に移行します。
    下記はその例です。

    ファイル システム${confluenceHome}/attachments/v4/14/0/327689/327689.1
    S3<S3_Bucket>/confluence/attachments/v4/14/0/327689/327689.1

    このデータの物理的な保存場所は、お使いの環境によって異なります。たとえば、クラスター環境は通常、このデータを共有マウントとしてネットワーク ファイル システム (NFS) にホストします。設定と、移行する必要がある添付ファイルの量を考慮する必要があります。一般的に、移行には Amazon DataSync を使用することをお勧めします。その方法をご確認ください。

  5. 移行が完了するまで待ちます。

  6. AWS 認証の詳細と S3 設定を使用して、Confluence ノードを 1 つずつ設定します (S3 オブジェクト ストレージの設定の手順 2 と 3 に従います)。

    1. すべてのノードが S3 用に設定されるまではデータ作成を避けるために、Confluence を読み取り専用モードにすることを検討します。
    2. 適切な構成を指定したら、各ノードを再起動する必要があります。

    3. このプロセス中に、S3 用にまだ構成されていないノードで添付ファイルが作成された場合、S3 に構成されたノードではその添付ファイル データを使用できなくなります。

  7. 次の手順で、Confluence が S3 オブジェクト ストレージを使用していることを確認します。
    1. [管理] > [一般設定] > [システム情報] に移動します。

    2. [添付ファイル保存場所のタイプ] の横に「S3」と表示されます。

    3. さらに、[Java ランタイム引数] の横には、バケット名とリージョンの両方のシステム プロパティとそれぞれの値が表示されます。

  8. 元の DataSync ジョブを再実行して最終同期を行います。これを実行する前に、すべてのノードを設定して、すべての添付ファイル データを確実に移行する必要があります。

(tick) この段階で、添付ファイル データは AWS S3 から読み書きされます。

DataSync では、ソース ファイル システムのデータが変更または削除されません。そのため、ファイル システムに保存されている添付ファイル データが不要になった場合は、そのデータを手動で削除する必要があります。

トラブルシューティング

ソース ファイル システムのデータは DataSync によって変更または削除されないため、Confluence はファイル システムからの添付ファイル データの読み取りおよび書き込みを元に戻すことができます。そのためには、setenv.sh および/または confluence.cfg.xml から下記の構成を削除して、Confluence を再起動します。

  • confluence.filestore.attachments.s3.bucket.name

  • confluence.filestore.attachments.s3.bucket.region

元のファイル システムに戻す場合は、S3 に書き込まれたすべてのデータを、Confluence 管理者が手動で元のファイル システムに同期させる必要があります。





最終更新日 2024 年 4 月 2 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.