Options de ligne de commande de l'agent de transfert

Les agents de transfert transfèrent les données de votre système de fichiers vers Google Cloud. Vous pouvez contrôler les options d'un agent lorsque vous l'exécutez via les options décrites sur cette page.

Résumé de la commande

sudo docker run [--ulimit memlock=64000000 -d --rm -v host-directory:container-directory]
--env environment-variable=variable-value
gcr.io/cloud-ingest/tsop-agent:latest
{--help | --version | --project-id=project-id}
[--agent-pool=pool-name --agent-id-prefix=id-prefix
--creds-file=credential-file --enable-mount-directory
--hostname=hostname
--kerberos-disable-pa-fx-fast
--log-dir=logs-directory
--max-physical-mem=maximum-memory]

Options de Docker

--ulimit memlock=64000000
Verrouille la mémoire partagée d'un pool partagé pour Docker, de sorte qu'il soit toujours en mémoire pour l'accès par plusieurs sessions.
-d

Démarre le conteneur Docker en mode dissocié ou en arrière-plan. Vous pouvez ainsi continuer d'exécuter des commandes à partir du terminal Linux.

Pour en savoir plus, consultez la section Dissocié -d.

--rm

Supprime le conteneur et son système de fichiers à la fermeture de Docker.

Pour en savoir plus, consultez la section Nettoyage (--rm).

-v host-directory:container-directory

Spécifie un ou plusieurs volumes à mapper de l'hôte au conteneur. Lorsque vous utilisez -v, nous exigeons que les fichiers host-directory et container-directory soient identiques, sinon le service de transfert de stockage ne localisera pas correctement les fichiers à transférer.

Pour en savoir plus, consultez la page VOLUME (systèmes de fichiers partagés).

--env environment-variable=variable-value

Spécifie une variable d'environnement pour le conteneur Docker. Utilisez cette option pour configurer vos agents de sorte qu'ils utilisent un proxy de transfert. Pour en savoir plus, consultez la section Utiliser un proxy de transfert.

Options de l'agent

--agent-id-prefix=id-prefix

Préfixe facultatif ajouté à l'ID de l'agent pour aider à identifier l'agent ou sa machine dans la console Google Cloud . Lorsqu'un préfixe est utilisé, l'ID de l'agent possède le format suivant : prefix + hostname + Docker container ID.

--agent-pool=pool-name

Pool d'agents auquel ajouter cet agent. En cas d'omission, l'agent rejoint le pool transfer_service_default.

--creds-file=credential-file

Fichier d'identifiants de compte de service facultatif au format JSON. Pour plus d'informations sur la génération d'un fichier d'identifiants de compte de service, consultez la page Créer et gérer les clés de comptes de service.

--enable-mount-directory

Indique à l'agent que l'intégralité du système de fichiers de l'hôte est installée sur /transfer_root dans le conteneur. Utilisez-le uniquement avec -v /:/transfer_root, au lieu des installations de volumes Docker -v individuelles. L'agent ajoute /transfer_root au début des chemins d'accès de la source, de la destination, des journaux et des identifiants, et /transfer_root n'est pas visible dans les journaux de transfert ni dans les exemples d'erreurs.

--help

Affiche une brève aide à l'utilisation.

--hostname=hostname

Définissez le nom d'hôte sur lequel l'agent est exécuté. Utilisé pour signaler le nom d'hôte de la machine sur laquelle un agent particulier s'exécute.

--kerberos-disable-pa-fx-fast

Empêche les agents d'utiliser la négociation FAST avec Kerberos pour les transferts HDFS. Utilisez cette option si votre centre de distribution de clés (KDC) Kerberos n'est pas compatible avec la négociation FAST.

--log-dir=logs-directory

Répertoire facultatif dans lequel l'agent écrit les journaux. Le répertoire par défaut est /tmp/.

--max-physical-mem=maximum-memory

Par défaut, les agents utilisent un pool de tampons de 8 Gio. Si la valeur par défaut ne correspond pas à votre environnement, vous pouvez spécifier une utilisation maximale de la mémoire pertinente dans les formats suivants :

Valeur max-physical-mem Paramètre de mémoire maximale
6g 6 gibioctets
6gb 6 gibioctets
6GiB 6 gibioctets
--project-id=project-id

Chaîne obligatoire de l'ID du projet qui héberge les ressources de transfert créées et facturées.

--version

Affiche la version actuelle de l'agent.