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キャッシュを保持できます。

OCIFSファイル・システムをアンマウントすると、cache-keepオプションを指定してファイル・システムをマウントしないかぎり、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オプションを使用すると、マルチパート・アップロードを開始するファイル・サイズを指定できます。

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

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