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-id-prefix=id-prefix --creds-file=credential-file
--enable_mount_directory --hostname=hostname
--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, afin qu'elle 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 Effectuer un 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 section 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 Google Cloud Console. Lorsqu'un préfixe est utilisé, l'ID de l'agent possède le format suivant : prefix + hostname + Docker container ID.
--creds-file=credential-file

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

--enable_mount_directory

Installe le système de fichiers entier sous le répertoire /transfer_root dans le conteneur Docker, plutôt que de spécifier des montages de volume Docker -v individuels (facultatif). Lorsque vous utilisez cette option, vous n'avez pas besoin d'ajouter le préfixe /transfer_root au répertoire des journaux ou au chemin d'accès au fichier d'identifiant de compte de service, et /transfer_root n'est pas visible dans les journaux de transfert ou dans les exemples d'erreur GUI.

--help

Affiche une brève aide à l'utilisation.

--hostname=hostname

Définit le nom d'hôte sur lequel l'agent s'exécute. Cette option est utilisée pour signaler le nom d'hôte de la machine sur laquelle un agent particulier s'exécute.

--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

Les agents utilisent par défaut 8 Gio de mémoire système au maximum. Si la valeur par défaut ne correspond pas à votre environnement, vous pouvez spécifier une utilisation de mémoire maximale appropriée en utilisant les formats suivants :

Valeur max-physical-mem Paramètre de mémoire maximale
6g 6 gigaoctets
6gb 6 gigaoctets
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.