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_OPTIONScorrespond aux options qui contrôlent la configuration de l'installation et le comportement de Cloud Storage FUSE.BUCKET_NAMEest 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_POINTcorrespond 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 |
|---|---|
--anonymous-access BOOLEAN |
Désactive l'authentification pour les requêtes. Cette option doit être définie si vous utilisez un point de terminaison personnalisé qui n'est pas compatible avec l'authentification. Cette option doit également être définie si vous utilisez Cloud Storage FUSE avec des buckets publics.
La valeur par défaut est false. |
--app-name VALUE |
Nom de l'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.
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 l'authentification n'est pas disponible sur le point de terminaison personnalisé que vous spécifiez, définissez l'option --anonymous-access sur true pour contourner l'authentification.
|
--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 0s indique l'absence de délai d'expiration. |
--ignore-interrupts VALUE |
Indique à Cloud Storage FUSE d'ignorer les signaux d'interruption système, tels que les signaux SIGINT déclenchés par Control+C. Cela empêche les signaux d'arrêter les opérations en cours. Les valeurs sont true ou false. La valeur par défaut est true. |
--implicit-dirs |
Inclut implicitement les dossiers et les dossiers gérés. Pour en savoir plus, consultez la documentation sur les fichiers et les répertoires dans GitHub. |
--kernel-list-cache-ttl-secs VALUE |
Active le cache de liste et définit la valeur TTL (Time To Live) en secondes des entrées de liste mises en cache. Le cache de listes est conservé en mémoire dans le cache de pages, qui est contrôlé par le noyau en fonction de la disponibilité de la mémoire. La valeur par défaut est 0, ce qui indique que la mise en cache de liste est désactivée.
Pour définir l'option --kernel-list-cache-ttl-secs, spécifiez une valeur positive en secondes afin de conserver la réponse de la liste d'annuaires dans le cache de page du noyau. Pour contourner l'expiration de l'entrée et toujours renvoyer la réponse de la liste à partir du cache lorsqu'elle est disponible, saisissez la valeur -1.
|
--key-file VALUE |
Spécifie un chemin d'accès absolu au fichier de clé JSON des identifiants pour authentifier les requêtes à 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 0, ce qui indique qu'il n'y a pas de limite pour les connexions TCP, sauf pour les limites définies par les spécifications de votre machine. |
--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 |
-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.
Au lieu de cette option, utilisez le champ metadata-cache: stat-cache max-size dans un fichier de configuration pour définir la taille maximale du cache de statistiques. Pour en savoir plus, consultez le fichier de configuration Cloud Storage FUSE.
|
--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 60s.
Au lieu de cette option, utilisez le champ metadata-cache: ttl-secs dans un fichier de configuration pour spécifier la valeur TTL (Time To Live) des entrées de métadonnées des caches de statistiques et de types. Pour en savoir plus, consultez le fichier de configuration Cloud Storage FUSE. |
--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.
Utilisez plutôt le champ metadata-cache: ttl-secs pour spécifier la valeur TTL des entrées de métadonnées des caches de statistiques et de types. Pour en savoir plus, consultez le fichier de configuration Cloud Storage FUSE. |
--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. |