Gestisci pool di agenti

Un pool di agenti è una raccolta di agenti che utilizzano la stessa configurazione, con accesso e visibilità uniformi all'origine e alla destinazione. I pool di agenti forniscono anche il controllo sui limiti di larghezza di banda di trasferimento.

Tutti gli agenti devono appartenere a un pool di agenti.

Questa guida descrive come utilizzare i pool di agenti.

Prima di iniziare

Per utilizzare i pool di agenti, devi disporre delle autorizzazioni corrette per il progetto. Consulta Controllo dell'accesso con IAM per maggiori dettagli.

Puoi visualizzare le autorizzazioni attuali.

Per utilizzare i comandi gcloud, installa lo strumento a riga di comando gcloud.

Crea un pool di agenti

Non includere informazioni sensibili come informazioni che consentono l'identificazione personale (PII) o dati di sicurezza nel nome del pool di agenti o nel prefisso dell'ID agente. I nomi delle risorse possono essere propagati ai nomi di altre risorse Google Cloud e potrebbero essere esposti a sistemi interni di Google al di fuori del tuo progetto.

Per creare un pool di agenti:

Console Google Cloud

  1. Nella console Google Cloud, vai alla pagina Pool di agenti.

    Vai a Pool di agenti

    Viene visualizzata la pagina Pool di agenti, che elenca i pool di agenti esistenti.

  2. Fai clic su Crea un altro pool.

  3. Assegna un nome al pool e, facoltativamente, descrivilo.

  4. Puoi scegliere di impostare un limite di larghezza di banda da applicare al pool come tutto. La larghezza di banda specificata in MB/s verrà suddivisa tra tutte le nel pool. Consulta: Gestione della larghezza di banda della rete per ulteriori informazioni.

  5. Fai clic su Crea.

API REST

Utilizza projects.agentPools.create:

POST https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools?agent_pool_id=AGENT_POOL_ID

Dove:

  • PROJECT_ID: l'ID progetto che stai creando dal pool di agenti.
  • AGENT_POOL_ID: l'ID pool di agenti che sei è in fase di creazione.

Se un pool di agenti è bloccato nello stato Creating per più di 30 minuti, consigliamo di eliminarlo e ricrearlo.

La revoca delle autorizzazioni richieste di Storage Transfer Service da un progetto mentre un pool di agenti è nello stato Creating comporta un comportamento errato del servizio.

Interfaccia a riga di comando gcloud

Per creare un pool di agenti con lo strumento a riga di comando gcloud, esegui gcloud transfer agent-pools create

gcloud transfer agent-pools create AGENT_POOL

Dove sono disponibili le seguenti opzioni:

  • AGENT_POOL è un identificatore univoco e permanente per questo pool.

  • --no-async blocca altre attività nel terminale finché il pool non è stato creato. Se non viene incluso, la creazione del pool viene eseguita in modo asincrono.

  • --bandwidth-limit definisce la quantità di larghezza di banda in MB/s da rendere disponibile agli agenti di questo pool. Un limite di larghezza di banda si applica a tutti gli agenti in un pool e può contribuire a impedire che il carico di lavoro di trasferimento del pool interrompa altre operazioni che condividono la tua larghezza di banda. Ad esempio, inserisci "50" per impostare un limite di larghezza di banda di 50 MB/s. Se lasci questo flag non specificato, gli agenti di questo pool utilizzeranno tutta la larghezza di banda a loro disposizione.

  • --display-name è un nome modificabile che ti aiuta a identificare questo pool. Tu può includere dettagli che potrebbero non essere adatti alla risorsa completa unica del pool nome.

Assegna agenti a un pool

I nuovi pool di agenti sono vuoti e devono avere agenti assegnati. Un agente può essere assegnato a un pool di agenti solo al momento della creazione dell'agente.

Se non viene specificato un pool di agenti, l'agente viene assegnato al Pool transfer_service_default.

Per creare un agente e assegnarlo a un pool:

Console Google Cloud

  1. Nella pagina Pool di agenti, seleziona il pool a cui assegnare gli agenti.

  2. Fai clic su Installa agente. Viene visualizzata la guida all'installazione dell'agente.

  3. Segui le istruzioni per creare l'agente in questo pool di agenti.

Interfaccia a riga di comando gcloud

