OCIFS-Utility

OCIFS muss vor dem Mounten eines Object Storage-Buckets mehrere Mounteinschränkungen beachten.

Prüfen Sie die folgenden Mounting-Regeln und Einschränkungen:

• Dateitypen, Attribute und Größe

• Benennungsregeln

• Datensynchronisierung

Geben Sie die API-schlüsselbasierte Authentifizierungsmethode an, und konfigurieren Sie sie, um Object Storage-Buckets mit OCIFS zu mounten.

Die API-schlüsselbasierte Authentifizierung ist die Standardauthentifizierungsmethode für OCIFS und kann von einer OCI-Compute-Instanz oder von einem anderen System verwendet werden. Diese Authentifizierungsmethode erfordert ein lokales OCI-SDK und eine CLI-Konfigurationsdatei. Sie können die Konfigurationsdatei mit der Option config=file und dem Befehl ocifs angeben. Standardmäßig ist die Konfigurationsdatei ~/.oci/config.

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

Bevor Sie einen Object Storage-Bucket mit der API-schlüsselbasierten Authentifizierungsmethode mounten, stellen Sie sicher, dass die CLI-Konfigurationsdatei (~/.oci/config) ein [DEFAULT]-Profil und die in der folgenden Tabelle angegebenen Einträge enthält.

Weitere Informationen finden Sie unter SDK- und CLI-Konfigurationsdatei.

Anstelle der standardmäßigen API-schlüsselbasierten Authentifizierungsmethode können Sie die Instanz-Principal-Authentifizierungsmethode mit dem OCIFS-Utility verwenden.

Verwenden Sie die Instanz-Principal-Authentifizierungsmethode für OCIFS nur von einer autorisierten Oracle Cloud Infrastructure-Instanz. Mit dieser Authentifizierungsmethode können bestimmte Instanzen ohne eine CLI-Konfigurationsdatei auf Object Storage zugreifen. Die Instanz ermittelt dann automatisch Informationen zur Authentifizierung.

Die Instanz-Principal-Authentifizierung muss verwendet werden, um einen Objektspeicher-Bucket auf einer Compute-Instanz zu mounten, die als Instanz-Principal konfiguriert wurde.

Beispiel: So mounten Sie einen Objektspeicher-Bucket bucket-1 im Verzeichnis mydir mit der Instanz-Principal-Authentifizierung:

$ ocifs --auth=instance_principal bucket-1 mydir

Um die Instanz-Principal-Authentifizierung verwenden zu können, muss eine Compute-Instanz Teil einer dynamischen Gruppe sein, und eine Policy muss die Verwaltung von Object Storage durch die dynamische Gruppe zulassen. Mit dem Verb manage object-family und dem Ressourcentyp können Sie eine Policy definieren, mit der Object Storage-Objekte verwaltet werden können. Weitere Informationen zu dynamischen Gruppen finden Sie unter Dynamische Gruppen verwalten.

Beispiel: Damit eine Compute-Instanz (mit Instanz-ID ocid1.instance.OCID) die Instanz-Principal-Authentifizierung verwenden kann:

1. Erstellen Sie eine dynamische Gruppe dgroup-ocifs mit der folgenden Regel, die mit der Compute-Instanz übereinstimmt:

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

2. Erstellen Sie eine Policy, mit der diese dynamische Gruppe, dgroup-ocifs, Object Storage verwalten kann:

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

Weitere Informationen finden Sie unter Services aus einer Instanz aufrufen.

Anstelle der standardmäßigen API-schlüsselbasierten Authentifizierungsmethode können Sie die Resource-Principal-Authentifizierungsmethode mit OCIFS verwenden.

Verwenden Sie die Authentifizierungsmethode des Resource Principals mit OCIFS nur aus einer autorisierten Oracle Cloud Infrastructure-(OCI-)Funktion. Mit dieser Authentifizierungsmethode kann die angegebene Funktion ohne eine CLI-Konfigurationsdatei auf eine andere Ressource oder auf Object Storage zugreifen. Die OCI-Funktion ermittelt dann automatisch Informationen zur Authentifizierung.

Um die Ressourcenauthentifizierung verwenden zu können, muss eine OCI-Funktion Teil einer dynamischen Gruppe sein, und eine Policy muss der dynamischen Gruppe den Zugriff auf diese Ressource oder Object Storage ermöglichen. Weitere Informationen zu dynamischen Gruppen finden Sie unter Dynamische Gruppen verwalten.

Informationen zu OCI-Funktionen, die auf andere OCI-Ressourcen zugreifen, finden Sie unter Auf andere Oracle Cloud Infrastructure-Ressourcen zugreifen.

Um die Ressourcenauthentifizierungsmethode mit OCIFS zu verwenden, geben Sie --auth=resource_principal ein, wenn Sie einen Bucket mit dem Befehl ocifs mounten.

