ownCloud 10にS3バケットを外部ストレージとして接続する

Amazon S3 バケット内のファイルを ownCloud 10 内に表示させたい場合は、バケットを外部ストレージマウントとして追加します。外部ストレージマウントとは、ownCloud 内に表示される、別のストレージサービスへの読み書きを行うフォルダのことです。ownCloud 10.3 以降では、専用のfiles_external_s3アプリと外部ストレージサポートをインストールして有効化し、[設定] > [管理] > [ストレージ]から Amazon S3 マウントを追加してください。バケット名、アクセスキー、シークレットキー、および適切なリージョンまたはエンドポイント情報が必要になります。

ownCloudアプリの画面例。外部ストレージのサポートとAmazon S3外部ストレージが有効として表示されている。
このインターフェース図は、S3マウントに必要な2つの有効化されたアプリ行を示しています。外部ストレージのサポートと、独立したAmazon S3バックエンドです。

マウントを構成する前に準備すべきこと

S3はオブジェクトストレージです。サーバーのローカルディスク上のファイルではなく、バケットに名前付きオブジェクトを保存します。ownCloudはバケットを一般的なフォルダとして表示しますが、バケットをPOSIXファイルシステムに変換するわけではありません。以下の手順では、ユーザーファイル用のセカンダリマウントを設定します。これは、別のアプリと設定を使用する、ownCloudのプライマリデータストアとしてS3を設定するのとは異なります。

  • ownCloud のバージョンを確認してください。この手順は ownCloud Classic 10 を対象としており、外部ストレージのワークフローには最新の 10.16 ドキュメントが使用されています。10.3 リリース以降、S3 外部ストレージ バックエンドは ownCloud にバンドルされなくなりました。ownCloud files_external_s3Market から、またはサポートされている手動アプリインストール方法を使用して、サーバーと互換性のあるリリースをインストールし、有効にしてください。S3 オプションが表示されない場合は、サーバー構成を変更する前にこのアプリを確認してください。ownCloud Server リリース ノートを参照してください。
  • バケットへのアクセス情報を取得してください。バケット管理者に、正確なバケット名、アクセスキー、シークレットキー、およびバケットのリージョンを問い合わせてください。認証情報には、オブジェクトの一覧表示、ダウンロード、アップロード、削除など、ユーザーが必要とする操作を許可する権限が必要です。プロバイダがサポートしている場合は、このバケット専用の認証情報を使用してください。チケットや記事にシークレットキーを貼り付けないでください。
  • 互換性のあるサービスのエンドポイントの詳細情報を収集してください。ターゲットがAmazon S3ではなく、プライベートS3互換サービスの場合は、ホスト名、ポート番号、リージョン値、TLS要件、およびパス形式のリクエストが必要かどうかを取得してください。これらの値はプロバイダー固有です。汎用的なAWSエンドポイントをプライベートオブジェクトストレージエンドポイントの代わりに使用しないでください。
  • マウントを表示するユーザーを選択します。管理者が作成したマウントは、デフォルトではすべてのユーザーが利用できます。「利用可能範囲」で、特定のユーザーまたはグループのみに表示を制限できます。
ownCloudの管理画面で、「外部ストレージを有効にする」チェックボックスが選択されている状態の例
管理ストレージの図では、「外部ストレージを有効にする」コントロールが強調表示されています。マウントを追加する前に、このコントロールをオンにする必要があります。