Per utilizzare lo strumento a riga di comando gcloud per creare un agente e assegnarlo a un esegui gcloud transfer agents install. L'agente deve essere installato su una macchina con accesso root al file system.

gcloud transfer agents install --pool=AGENT_POOL

Per installare gli agenti da utilizzare con un'origine compatibile con S3, fornisci le credenziali di accesso come variabili di ambiente come valori di AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY oppure memorizzate come credenziali predefinite nei file di configurazione del sistema.

export AWS_ACCESS_KEY_ID=ID
export AWS_SECRET_ACCESS_KEY=SECRET
gcloud transfer agents install --pool=AGENT_POOL

Consulta Gestire gli agenti di trasferimento per ulteriori dettagli.

Per altre opzioni, consulta Opzioni avanzate per gli agenti.

Per gestire gli agenti, vedi Gestire gli agenti di trasferimento.

Assegna un pool di agenti a un job

Una volta creato, il pool di agenti può essere assegnato a un job durante creazione di un lavoro oppure aggiorna.

Aggiorna un pool di agenti

Puoi aggiornare il nome visualizzato e il limite di larghezza di banda di un pool di agenti.

Per aggiornare un pool di agenti:

Console Google Cloud

Nella console Google Cloud, vai alla pagina Pool di agenti.

Vai a Pool di agenti

Puoi modificare i seguenti elementi:

  • Il nome visualizzato del pool di agenti: fai clic su Modifica accanto al nome corrente del pool di agenti.

  • Il limite di larghezza di banda del pool di agenti: fai clic su Imposta limite larghezza di banda e inserisci un nuovo limite di larghezza di banda nella finestra di dialogo Imposta limite larghezza di banda. Fai clic su Imposta limite per applicare il nuovo limite di larghezza di banda. La larghezza di banda è condivise tra tutti gli agenti nel pool.

API REST

Per aggiornare un pool di agenti, utilizza projects.agentPools.patch con una maschera del campo dei campi da aggiornare. I seguenti campi del pool di agenti possono essere aggiornati:

Ad esempio, per aggiornare displayName in my-transfer, devi fornire la maschera dei campi "displayName,my-transfer".

Di seguito è riportato un esempio di richiesta di patch per aggiornare il nome visualizzato:

PATCH https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL:"displayName,NEW_DISPLAY_NAME"

Dove:

  • PROJECT_ID: l'ID progetto in cui stai aggiornando il pool di agenti.
  • AGENT_POOL: il nome del pool di agenti da aggiornare.
  • NEW_DISPLAY_NAME: il nuovo nome visualizzato per questo pool di agenti.

Di seguito è riportato un esempio di richiesta di patch per aggiornare il limite di larghezza di banda:

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

Dove:

  • PROJECT_ID: l'ID progetto che stai aggiornando dal pool di agenti.
  • AGENT_POOL: l'ID pool di agenti che stai aggiornando.
  • NEW_LIMIT: il nuovo limite di larghezza di banda per questo pool di agenti.

Interfaccia a riga di comando gcloud

Per utilizzare lo strumento a riga di comando gcloud per aggiornare un pool di agenti, esegui gcloud transfer agent-pools update

gcloud transfer agent-pools update AGENT_POOL \
  [--bandwidth-limit=NEW_BANDWIDTH_LIMIT] [--clear-bandwidth-limit] \
  [--clear-display-name] [--display-name=NEW_DISPLAY_NAME]

L'argomento seguente è obbligatorio:

  • AGENT_POOL è l'identificatore univoco e permanente di questo pool. AGENT_POOL identifica il pool di agenti da aggiornare e non può essere aggiornato per trovare le regole.

Con questo comando è possibile specificare i seguenti flag:

  • --bandwidth-limit può essere aggiornato o rimosso specificando --clear-bandwidth-limit in alternativa. Per ulteriori dettagli sui limiti di larghezza di banda, consulta Creare un pool di agenti.

  • Puoi aggiornare o eliminare --display-name con --clear-display-name .

Elimina un pool di agenti

Puoi eliminare un pool di agenti che non ha agenti attivi e nessuna esecuzione di job attiva.

Per eliminare un pool di agenti:

Console Google Cloud

  1. Nella console Google Cloud, vai alla pagina Pool di agenti.

    Vai a Pool di agenti

  2. Fai clic su Elimina. Leggi il popup, quindi fai clic su Elimina per confermare.

    Se il pulsante Elimina non è attivo, dovrai arrestare tutti gli agenti e i job associate a questo pool.

