Utilitaire OCIFS

OCIFS impose plusieurs restrictions de montage avant de monter un bucket Object Storage.

Consultez les règles et restrictions de montage suivantes :

• Types de fichier, attributs et dimensionnement

• Règles de dénomination

• Synchronisation de données

Indiquer et configurer la méthode d'authentification basée sur une clé d'API pour monter des buckets Object Storage avec OCIFS.

L'authentification basée sur une clé d'API est la méthode d'authentification par défaut pour OCIFS. Elle peut être utilisée à partir d'une instance de calcul OCI ou de tout autre système. Cette méthode d'authentification nécessite un kit SDK OCI local et un fichier de configuration d'interface de ligne de commande. Vous pouvez spécifier le fichier de configuration à l'aide de l'option config=file avec la commande ocifs. Par défaut, le fichier de configuration est ~/.oci/config.

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

Avant de monter un bucket Object Storage à l'aide de la méthode d'authentification basée sur une clé d'API, assurez-vous que le fichier de configuration de l'interface de ligne de commande (~/.oci/config) a un profil [DEFAULT] et que les entrées sont indiquées dans le tableau suivant.

Pour plus d'informations, reportez-vous à Fichier de configuration du kit SDK et de l'interface de ligne de commande.

Au lieu de la méthode d'authentification basée sur une clé d'API par défaut, vous pouvez utiliser la méthode d'authentification du principal d'instance avec l'utilitaire OCIFS.

Utilisez la méthode d'authentification du principal d'instance pour OCIFS uniquement à partir d'une instance Oracle Cloud Infrastructure autorisée. Cette méthode d'authentification permet aux instances indiquées d'accéder à Object Storage sans fichier de configuration de l'interface de ligne de commande. L'instance détecte alors automatiquement les informations à authentifier.

L'authentification de principal d'instance doit être utilisée pour monter un bucket Object Storage sur une instance de calcul qui a été configurée en tant que principal d'instance.

Par exemple, pour monter un bucket Object Storage, bucket-1, sur le répertoire mydir à l'aide de l'authentification par principal d'instance :

$ ocifs --auth=instance_principal bucket-1 mydir

Pour utiliser l'authentification par principal d'instance, une instance de calcul doit faire partie d'un groupe dynamique et une stratégie doit autoriser le groupe dynamique à gérer Object Storage. Vous pouvez utiliser le verbe manage object-family et le type de ressource pour définir une stratégie qui permet de gérer les objets Object Storage. Pour plus d'informations sur les groupes dynamiques, reportez-vous à Gestion des groupes dynamiques.

Par exemple, pour autoriser une instance de calcul (avec l'ID d'instance ocid1.instance.OCID) à utiliser l'authentification de principal d'instance :

1. Créez un groupe dynamique dgroup-ocifs avec la règle suivante qui correspond à l'instance de calcul :

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

2. Créez une stratégie qui permet à ce groupe dynamique, dgroup-ocifs, de gérer Object Storage :

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

Pour plus d'informations, reportez-vous à Appel de services à partir d'une instance.

Au lieu de la méthode d'authentification basée sur une clé d'API par défaut, vous pouvez utiliser la méthode d'authentification du principal de ressource avec OCIFS.

Utilisez la méthode d'authentification du principal de ressource avec OCIFS uniquement à partir d'une fonction Oracle Cloud Infrastructure (OCI) autorisée. Cette méthode d'authentification permet à la fonction spécifiée d'accéder à une autre ressource, ou Object Storage, sans fichier de configuration de la CLI. La fonction OCI détecte ensuite automatiquement les informations à authentifier.

Pour utiliser l'authentification des ressources, une fonction OCI doit faire partie d'un groupe dynamique et une stratégie doit autoriser le groupe dynamique à accéder à cette ressource, ou à Object Storage. Pour plus d'informations sur les groupes dynamiques, reportez-vous à Gestion des groupes dynamiques.

Pour plus d'informations sur les fonctions OCI accédant à d'autres ressources OCI, reportez-vous à Accès à d'autres ressources Oracle Cloud Infrastructure.

Pour utiliser la méthode d'authentification des ressources avec OCIFS, entrez --auth=resource_principal lors du montage d'un bucket avec la commande ocifs.

