OCIFSユーティリティ

OCIFSには、考慮する必要があるマウント制限がいくつかあります。

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でインスタンス・プリンシパル認証方法を使用できます。

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

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

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

$ ocifs --auth=instance_principal bucket-1 mydir

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

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

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

   All {instance.id = 'ocid1.instance.<id>'}

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

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

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

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

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

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

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

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

たとえば、バケットをマウントし、アンマウント時にキャッシュを保持するには:

$ ocifs --cache-keep bucket-1 mydir

ノート:

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

cache-purgeオプションを使用すると、指定した期間閉じられたファイルのデータをキャッシュから削除できます。

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

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

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

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

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

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

$ ocifs --cache-reuse bucket-1 mydir

ノート:

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