バックエンドをインストールしてバケットを追加します

  1. 外部ストレージのサポートを有効にします。ownCloud管理者としてサインインします。[設定] > [アプリ]を開き、[外部ストレージのサポート] を見つけて、必要に応じて有効にします。次に、サーバーにまだインストールされていない場合は、Amazon S3 外部ストレージアプリをインストールして有効にしますfiles_external_s3。アプリ名とインストール手順はパッケージによって異なる場合があるため、ownCloud のリリースと互換性のあるアプリビルドを使用してください。
  2. ストレージ設定を開きます。[設定] > [管理者] > [ストレージ]に移動し、 [外部ストレージを有効にする] が選択されていることを確認してください。ownCloud のマニュアルでは、一般的な前提条件は [設定] > [アプリ] にあり、有効化の制御は [ストレージ] にあるとされています。
  3. マウント行を作成します。外部ストレージセクションで、ストレージタイプセレクターからAmazon S3を選択します。短いフォルダー名(例TeamArchive:)を入力します。これはownCloudでユーザーに表示されるフォルダー名であり、バケット名ではありません。アクセスキー認証オプションを選択し、バケット名、アクセスキー、シークレットキーをそれぞれのフィールドに入力します。
  4. 接続オプションを設定します。Amazon S3 の場合は、プロンプトが表示されたらバケットの実際のリージョンを入力します。ホスト名とポートは、上書きする必要がない限り、デフォルトのままにしておきます。S3 互換サービスの場合は、管理者から提供されたエンドポイントのホスト名、ポート、リージョンを入力します。HTTPSを使用するには、 [SSL を有効にする]を選択します。ownCloud は SSL を推奨します。通常の Amazon S3 の使用では、[パス スタイルを有効にする]をオフにします。ownCloud は、パス スタイルのリクエストは一般的に不要であり、新しい Amazon データセンターと互換性がないものの、DNS でバケット名をサブドメインとしてルーティングできない Amazon 以外のサービスでは必要になる場合があると述べています。ownCloud 10.16 マニュアルには一般的なマウント ワークフローが記載されています。プロバイダー固有の詳細なオプションは、ownCloud 11.0 Amazon S3 バックエンド リファレンスに記載されているため、フィールド ラベルはアプリ ビルドによって異なる場合があります。AWS 以外の要件については、プロバイダーに確認してください。
  5. アクセスを制限して保存します。[利用可能ユーザー]で、マウントを使用するユーザーまたはグループを選択します。管理者マウントはデフォルトでグローバルに設定されているため、バケットがすべてのユーザー向けでない場合はアクセスを制限してください。ownCloudは、必須フィールドがすべて入力されるとマウントを保存します。表示されるフィールドセットは、選択したバックエンドと認証方法によって異なります。
S3外部ストレージのフォームの例。マウントフォルダ、バケット、マスクされたシークレット、リージョン、エンドポイント、SSL、およびパススタイルのオプションが表示されます。
サンプルフォームは、表示されるフォルダ名がバケット名と異なり、秘密鍵を隠蔽していることを示しています。

ステータスを確認し、接続障害のトラブルシューティングを行う

マウントの横にあるステータスアイコンを確認してください。ownCloudの外部ストレージ設定ガイドによると、緑色のドットはストレージが準備完了であることを示し、赤色または黄色のインジケーターは接続できなかったことを示します。権限を変更したり、マウントを削除して再作成したりする前に、基本的な接続情報を修正してください。

  • Amazon S3 オプションがない場合:外部ストレージサポートと の両方がfiles_external_s3インストールされ、有効になっていることを確認してください。ownCloud 10.3 以降では、後者はバンドルされているサポート アプリとは別になっています。
  • 赤色または黄色のステータスの場合:バケット名、アクセスキーペア、リージョン、エンドポイントホスト名、ポートを再確認してください。ownCloudサーバーがエンドポイントに到達できること、およびTLS証明書が信頼されていることを確認してください。自己署名証明書の場合、ownCloudはマウントを使用する前に証明書をインポートする必要があります。
  • 接続は成功しましたが、ユーザーはそれを使用できません。 「選択可能」を確認し、バケットの認証情報で要求されたオブジェクト操作が許可されていることを確認してください。接続が機能していることを示すインジケーターが表示されていても、マウントから除外されたユーザーには権限が付与されません。
  • バケットに直接追加されたファイルは表示されません。10.16のドキュメントには、occ files:scanS3 または互換性のあるファイルシステムを再スキャンできないと記載されています。ownCloud を介して行われた変更はマウントに反映されますが、外部から追加または変更されたオブジェクトは確実に検出されない場合があります。S3 の修復手順として手動ファイルスキャンを使用することは避けてください。

ownCloudがマウント失敗を「利用不可」と表示した場合、現在の設定ガイドによると、10分間利用不可の状態が続くことがあります。原因を修正した後、色付きのステータスインジケーターをクリックするか、管理ページを再読み込みして再度確認してください。本番環境のマウントを安易に削除して再作成しないでください。外部ストレージの設定を変更または削除すると、ownCloudのデータベースに古いメタデータエントリが残ってしまう可能性があります。

