Utility OCIFS

OCIFS prevede diverse limitazioni di installazione da considerare prima di eseguire il MOUNT di un bucket di storage degli oggetti.

Esaminare le regole e le limitazioni di attivazione riportate di seguito.

• Tipi di file, attributi e dimensioni

• Regole di denominazione

• Sincronizzazione dati

Specificare e configurare il metodo di autenticazione basato su chiave API per eseguire il MOUNT dei bucket di storage degli oggetti con OCIFS.

L'autenticazione basata su chiavi API è il metodo di autenticazione predefinito per OCIFS e può essere utilizzata da un'istanza di computazione OCI o da qualsiasi altro sistema. Questo metodo di autenticazione richiede un SDK OCI locale e un file di configurazione dell'interfaccia CLI. È possibile specificare il file di configurazione usando l'opzione config=file con il comando ocifs. Il file di configurazione è ~/.oci/config per impostazione predefinita.

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

Prima di eseguire il MOUNT di un bucket di storage degli oggetti utilizzando il metodo di autenticazione basato su chiavi API, assicurarsi che il file di configurazione CLI (~/.oci/config) disponga di un profilo [DEFAULT] e che le voci specificate nella tabella riportata di seguito.

Per ulteriori informazioni, vedere SDK and CLI Configuration File.

Anziché utilizzare il metodo di autenticazione basato su chiave API predefinito, è possibile utilizzare il metodo di autenticazione del principal dell'istanza con la utility OCIFS.

Utilizzare il metodo di autenticazione del principal dell'istanza per OCIFS solo da un'istanza autorizzata di Oracle Cloud Infrastructure. Questo metodo di autenticazione consente alle istanze specificate di accedere allo storage degli oggetti senza un file di configurazione dell'interfaccia CLI. L'istanza rileva automaticamente le informazioni da autenticare.

L'autenticazione del principal dell'istanza deve essere utilizzata per eseguire il MOUNT di un bucket di storage degli oggetti in un'istanza di computazione configurata come principal dell'istanza.

Ad esempio, per eseguire il MOUNT di un bucket di storage degli oggetti, bucket-1, nella directory mydir utilizzando l'autenticazione del principal dell'istanza:

$ ocifs --auth=instance_principal bucket-1 mydir

Per utilizzare l'autenticazione del principal dell'istanza, un'istanza di computazione deve far parte di un gruppo dinamico e un criterio deve consentire al gruppo dinamico di gestire lo storage degli oggetti. È possibile utilizzare il verbo manage object-family e il tipo di risorsa per definire un criterio che consente la gestione degli oggetti di storage degli oggetti. Per ulteriori informazioni sui gruppi dinamici, vedere Gestione dei gruppi dinamici.

Ad esempio, per consentire a un'istanza di computazione (con ID istanza ocid1.instance.OCID) di utilizzare l'autenticazione del principal dell'istanza:

1. Creare un gruppo dinamico dgroup-ocifs con la regola seguente che corrisponde all'istanza di computazione:

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

2. Creare un criterio che consenta al gruppo dinamico dgroup-ocifs di gestire lo storage degli oggetti:

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

Per ulteriori informazioni, vedere Chiamata di servizi da un'istanza.

Anziché utilizzare il metodo di autenticazione basato su chiave API predefinito, è possibile utilizzare il metodo di autenticazione del principal risorsa con OCIFS.

Utilizzare il metodo di autenticazione del principal risorsa con OCIFS solo da una funzione Oracle Cloud Infrastructure (OCI) autorizzata. Questo metodo di autenticazione consente alla funzione specificata di accedere a un'altra risorsa o storage degli oggetti senza un file di configurazione dell'interfaccia CLI. La funzione OCI rileva quindi automaticamente le informazioni da autenticare.

Per utilizzare l'autenticazione delle risorse, una funzione OCI deve far parte di un gruppo dinamico e un criterio deve consentire al gruppo dinamico di accedere a tale risorsa o allo storage degli oggetti. Per ulteriori informazioni sui gruppi dinamici, vedere Gestione dei gruppi dinamici.

Per informazioni sulle funzioni OCI che accedono ad altre risorse OCI, vedere Accesso ad altre risorse Oracle Cloud Infrastructure.