Par exemple, pour monter un bucket Object Storage, bucket-1, sur le répertoire mydir à l'aide de l'authentification de principal de ressource :

$ ocifs --auth=resource_principal bucket-1 mydir

Vous pouvez modifier le répertoire de cache OCIFS avec l'option cache=path de la commande ocifs.

Par défaut, OCIFS met en cache les objets dans ~/.ocifs/. Vous pouvez modifier ce répertoire de cache à l'aide de l'option cache=path. Cette option définit le répertoire de cache sur le chemin spécifié. Le chemin peut être un chemin absolu ou relatif vers le répertoire personnel de l'utilisateur.

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

Vous pouvez conserver le cache OCIFS avec l'option cache-keep de la commande ocifs, même si le système de fichiers OCIFS est démonté.

Le démontage du système de fichiers OCIFS enlève le répertoire de cache OCIFS, sauf si vous montez le système de fichiers avec l'option cache-keep.

Par exemple, pour monter un bucket Object Storage, bucket-1, sur le répertoire mydir, et conserver le cache après le démontage :

$ ocifs --cache-keep bucket-1 mydir

Remarques :

• Si vous utilisez l'option cache-keep, il se peut que vous ne puissiez pas monter à nouveau le système de fichiers, sauf si vous utilisez ensuite l'option cache-reuse.
• La conservation des données dans le cache après le démontage du système de fichiers peut améliorer les performances lors du prochain montage du système de fichiers. Cependant, OCIFS ne vérifie pas s'il existe des différences entre les données du cache et les données réelles du bucket Object Storage.

L'option cache-purge de l'utilitaire OCIFS vous permet d'enlever des données du cache OCIFS pour les fichiers qui ont été fermés pendant une durée spécifiée.

Par défaut, le cache OCIFS n'est jamais purgé. Les données du cache sont conservées dans le répertoire du cache tant que le système de fichiers est monté. Le répertoire de cache n'est supprimé que lorsque le système de fichiers OCIFS est démonté.

A l'aide de l'option cache-purge, vous pouvez indiquer la durée pendant laquelle les données restent dans le cache après la fermeture d'un fichier. Vous pouvez l'utiliser pour préserver l'espace disque, en particulier si les fichiers ne sont pas souvent accessibles. Cela est utile, par exemple, si vous écrivez de nouveaux fichiers et que vous n'y accédez plus.

Le délai de purge du cache OCIFS peut être indiqué comme indiqué dans le tableau suivant :

L'option cache-reuse de l'utilitaire OCIFS permet de monter un système de fichiers OCIFS, même s'il existe un répertoire de cache non vide.

Par défaut, OCIFS empêche le montage d'un système de fichiers s'il possède un répertoire de cache non vide. Avec l'option cache-reuse, vous pouvez remonter le système de fichiers et réutiliser le répertoire de cache existant, le cas échéant.

Par exemple, pour monter le bucket Object Storage, bucket-1, sur le répertoire mydir et réutiliser le répertoire de cache existant, procédez comme suit :

$ ocifs --cache-reuse bucket-1 mydir

Remarques :

• Vous pouvez disposer d'un répertoire de cache non vide si le système de fichiers a été monté précédemment avec l'option cache-keep, ou si le processus ocifs a été arrêté ou a planté.
• La réutilisation d'un cache existant peut améliorer les performances, car l'utilitaire OCIFS peut accéder plus rapidement aux données déjà présentes dans le cache. Cependant, l'utilisation de l'option cache-reuse n'est pas recommandée car OCIFS ne vérifie pas les différences entre les données du cache et les données réelles du bucket Object Storage.

OCIFS vous permet de déterminer quand il utilise le téléchargement mulipart pour télécharger des fichiers volumineux vers Object Storage. Avec l'option mpu-threshold=size d'OCIFS, vous pouvez indiquer la taille de fichier au-dessus de laquelle le téléchargement multipart démarre.

La valeur de seuil de taille de téléchargement multipart par défaut est de 100 Mo (recommandé).

Le tableau suivant répertorie les valeurs d'option mpu-threshold=size prises en charge.