緑色の「利用可能」ステータスとマウントされたフォルダ内のサンプルテキストファイルを含む、管理者ストレージのリスト例
最後のインターフェース図では、「利用可能」ステータスと、マウントされたフォルダ内に表示されるサンプルファイルがペアになっています。

簡単なテストでマウントを確認する

「利用可能」に含まれるアカウントでownCloudのファイルビューを開きます。マウントフォルダが表示されていることを確認し、無害なテストファイルをアップロードして開くかダウンロードし、ownCloud経由でそのテストファイルを削除します。許可されている場合は、同じオブジェクトがバケット内に存在することを確認します。これにより、可視性と書き込みアクセス権限の両方が検証されます。接続ステータスが緑色になっているだけでは、ownCloudが構成済みのストレージに接続できることしか確認できません。

参考として、ownCloudのownCloud 10.16外部ストレージ構成と、 S3プライマリストレージ設定に関する説明を参照してください。後者は、通常のフォルダとしてマウントされたバケットには不要です。

コメントを残す

ownCloud 10にS3バケットを外部ストレージとして接続する

ownCloud 10にS3バケットを外部ストレージとして接続する

ownCloud 10にAmazon S3バケットを追加し、互換性のある認証情報とエンドポイントを準備し、マウントとプライマリストレージを混同することなくアクセスを確認します。

ownCloudデータベースのダンプを安全な夜間Cronジョブで自動化する

ownCloudデータベースのダンプを安全な夜間Cronジョブで自動化する

ownCloud Server の保護された MariaDB ダンプをスケジュールし、メンテナンスモードを安全に処理し、各バックアップに依存する前に検証します。

サポート対象の移行を使用してownCloud ClassicをoCISに移行する

ownCloud 10からoCISへの移行を計画する際は、サポート対象のアプリ、順序付けられたコマンド、本人確認、および個別に処理する必要のあるデータの明確なリストを用意してください。

テーマアプリとCSSを使用したブランドownCloud Classic 10

ownCloud Classic 10のロゴを置き換え、テーマアプリを使用してWeb UIの色を調整し、アップグレードや整合性チェックの落とし穴を回避します。

ownCloud oCISでユーザーロールごとにデフォルトのストレージクォータを設定する

ownCloud oCISでユーザーロールごとにデフォルトのストレージクォータを設定する

役割ごとに、新しいownCloud Infinite Scaleユーザーにバイト単位のストレージ制限を割り当てます。proxy.yamlの例と安全な検証チェックリストも含まれています。

ownCloud同期証明書のTLSソースエラーを修正する

ownCloud同期証明書のTLSソースエラーを修正する

TLS検証を無効にせずに、サーバーのホスト名、証明書チェーン、プライベートCAの信頼、およびキャプティブポータルの問題を確認することで、ownCloudデスクトップの同期を復元します。

アップグレード後にownCloudの整合性警告をクリアする

無効ファイルレポートを使用して、一致しないコアファイルまたはアプリ署名を特定し、正しいリリースファイルを復元し、整合性チェックを安全に検証します。

ownCloud Infinite ScaleをDocker Composeでインストールする

ownCloud Infinite Scaleを公式のComposeサンプルからデプロイし、ドメインと永続ストレージを設定した後、TLS、コンテナ、および初回ログインを確認します。

ownCloud Infinite Scale 用の S3 Blob Storage の設定

ownCloud Infinite Scale 用の S3 Blob Storage の設定

ownCloud Infinite Scaleがファイルコンテンツを確実に保存できるように、S3NGドライバー、バケットのアクセス許可、永続的なメタデータストレージ、およびアップロードサイズを設定します。

ownCloudのアップロードが99%で止まった場合は、これらの制限を確認してください。

ownCloudのアップロードが99%で止まった場合は、これらの制限を確認してください。

ownCloud Serverへのアップロードが完了間近で停止する原因を特定するには、ファイルの状態、クォータ、一時ディスク容量、PHPの制限、プロキシのタイムアウトなどを確認してください。