Gérer les pools d'agents

Les agents sont des éléments logiciels utilisés par le service de transfert des données sur site pour transférer vos données vers Cloud Storage. Un pool d'agents est un ensemble d'agents qui utilisent la même configuration, avec un accès uniforme et une visibilité sur votre source et votre destination.

Ce guide explique comment utiliser les pools d'agents de service de transfert de données sur site.

Avant de commencer

Vous devez disposer de certaines autorisations sur votre projet pour pouvoir utiliser des pools d'agents. Pour en savoir plus sur les autorisations et les rôles, consultez la page Contrôle des accès avec IAM.

Vous pouvez afficher vos autorisations actuelles.

Créer un pool d'agents

Pour créer un pool d'agents, procédez comme suit :

Cloud Console

  1. Dans Cloud Console, accédez à la page Service de transfert des données sur site.

    Accéder au service de transfert des données sur site

  2. Cliquez sur Paramètres de connexion.

    La page Pools d'agents s'affiche. Elle répertorie vos pools d'agents existants. Tous les projets incluent un pool par défaut nommé transfer_service_default.

  3. Cliquez sur Créer un autre pool.

  4. Nommez votre pool, puis fournissez une description si vous le souhaitez.

  5. Vous pouvez choisir de définir une limite de bande passante qui s'appliquera au pool dans son ensemble. La bande passante spécifiée en Mo/s sera répartie entre tous les agents du pool.

  6. Cliquez sur Create (Créer).

API REST

Utilisez la méthode projects.agentPools.create :

POST https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{agent_pool_id=AGENT_POOL_ID}:create

Où :

  • PROJECT_ID : ID du projet dans lequel vous créez le pool d'agents.
  • AGENT_POOL_ID : ID du pool d'agents que vous créez.

Si un pool d'agents est bloqué à l'état Creating pendant plus de 30 minutes, nous vous recommandons de le supprimer et de le recréer.

La révocation des autorisations de transfert sur site d'un projet alors qu'un pool d'agents est à l'état Creating entraîne un comportement de service incorrect.

Attribuer des agents à un pool

Les nouveaux pools d'agents sont vides et des agents doivent leur être attribués. Un agent ne peut être attribué à un pool d'agents qu'au moment de sa création, à l'aide du champ --agent-pool.

Si --agent-pool n'est pas spécifié, l'agent est attribué au pool transfer_service_default.

Pour créer un agent et l'attribuer à un pool :

  1. Sur la page Pools d'agents, sélectionnez le pool auquel attribuer le ou les agents.

  2. Cliquez sur Installer l'agent. Le guide d'installation de l'agent s'affiche.

  3. Suivez les instructions pour créer l'agent dans ce pool d'agents.

Pour obtenir plus d'options, consultez la section Configuration avancée de l'agent.

Pour gérer les agents, consultez la page Administrer les agents de transfert sur site.

Attribuer un pool d'agents à une tâche

Une fois le pool d'agents créé, il peut être attribué à une tâche au moment de sa création ou de sa mise à jour.

Mettre à jour un pool d'agents

Vous pouvez mettre à jour le nom à afficher et la limite de bande passante d'un pool d'agents.

Pour mettre à jour un pool d'agents, procédez comme suit :

Cloud Console

Dans Cloud Console, accédez à la page Pools d'agents.

Accéder aux pools d'agents

Vous pouvez modifier les éléments suivants :

  • Nom à afficher du pool d'agents : cliquez sur Modifier à côté du nom actuel du pool d'agents.

  • Limite de bande passante du pool d'agents : cliquez sur Définir une limite de bande passante, puis saisissez une nouvelle limite de bande passante dans la boîte de dialogue Définir une limite de bande passante. Cliquez sur Définir une limite pour appliquer la nouvelle limite de bande passante. La bande passante est partagée par tous les agents du pool.

API REST

