Utilitaire OCIFS

OCIFS comporte plusieurs restrictions de montage à prendre en compte avant de monter un seau de stockage d'objets.

Vérifiez les règles et restrictions de montage suivantes :

• Types de fichier, attributs et dimensionnement

• Règles d'attribution de nom

• Synchronisation de données

Spécifiez et configurez la méthode d'authentification basée sur une clé d'API pour monter des seaux de stockage d'objets 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 une trousse SDK OCI locale 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 seau de stockage d'objets à 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) comporte un profil [DEFAULT] et les entrées spécifiées dans le tableau suivant.

Pour plus d'informations, voir Fichier de configuration des trousses 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 spécifiées d'accéder au stockage d'objets sans fichier de configuration d'interface de ligne de commande. L'instance détecte ensuite automatiquement les informations à authentifier.

L'authentification du principal d'instance doit être utilisée pour monter un seau de stockage d'objets sur une instance de calcul configurée en tant que principal d'instance.

Par exemple, pour monter un seau de stockage d'objets, bucket-1, dans le répertoire mydir à l'aide de l'authentification de principal d'instance :

$ ocifs --auth=instance_principal bucket-1 mydir

Pour utiliser l'authentification de principal d'instance, une instance de calcul doit faire partie d'un groupe dynamique et une politique doit autoriser le groupe dynamique à gérer le stockage d'objets. Vous pouvez utiliser le verbe manage object-family et le type de ressource pour définir une politique qui autorise la gestion des objets du service de stockage d'objets. Pour plus d'informations sur les groupes dynamiques, voir Gestion des groupes dynamiques.

Par exemple, pour autoriser une instance de calcul (avec l'ID 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 politique qui autorise ce groupe dynamique, dgroup-ocifs, à gérer le stockage d'objets :

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

Pour plus d'informations, voir 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 au service de stockage d'objets, sans fichier de configuration d'interface de ligne de commande. 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 politique doit permettre au groupe dynamique d'accéder à cette ressource ou au service de stockage d'objets. Pour plus d'informations sur les groupes dynamiques, voir Gestion des groupes dynamiques.

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

Pour utiliser la méthode d'authentification de ressource avec OCIFS, entrez --auth=resource_principal lors du montage d'un seau à l'aide de la commande ocifs.

Par exemple, pour monter un seau de stockage d'objets, bucket-1, dans le répertoire mydir à l'aide de l'authentification du principal de ressource :

$ ocifs --auth=resource_principal bucket-1 mydir

Vous pouvez modifier le répertoire de la mémoire cache OCIFS à l'aide de l'option cache=path de la commande ocifs.

Par défaut, OCIFS met les objets en mémoire cache dans ~/.ocifs/. Vous pouvez modifier ce répertoire de mémoire cache à l'aide de l'option cache=path. Cette option règle le répertoire du cache au chemin indiqué. Le chemin peut être un chemin absolu ou un chemin relatif vers le répertoire de base de l'utilisateur.

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

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

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

Par exemple, pour monter un seau de stockage d'objets, bucket-1, dans le répertoire mydir, et conserver la mémoire cache après le démontage :

$ ocifs --cache-keep bucket-1 mydir

Notes :

• Si vous utilisez l'option cache-keep, vous ne pourrez peut-être pas monter de nouveau le système de fichiers à moins d'utiliser l'option cache-reuse.
• La conservation des données dans la mémoire 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. Toutefois, OCIFS ne vérifie pas les écarts entre les données dans la mémoire cache et les données réelles dans le seau de stockage d'objets.

L'option cache-purge de l'utilitaire OCIFS vous permet de supprimer des données de la mémoire cache OCIFS pour les fichiers qui ont été fermés pendant une période spécifiée.

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

À l'aide de l'option cache-purge, vous pouvez spécifier la durée pendant laquelle les données restent dans la mémoire 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 d'épuration de la mémoire 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 avec un répertoire de cache existant et non vide.

Par défaut, OCIFS empêche le montage d'un système de fichiers s'il comporte 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 mémoire cache existant, s'il y a lieu.

Par exemple, pour monter le seau de stockage d'objets, bucket-1, dans le répertoire mydir et réutiliser le répertoire de mémoire cache existant :

$ ocifs --cache-reuse bucket-1 mydir

Notes :

• Vous pouvez avoir un répertoire de mémoire cache non vide si le système de fichiers a été monté avec l'option cache-keep ou si le processus ocifs a été arrêté ou échoue.
• La réutilisation d'un cache existant peut améliorer les performances, car l'utilitaire OCIFS peut accéder aux données déjà présentes dans le cache. Toutefois, l'utilisation de l'option cache-reuse n'est pas recommandée, car OCIFS ne vérifie pas les écarts entre les données dans la mémoire cache et les données réelles dans le seau de stockage d'objets.

OCIFS vous permet de configurer à quel moment utiliser le chargement en plusieurs parties pour charger des fichiers volumineux dans le stockage d'objets. L'option OCIFS mpu-threshold=size spécifie la taille de fichier au-dessus de laquelle le chargement en plusieurs parties est utilisé.

La valeur par défaut du seuil pour le chargement en plusieurs parties est de 100 Mo (recommandé).

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