Ce document explique comment administrer les agents du service de transfert des données sur site sur vos serveurs. Tous les agents sont assignés à un pool d'agents.
Installer et exécuter un agent sur site
Pour installer et exécuter un agent sur site, procédez comme suit :
Console
Dans Cloud Console, accédez à la page Service de transfert des données sur site.
Cliquez sur Paramètres de connexion.
Sélectionnez le pool d'agents auquel ajouter le nouvel agent.
Cliquez sur Installer l'agent.
Suivez les instructions pour installer et exécuter l'agent.
Pour en savoir plus sur les options de ligne de commande de l'agent, consultez la section Options de ligne de commande de l'agent.
gcloud
Pour installer un ou plusieurs agents à l'aide de l'outil gcloud, procédez comme suit :
Suivez les instructions pour configurer l'outil
gcloud.Exécutez
gcloud alpha transfer agents install:gcloud alpha transfer agents install --pool=POOL_NAME --count=1L'outil vous guide tout au long du processus d'installation des agents. Cette commande installe un agent sur votre ordinateur, mappé sur le nom de pool spécifié en tant que
POOL_NAME, et authentifie l'agent à l'aide de vos identifiants gcloud. Si le nom du pool existe, une erreur est renvoyée.
Pour exécuter des agents à l'aide d'une clé de compte de service, utilisez l'option --creds-file :
gcloud alpha transfer agents install --pool=my-agent-pool --count=3 \
--creds-file=/relative/path/to/service-account-key.json
Pour obtenir la liste complète des options facultatives, exécutez gcloud alpha transfer agents install --help.
Nous vous recommandons d'installer plusieurs agents par machine. Pour savoir comment déterminer le nombre d'agents à exécuter, consultez la section Optimiser les performances de l'agent de transfert.
Confirmer les connexions des agents
Après avoir installé vos agents sur site, vous pouvez vérifier qu'ils sont connectés au pool d'agents du service de transfert des données sur site.
Pour vérifier que vos agents sont bien connectés, procédez comme suit :
Dans Cloud Console, accédez à la page Service de transfert des données sur site.
Cliquez sur Paramètres de connexion. Vos pools d'agents s'affichent, avec le nombre d'agents connectés.
Sélectionnez un pool d'agents pour afficher les détails des agents connectés.
Si un nouvel agent n'apparaît pas sur la page du pool d'agents dans les dix minutes suivant sa création, consultez la section Les agents ne sont pas connectés.
Surveiller l'activité des agents
Vous pouvez surveiller l'activité des agents à l'aide des alertes Cloud Monitoring.
Pour ce faire, créez une alerte sur l'une des métriques Google Cloud suivantes :
| Nom de la métrique | Description | Suggestions d'utilisation |
|---|---|---|
| storagetransfer.googleapis.com/agent/transferred_bytes_count | Mesure la vitesse à laquelle un agent spécifique déplace des données (parmi toutes les tâches qu'il traite) à un instant donné. | Alerte en cas de baisses de performances |
| storagetransfer.googleapis.com/agent/connected | Valeur booléenne correspondant à True si un agent a récemment envoyé un message de pulsation à Google. |
|
Arrêter un agent
Pour arrêter un agent, exécutez docker stop sur son ID de conteneur Docker. Pour trouver cet ID, procédez comme suit :
Dans Cloud Console, accédez à la page Service de transfert des données sur site.
Cliquez sur Paramètres de connexion.
Sélectionnez le pool d'agents contenant l'agent à arrêter.
Sélectionnez un agent dans la liste. Utilisez le champ Filtre pour rechercher suivant un préfixe, l'état de l'agent, l'âge de l'agent, etc.
Cliquez sur Arrêter l'agent. La commande
docker stops'affiche avec l'ID de conteneur spécifique.Exécutez la commande sur la machine sur laquelles s'exécute l'agent. Si la commande
docker stopréussit, l'ID du conteneur est renvoyé.
Une fois arrêté, l'agent apparaît dans la liste des agents du pool comme étant déconnecté.