Pour mettre à jour un pool d'agents, utilisez projects.agentPools.patch avec un masque de champ pour les champs à mettre à jour. Les champs de pool d'agent suivants peuvent être mis à jour :

Par exemple, pour remplacer displayName par my-transfer, vous devez indiquer le masque de champ "displayName,my-transfer".

Voici un exemple de requête "patch" permettant de mettre à jour le nom à afficher :

PATCH https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{AGENT_POOL_ID}:"displayName,NEW_NAME"

Où :

  • PROJECT_ID : ID du projet dans lequel vous mettez à jour le pool d'agents.
  • AGENT_POOL_ID : ID du pool d'agents que vous mettez à jour.
  • NEW_NAME : nouveau nom à afficher pour ce pool d'agents.

Voici un exemple de requête "patch" permettant de mettre à jour la limite de bande passante :

PATCH https://storagetransfer.googleapis.com/v1/projects/{PROJECT_ID}/agentPools/{AGENT_POOL_ID}:"bandwidthLimit,NEW_LIMIT"

Où :

  • PROJECT_ID : ID du projet dans lequel vous mettez à jour le pool d'agents.
  • AGENT_POOL_ID : ID du pool d'agents que vous mettez à jour.
  • NEW_LIMIT : nouvelle limite de bande passante pour ce pool d'agents.

Supprimer un pool d'agents

Vous pouvez supprimer un pool d'agents sans agent ni exécution de tâche active.

Pour supprimer un pool d'agents, procédez comme suit :

Cloud Console

  1. Dans Cloud Console, accédez à la page Pools d'agents.

    Accéder aux pools d'agents

  2. Cliquez sur Supprimer. Lisez le pop-up, puis cliquez sur Supprimer pour confirmer.

    Si le bouton de suppression n'est pas actif, vous devez arrêter tous les agents et tâches associés à ce pool.

API REST

Utilisez la méthode projects.agentPools.delete :

DELETE https://storagetransfer.googleapis.com/v1/{name=PROJECT_ID/*/agentPools/}

Où :

  • PROJECT_ID : ID du projet à partir duquel vous supprimez le pool d'agents.

Obtenir un pool d'agents

Pour obtenir un pool d'agents, procédez comme suit :

Cloud Console

Dans Cloud Console, accédez à la page Pools d'agents.

Accéder aux pools d'agents

La page affiche la liste de tous les pools d'agents associés à votre projet, ainsi que les informations suivantes pour chaque pool d'agents :

  • Nom du pool d'agents
  • État de la connexion
  • Nombre d'agents connectés
  • Limite de bande passante, le cas échéant
  • Nombre de tâches de transfert associées
  • Nom à afficher du pool d'agents

Pour afficher un pool d'agents spécifique, cliquez sur le nom du pool d'agents.

Les actions suivantes sont disponibles à partir de la page d'informations d'un pool d'agents :

  • Agent : affiche les instructions d'installation des agents de transfert sur site.
  • Arrêter l'agent : sélectionnez un agent dans la table, puis cliquez sur Arrêter l'agent.
  • Répertorier des tâches de transfert : cliquez sur Tâches de transfert pour afficher les tâches de transfert auxquelles les agents de ce pool sont connectés.

API REST

Utilisez projects.agentPools.get :

GET https://storagetransfer.googleapis.com/v1/{name=PROJECT_ID/*/agentPools/}

Où :

  • PROJECT_ID : ID du projet à partir duquel vous obtenez un pool d'agents.

Répertorier des pools d'agents

Pour répertorier vos pools d'agents, procédez comme suit :

Cloud Console

Dans Cloud Console, accédez à la page Pools d'agents.

Accéder aux pools d'agents

Tous les pools d'agents sont affichés.

API REST

Utilisez projects.agentPools.list :

GET https://storagetransfer.googleapis.com/v1/projects/{project_id=PROJECT_ID}/agentPools

Où :

  • PROJECT_ID : ID du projet à partir duquel vous obtenez un pool d'agents.