OCIFSユーティリティ

OCIFSには、オブジェクト・ストレージ・バケットをマウントする前に考慮する必要があるいくつかのマウント制限があります。

次のマウント規則および制限を確認してください。

• ファイルのタイプ、属性およびサイズ設定

• ネーミング・ルール

• データの同期

OCIFSでオブジェクト・ストレージ・バケットをマウントするためのAPIキーベースの認証方法を指定および構成します。

APIキーベース認証は、OCIFSのデフォルトの認証方法であり、OCIコンピュート・インスタンスまたは他のシステムから使用できます。この認証方法には、ローカルのOCI SDKおよびCLI構成ファイルが必要です。構成ファイルは、ocifsコマンドでconfig=fileオプションを使用して指定できます。デフォルトでは、構成ファイル~/.oci/configです。

$ ocifs --auth=api_key --config=~/my_config bucket-1 mydir

APIキーベースの認証方法を使用してオブジェクト・ストレージ・バケットをマウントする前に、CLI構成ファイル(~/.oci/config)に[DEFAULT]プロファイルと、次の表で指定されたエントリがあることを確認してください。

詳細は、SDKおよびCLIの構成ファイルを参照してください。

デフォルトのAPIキーベースの認証方法のかわりに、OCIFSユーティリティでインスタンス・プリンシパル認証方法を使用できます。

OCIFSのインスタンス・プリンシパル認証方式は、認可されたOracle Cloud Infrastructureインスタンスからのみ使用します。この認証方法では、指定したインスタンスがCLI構成ファイルなしでオブジェクト・ストレージにアクセスできます。その後、インスタンスは自動的に情報を検出して認証します。

インスタンス・プリンシパル認証を使用して、インスタンス・プリンシパルとして構成されたコンピュート・インスタンスにオブジェクト・ストレージ・バケットをマウントする必要があります。

たとえば、インスタンス・プリンシパル認証を使用して、オブジェクト・ストレージ・バケットbucket-1をmydirディレクトリにマウントするには:

$ ocifs --auth=instance_principal bucket-1 mydir

インスタンス・プリンシパル認証を使用するには、コンピュート・インスタンスが動的グループに属している必要があり、ポリシーによって動的グループがオブジェクト・ストレージを管理できるようにする必要があります。manage object-family動詞およびリソース・タイプを使用して、オブジェクト・ストレージ・オブジェクトの管理を許可するポリシーを定義できます。動的グループの詳細は、動的グループの管理を参照してください。

たとえば、コンピュート・インスタンス(インスタンスIDがocid1.instance.OCID)がインスタンス・プリンシパル認証を使用できるようにするには:

1. コンピュート・インスタンスに一致する次のルールを使用して、動的グループdgroup-ocifsを作成します:

   All {instance.id = 'ocid1.instance.OCID'}

2. その動的グループdgroup-ocifsがオブジェクト・ストレージを管理できるようにするポリシーを作成します:

   Allow dynamic-group dgroup-ocifs to manage object-family in compartment id ocid1.tenancy.tenancy_ID

詳細は、インスタンスからのサービスのコールを参照してください。

デフォルトのAPIキーベースの認証方法のかわりに、OCIFSでリソース・プリンシパル認証方法を使用できます。

認可されたOracle Cloud Infrastructure (OCI)関数からのみ、OCIFSでリソース・プリンシパル認証方法を使用します。この認証方法では、指定した関数がCLI構成ファイルなしで別のリソース(オブジェクト・ストレージ)にアクセスできます。その後、OCI関数は、認証する情報を自動的に検出します。

リソース認証を使用するには、OCI関数が動的グループの一部である必要があり、ポリシーによって動的グループがそのリソースまたはオブジェクト・ストレージにアクセスできるようにする必要があります。動的グループの詳細は、動的グループの管理を参照してください。

他のOCIリソースにアクセスするOCI関数の詳細は、他のOracle Cloud Infrastructureリソースへのアクセスを参照してください。

OCIFSでリソース認証方法を使用するには、ocifsコマンドを使用してバケットをマウントするときに--auth=resource_principalと入力します。

たとえば、リソース・プリンシパル認証を使用して、オブジェクト・ストレージ・バケットbucket-1をmydirディレクトリにマウントするには:

$ ocifs --auth=resource_principal bucket-1 mydir

OCIFSキャッシュ・ディレクトリは、ocifsコマンドのcache=pathオプションを使用して変更できます。

デフォルトでは、OCIFSはオブジェクトを~/.ocifs/にキャッシュします。このキャッシュディレクトリは、cache=pathオプションを使用して変更できます。このオプションは、キャッシュディレクトリを指定されたパスに設定します。パスには、ユーザーのホーム・ディレクトリへの絶対パスまたは相対パスを指定できます。

$ ocifs --cache=/var/tmp/ocifs-cache bucket-1 mydir

OCIFSファイル・システムがアンマウントされている場合でも、ocifsコマンドのcache-keepオプションを使用してOCIFSキャッシュを保持できます。

cache-keepオプションを使用してファイル・システムをマウントしないかぎり、OCIFSファイル・システムをアンマウントすると、OCIFSキャッシュ・ディレクトリが削除されます。

たとえば、オブジェクト・ストレージ・バケットbucket-1をmydirディレクトリにマウントし、アンマウント後にキャッシュを保持するには:

$ ocifs --cache-keep bucket-1 mydir

ノート:

• cache-keepオプションを使用した場合、cache-reuseオプションを使用しないかぎり、ファイルシステムを再度マウントできないことがあります。
• ファイル・システムのアンマウント後にデータをキャッシュに保持すると、次回のファイル・システムのマウント時にパフォーマンスが向上します。ただし、OCIFSでは、キャッシュ内のデータとオブジェクト・ストレージ・バケット内の実際のデータとの間に相違があるかどうかは確認されません。

OCIFSユーティリティのcache-purgeオプションを使用すると、指定した期間クローズされたファイルのデータをOCIFSキャッシュから削除できます。

デフォルトでは、OCIFSキャッシュはパージされません。ファイル・システムがマウントされているかぎり、キャッシュ・データはキャッシュ・ディレクトリに保持されます。キャッシュ・ディレクトリは、OCIFSファイル・システムがアンマウントされている場合にのみ削除されます。

cache-purgeオプションを使用すると、ファイルが閉じられたあとにデータがキャッシュに残る時間を指定できます。これを使用すると、特にファイルが頻繁にアクセスされない場合に、ディスク領域を保持できます。これは、たとえば、新しいファイルを書き、再度ファイルにアクセスしない場合に便利です。

OCIFSキャッシュのパージ遅延は、次の表に示すように指定できます。

OCIFSユーティリティのcache-reuseオプションを使用すると、空でないキャッシュ・ディレクトリが存在する場合でも、OCIFSファイル・システムをマウントできます。

デフォルトでは、OCIFSは、空でないキャッシュ・ディレクトリがあるファイル・システムのマウントを防止します。cache-reuseオプションを使用すると、ファイル・システムを再マウントし、既存のキャッシュ・ディレクトリ(存在する場合)を再利用できます。

たとえば、オブジェクト・ストレージ・バケットbucket-1をmydirディレクトリにマウントし、既存のキャッシュ・ディレクトリを再利用するには:

$ ocifs --cache-reuse bucket-1 mydir

ノート:

• ファイルシステムが以前に cache-keepオプションでマウントされていた場合、または ocifsプロセスが強制終了されたか、またはクラッシュした場合、空でないキャッシュディレクトリを持つことができます。
• OCIFSユーティリティは、キャッシュにすでに存在するデータにすばやくアクセスできるため、既存のキャッシュを再利用するとパフォーマンスが向上します。ただし、OCIFSではキャッシュ内のデータとオブジェクト・ストレージ・バケット内の実際のデータとの間の相違を確認しないため、cache-reuseオプションを使用することはお薦めしません。

OCIFSでは、大規模なファイルをオブジェクト・ストレージにアップロードするためにマルチパート・アップロードを使用するタイミングを決定できます。OCIFS mpu-threshold=sizeオプションを使用すると、マルチパート・アップロードを開始するファイル・サイズを指定できます。

デフォルトのマルチパート・アップロード・サイズしきい値は100Mebibytesです(推奨)。

次の表に、サポートされている mpu-threshold=sizeオプション値を示します。