CLI gcsfuse

Cette page décrit les commandes de la ligne de commande gcsfuse permettant d'interagir avec Cloud Storage FUSE.

Synopsis

gcsfuse GLOBAL_OPTIONS BUCKET_NAME MOUNT_POINT

Où :

• GLOBAL_OPTIONS correspond aux options qui contrôlent la configuration de l'installation et le comportement de Cloud Storage FUSE.

• BUCKET_NAME est le nom du bucket à installer. Par exemple, my-mount-bucket. Facultatif. Excluez un nom de bucket de cette commande pour effectuer l'installation dynamique.

• MOUNT_POINT correspond au répertoire local dans lequel le bucket sera installé. Par exemple, /path/to/mount/point.

Description

La CLI gcsfuse permet d'installer des buckets Cloud Storage en tant que systèmes de fichiers sur un ordinateur local.

Options globales

Options globales	Description
--app-name VALUE	Nom d'application de l'installation.
--billing-project VALUE	Spécifie un projet à utiliser pour la facturation lors de l'accès au bucket installé. Cette option est souvent requise lors de l'installation d'un bucket activé à l'aide des Paiements par le demandeur. Le projet par défaut est "Aucun".
--client-protocol VALUE	Spécifie le protocole utilisé pour la communication avec le backend Cloud Storage. La valeur peut être http1 pour HTTP/1.1 ou http2 pour HTTP/2. La valeur par défaut est http1.
--config-file VALUE	Spécifie le chemin d'accès au fichier de configuration que vous souhaitez utiliser pour configurer les comportements de Cloud Storage FUSE. Par exemple, --config-file /etc/gcsfuse.yaml.
--custom-endpoint VALUE	Spécifie un autre point de terminaison personnalisé permettant d'extraire des données. Ne doit être utilisé que pour les tests. Le point de terminaison personnalisé doit accepter les ressources et les opérations équivalentes au point de terminaison JSON Cloud Storage, https://storage.googleapis.com/storage/v1. Si aucun point de terminaison personnalisé n'est spécifié, Cloud Storage FUSE utilise le point de terminaison global de l'API JSON Cloud Storage, https://storage.googleapis.com/storage/v1. Si un point de terminaison personnalisé est spécifié, l'authentification est désactivée sur le point de terminaison.
--debug_fuse_errors	Si elle est exclue, renvoie la valeur "False" et empêche les erreurs FUSE d'être consignées dans la console (si --foreground est utilisé) ou le fichier journal (si --log-file est utilisé).
--debug_fuse	Active la sortie de débogage liée à FUSE. Si cette option est spécifiée, le niveau de gravité des journaux est automatiquement défini sur trace, ce qui inclut les journaux trace, les journaux de débogage, les journaux d'informations, les journaux d'avertissement et les journaux d'erreurs.
--debug_gcs	Imprime des informations sur la requête et la chronologie Cloud Storage. Si cette option est spécifiée, le niveau de gravité des journaux est automatiquement défini sur trace, ce qui inclut les journaux trace, les journaux de débogage, les journaux d'informations, les journaux d'avertissement et les journaux d'erreurs.
--debug-invariants	Rencontre une erreur en cas de violation des règles invariantes internes.
--debug_mutex	Affiche des messages de débogage lorsqu'un mutex est conservé trop longtemps. Si cette option est spécifiée, le niveau de gravité des journaux est automatiquement défini sur trace, ce qui inclut les journaux trace, les journaux de débogage, les journaux d'informations, les journaux d'avertissement et les journaux d'erreurs.
--dir-mode VALUE	Bits d'autorisation pour les répertoires, en octal. La valeur par défaut est 755.
--enable-nonexistent-type-cache	Crée une entrée de cache de types NonexistentType si un fichier est introuvable dans Cloud Storage. Si le fichier est créé dans Cloud Storage, mais que l'entrée NonexistentType du fichier est mise en cache, Cloud Storage FUSE ne peut pas demander ce fichier tant que l'entrée NonexistentType n'est pas supprimée du cache du type.
--experimental-enable-json-read	Spécifie Cloud Storage FUSE de sorte qu'il utilise l'API JSON Cloud Storage pour les opérations de lecture. Par défaut, les opérations de lecture sont effectuées à l'aide de l'API XML Cloud Storage.
--experimental-opentelemetry-collector-address VALUE	Exportation des métriques vers le collecteur OpenTelemetry à l'adresse spécifiée. Expérimental.
--file-mode VALUE	Spécifie les bits d'autorisation pour les fichiers, en octal. La valeur par défaut est 644.
--foreground	Il exécute la commande gcsfuse au premier plan.
--gid VALUE	Spécifie le propriétaire de l'identifiant de groupe (GID) de tous les inodes. La valeur par défaut du GID est -1.
--help ou -h	Affiche l'aide concernant Cloud Storage FUSE.
--http-client-timeout VALUE	Spécifie la durée pendant laquelle le client HTTP Cloud Storage FUSE peut attendre d'obtenir une réponse du serveur avant d'expirer. La valeur par défaut est 0s, ce qui indique l'absence de délai avant expiration.
--implicit-dirs	Inclut implicitement des dossiers et des dossiers gérés. Pour en savoir plus, consultez la documentation sur les fichiers et les répertoires dans GitHub.
--key-file VALUE	Spécifie un chemin d'accès absolu au fichier de clé JSON d'identifiant pour authentifier les requêtes auprès de Cloud Storage. Par défaut, Cloud Storage FUSE utilise les identifiants par défaut de l'application pour authentifier les requêtes.
--limit-bytes-per-sec VALUE	Spécifie la limite de bande passante à laquelle Cloud Storage FUSE peut lire des données depuis Cloud Storage, mesurée sur une période de 30 secondes. La valeur par défaut est -1, qui ne spécifie aucune limite.
--limit-ops-per-sec VALUE	Spécifie une limite relative aux opérations effectuées par seconde, mesurée sur une période de 30 secondes. La valeur par défaut est -1, qui ne spécifie aucune limite.
--log-file VALUE	Spécifie le fichier destiné au stockage des journaux, pouvant être analysé par Fluentd. Lorsque cette valeur n'est pas fournie, les journaux en texte brut sont affichés dans stdout lorsque Cloud Storage FUSE est exécuté au premier plan ou dans syslog lorsque Cloud Storage FUSE est exécuté en arrière-plan.
--log-format VALUE	Spécifie le format du fichier journal. La valeur peut être text ou json. La valeur par défaut est json.
--max-conns-per-host VALUE	Indique le nombre maximal de connexions TCP autorisées par serveur. Cela devient effectif lorsque --client-protocol est défini sur http1. La valeur par défaut est 100.
--max-idle-conns-per-host VALUE	Indique le nombre maximal de connexions inactives autorisées par serveur. La valeur par défaut est 100.
--max-retry-sleep VALUE	Spécifie la durée maximale pendant laquelle Cloud Storage FUSE est autorisé à se mettre en veille dans une boucle de nouvelle tentative avec un intervalle exponentiel entre les tentatives. Une fois que l'intervalle entre les tentatives dépasse la durée maximale spécifiée, la nouvelle tentative se poursuit avec la durée maximale spécifiée. La valeur par défaut est 30s (30 secondes).
-o VALUE	Spécifie des options d'installation supplémentaires spécifiques au système. La plupart des options d'installation génériques dans FUSE (telles que rw et suid) sont compatibles avec Cloud Storage FUSE et peuvent être transmises avec l'option -o. Pour en savoir plus, consultez la documentation Linux FUSE.
-o ro	Installe un bucket en lecture seule.
--only-dir VALUE	Installe uniquement un répertoire spécifique dans un bucket.
--rename-dir-limit VALUE	Permet de renommer les répertoires contenant moins de descendants que la limite spécifiée. La valeur par défaut est 0.
--retry-multiplier VALUE	Spécifie le temps d'attente entre deux tentatives consécutives.
--reuse-token-from-url	Si elle est incluse, renvoie la valeur "True" et spécifie que le jeton acquis à partir de --token-url doit être utilisé. Si elle est exclue, renvoie la valeur "False" et spécifie que le jeton acquis auprès de --token-url ne doit pas être réutilisé.
--sequential-read-size-mb VALUE	Spécifie la taille des fragments des données à télécharger depuis Cloud Storage, en mégaoctets (Mo).
--stackdriver-export-interval VALUE	Exporte les métriques vers Stackdriver avec l'intervalle spécifié. La valeur par défaut est 0s, qui ne spécifie aucune exportation.
--stat-cache-capacity VALUE	Obsolète. Spécifie le nombre d'entrées que le cache de statistiques peut contenir. Cela a une incidence sur la consommation de mémoire. La valeur par défaut est 4096.
--stat-cache-ttl VALUE	Obsolète. Spécifie la durée de mise en cache des résultats StatObject et des attributs d'inode. La valeur par défaut est 1m0s.
--type-cache-ttl VALUE	Obsolète. Spécifie la durée de mise en cache du mappage entre les noms et les fichiers ou répertoires dans les inodes de répertoire. La valeur par défaut est 60s.
--temp-dir value VALUE	Spécifie un chemin d'accès au répertoire temporaire où les écritures sont stockées en préproduction avant leur importation dans Cloud Storage. La valeur par défaut est votre paramètre système par défaut, probablement /tmp.
--token-url VALUE	Spécifie une URL permettant d'obtenir un jeton d'accès lorsque le fichier --key-file est absent.
--uid VALUE	Spécifie le propriétaire de l'identifiant utilisateur (UID) de tous les inodes. La valeur par défaut de l'UID est -1.
--version ou -v	Affiche la version de Cloud Storage FUSE que vous avez installée.