API REST

Utilizza le funzionalità di projects.agentPools.delete:

DELETE https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL

Dove:

  • PROJECT_ID: l'ID del progetto che stai eliminando dal pool di agenti.
  • AGENT_POOL: il nome del pool di agenti.

Interfaccia a riga di comando gcloud

Per utilizzare lo strumento a riga di comando gcloud per eliminare un pool di agenti, esegui gcloud transfer agent-pools delete.

gcloud transfer agent-pools delete AGENT_POOL

È richiesto il seguente argomento:

  • AGENT_POOL è l'identificatore univoco permanente per questo pool.

Prima di poter eliminare un pool, è necessario arrestare tutti gli agenti nel pool. i job del pool devono essere disabilitati e non devono essere presenti trasferimenti in corso operazioni per questo pool.

Per visualizzare tutti i job associati a un pool, seleziona il pool nella console Google Cloud e fai clic sulla scheda Trasferisci job.

Ottenere un pool di agenti

Per ottenere un pool di agenti:

Console Google Cloud

Nella console Google Cloud, vai alla pagina Pool di agenti.

Vai a Pool di agenti

La pagina mostra un elenco di tutti i pool di agenti associati al tuo progetto e le seguenti informazioni per ogni pool di agenti:

  • Nome pool di agenti
  • Stato della connessione
  • Numero di agenti connessi
  • Limite di larghezza di banda, se impostato
  • Numero di job di trasferimento associati
  • Il nome visualizzato del pool di agenti

Per visualizzare un pool di agenti specifico, fai clic sul relativo nome.

Nella pagina delle informazioni di un pool di agenti sono disponibili le seguenti azioni:

  • Installa agente: mostra le istruzioni per l'installazione degli agenti di trasferimento.
  • Interrompi agente: seleziona un agente nella tabella e poi fai clic su Interrompi agente.
  • Elenca i job di trasferimento: fai clic su Job di trasferimento per visualizzare i job di trasferimento a cui sono collegati gli agenti di questo pool.

API REST

Utilizza projects.agentPools.get:

GET https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL

Dove:

  • PROJECT_ID: l'ID progetto che ricevi un pool di agenti.
  • AGENT_POOL: il pool di agenti da recuperare.

Interfaccia a riga di comando gcloud

Per utilizzare lo strumento a riga di comando gcloud per recuperare un pool di agenti, esegui gcloud transfer agent-pools describe

gcloud transfer agent-pools describe AGENT_POOL

L'argomento seguente è obbligatorio:

  • AGENT_POOL è l'identificatore univoco e permanente di questo pool.

Elenca pool di agenti

Per elencare i pool di agenti:

Console Google Cloud

Nella console Google Cloud, vai alla pagina Pool di agenti.

Vai a Pool di agenti

Vengono visualizzati tutti i pool di agenti.

API REST

Utilizza projects.agentPools.list:

GET https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools

Dove:

  • PROJECT_ID: l'ID progetto per cui elencare i pool di agenti.

Interfaccia a riga di comando gcloud

Per utilizzare lo strumento a riga di comando gcloud per elencare i pool di agenti, esegui gcloud transfer agent-pools list.

gcloud transfer agent-pools list \
  [--limit=LIMIT] \
  [--names=[NAMES,...]] \
  [--page-size=PAGE_SIZE]

Con questo comando puoi specificare i seguenti flag:

  • --limit definisce il numero massimo di pool di agenti da restituire.

  • --names specifica i nomi dei pool di agenti da elencare. Separa più nomi con virgole, ad esempio --names=foo,bar. Se non è specificato, vengono elencati tutti i pool di agenti nel progetto corrente.

  • --page-size definisce il comportamento di raggruppamento per questo comando. Per impostazione predefinita, il comando list raggruppa le risposte in batch di 256 elementi, recuperando automaticamente il batch successivo finché non vengono elencati tutti gli elementi o non viene raggiunto limit.

Il comando restituisce un elenco di pool di agenti corrispondenti e i relativi dettagli di configurazione. L'esempio seguente mostra una risposta di esempio.

name: projects/my-project-123/agentPools/my-first-pool
state: CREATED
---
bandwidthLimit:
  limitMbps: '120'
displayName: Source A to destination Z.
name: projects/my-project-123/agentPools/a2z-pool
state: CREATED