Beispiel: So mounten Sie einen Object Storage-Bucket bucket-1 mit der Resource-Principal-Authentifizierung im Verzeichnis mydir:

$ ocifs --auth=resource_principal bucket-1 mydir

Sie können das OCIFS-Cacheverzeichnis mit der Option cache=path des Befehls ocifs ändern.

Standardmäßig cacht OCIFS Objekte in ~/.ocifs/. Sie können dieses Cache-Verzeichnis mit der Option cache=path ändern. Mit dieser Option wird das Cache-Verzeichnis auf den angegebenen Pfad gesetzt. Der Pfad kann ein absoluter oder relativer Pfad zum Home-Verzeichnis des Benutzers sein.

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

Sie können den OCIFS-Cache mit der Option cache-keep des Befehls ocifs beibehalten, auch wenn das OCIFS-Dateisystem ausgehängt ist.

Wenn Sie das OCIFS-Dateisystem unmounten, wird das OCIFS-Cache-Verzeichnis entfernt, es sei denn, Sie mounten das Dateisystem mit der Option cache-keep.

Beispiel: So mounten Sie einen Object Storage-Bucket bucket-1 im Verzeichnis mydir, und lassen Sie den Cache nach dem Aushängen beibehalten:

$ ocifs --cache-keep bucket-1 mydir

Hinweise:

• Wenn Sie die Option cache-keep verwenden, können Sie das Dateisystem möglicherweise nicht erneut mounten, es sei denn, Sie verwenden die Option cache-reuse.
• Wenn Sie Daten nach dem Aushängen des Dateisystems im Cache speichern, kann dies die Leistung beim nächsten Mounten des Dateisystems verbessern. OCIFS prüft jedoch nicht, ob Abweichungen zwischen Daten im Cache und den tatsächlichen Daten im Object Storage-Bucket vorhanden sind.

Mit der Option cache-purge des OCIFS-Utilitys können Sie Daten aus dem OCIFS-Cache für Dateien entfernen, die für einen bestimmten Zeitraum geschlossen wurden.

Standardmäßig wird der OCIFS-Cache nie gelöscht. Die Cache-Daten werden im Cache-Verzeichnis gespeichert, solange das Dateisystem gemountet ist. Das Cache-Verzeichnis wird nur entfernt, wenn das OCIFS-Dateisystem ausgehängt ist.

Mit der Option cache-purge können Sie angeben, wie lange Daten im Cache verbleiben, nachdem eine Datei geschlossen wurde. Sie können damit Festplattenspeicher beibehalten, insbesondere wenn nicht häufig auf Dateien zugegriffen wird. Dies ist beispielsweise nützlich, wenn Sie neue Dateien schreiben und nicht erneut auf die Dateien zugreifen.

Die OCIFS-Cachelöschverzögerung kann wie in der folgenden Tabelle aufgeführt angegeben werden:

Mit der Option cache-reuse des OCIFS-Utilitys kann ein OCIFS-Dateisystem gemountet werden, selbst wenn ein vorhandenes, nicht leeres Cacheverzeichnis vorhanden ist.

Standardmäßig verhindert OCIFS das Mounten eines Dateisystems, wenn es über ein nicht leeres Cache-Verzeichnis verfügt. Mit der Option cache-reuse können Sie das Dateisystem erneut mounten und das vorhandene Cache-Verzeichnis wiederverwenden, sofern vorhanden.

Beispiel: So mounten Sie den Object Storage-Bucket bucket-1 im Verzeichnis mydir, und verwenden Sie das vorhandene Cache-Verzeichnis wieder:

$ ocifs --cache-reuse bucket-1 mydir

Hinweise:

• Sie können ein nicht leeres Cache-Verzeichnis verwenden, wenn das Dateisystem zuvor mit der Option cache-keep gemountet wurde oder wenn der Prozess ocifs abgebrochen wurde oder abgestürzt ist.
• Die Wiederverwendung eines vorhandenen Caches kann die Performance verbessern, da das OCIFS-Utility schneller auf Daten zugreifen kann, die sich bereits im Cache befinden. Die Verwendung der Option cache-reuse wird jedoch nicht empfohlen, da OCIFS nicht auf Diskrepanzen zwischen Daten im Cache und den tatsächlichen Daten im Objektspeicher-Bucket prüft.

Mit OCIFS können Sie bestimmen, wann Multipart-Uploads große Dateien in Object Storage hochladen. Mit der OCIFS-Option mpu-threshold=size können Sie die Dateigröße angeben, über der Multipart-Uploads gestartet werden.

Der Standardwert für die Multipart-Uploadgröße ist 100 Mebibyte (empfohlen).

In der folgenden Tabelle werden die unterstützten Werte der Option mpu-threshold=size aufgeführt.