Per utilizzare il metodo di autenticazione delle risorse con OCIFS, immettere --auth=resource_principal durante il MOUNT di un bucket con il comando ocifs.

Ad esempio, per eseguire il MOUNT di un bucket di storage degli oggetti, bucket-1, nella directory mydir utilizzando l'autenticazione del principal risorsa:

$ ocifs --auth=resource_principal bucket-1 mydir

È possibile modificare la directory di cache OCIFS con l'opzione cache=path del comando ocifs.

Per impostazione predefinita, OCIFS inserisce gli oggetti nella cache in ~/.ocifs/. È possibile modificare questa directory di cache utilizzando l'opzione cache=path. Questa opzione imposta la directory di cache sul percorso specificato. Il percorso può essere un percorso assoluto o relativo alla directory home dell'utente.

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

È possibile conservare la cache OCIFS con l'opzione cache-keep del comando ocifs, anche se il file system OCIFS viene disinstallato.

La disattivazione del file system OCIFS rimuove la directory cache OCIFS, a meno che il file system non venga attivato con l'opzione cache-keep.

Ad esempio, per eseguire il MOUNT di un bucket di storage degli oggetti, bucket-1, nella directory mydir, e conservare la cache dopo la disinstallazione:

$ ocifs --cache-keep bucket-1 mydir

Note:

• Se si utilizza l'opzione cache-keep, potrebbe non essere possibile attivare nuovamente il file system a meno che non si utilizzi l'opzione cache-reuse.
• La conservazione dei dati nella cache dopo la disattivazione del file system può migliorare le prestazioni al successivo MOUNT del file system. Tuttavia, OCIFS non controlla le discrepanze tra i dati nella cache e i dati effettivi nel bucket di storage degli oggetti.

L'opzione cache-purge della utility OCIFS consente di rimuovere i dati dalla cache OCIFS per i file che sono stati chiusi per un periodo di tempo specificato.

Per impostazione predefinita, la cache OCIFS non viene mai rimossa. I dati della cache vengono conservati nella directory della cache mentre il file system viene attivato. La directory di cache viene rimossa solo quando il file system OCIFS viene disinstallato.

Utilizzando l'opzione cache-purge, è possibile specificare il periodo di tempo in cui i dati rimangono nella cache dopo la chiusura di un file. È possibile utilizzare questa opzione per preservare lo spazio su disco, soprattutto se non si accede spesso ai file. Questo è utile, ad esempio, se si scrivono nuovi file e non si accede di nuovo ai file.

Il ritardo di rimozione della cache OCIFS può essere specificato come indicato nella tabella seguente:

L'opzione cache-reuse della utility OCIFS consente di attivare un file system OCIFS anche con una directory di cache non vuota esistente.

Per impostazione predefinita, OCIFS impedisce l'attivazione di un file system se ha una directory di cache non vuota. Con l'opzione cache-reuse, è possibile riattivare il file system e riutilizzare la directory cache esistente, se presente.

Ad esempio, per eseguire il MOUNT del bucket di storage degli oggetti, bucket-1, nella directory mydir e riutilizzare la directory cache esistente:

$ ocifs --cache-reuse bucket-1 mydir

Note:

• È possibile avere una directory di cache non vuota se il file system è stato attivato con l'opzione cache-keep o se il processo ocifs è stato arrestato o non riesce.
• Il riutilizzo di una cache esistente può migliorare le prestazioni, poiché la utility OCIFS può accedere ai dati già presenti nella cache. Tuttavia, l'uso dell'opzione cache-reuse non è consigliato perché OCIFS non controlla le discrepanze tra i dati nella cache e i dati effettivi nel bucket di storage degli oggetti.

OCIFS consente di configurare quando utilizzare il caricamento multiparte per caricare file di grandi dimensioni nello storage degli oggetti. L'opzione mpu-threshold=size OCIFS specifica la dimensione del file sopra la quale viene utilizzato il caricamento multiparte.

Il valore di soglia della dimensione di caricamento multiparte predefinito è 100 Mebibyte (consigliato).

Nella tabella seguente sono elencati i possibili valori delle opzioni mpu-threshold=size.