Un pool di agenti. è una raccolta agenti che utilizzano la stessa configurazione, con accesso e visibilità uniformi all'origine e destinazione. I pool di agenti consentono anche di controllare i limiti di larghezza di banda per il 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 correnti.
Per utilizzare i comandi gcloud
,
installa lo strumento a riga di comando gcloud.
Crea un pool di agenti
Per creare un pool di agenti:
Console Google Cloud
Nella console Google Cloud, vai alla pagina Pool di agenti.
Viene visualizzata la pagina Pool di agenti, che elenca i pool di agenti esistenti.
Fai clic su Crea un altro pool.
Assegna un nome al pool e, facoltativamente, descrivilo.
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. Per ulteriori informazioni, consulta Gestire la larghezza di banda di rete.
Fai clic su Crea.
API REST
Utilizza le funzionalità di 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 del 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 eliminare e creare di nuovo il pool di agenti.
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 è 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 un pool e può contribuire a impedire che il carico di lavoro di trasferimento del pool interrompa altre operazioni che condividono la larghezza di banda. Ad esempio, inserisci "50" per impostare un limite di larghezza di banda di 50 MB/s. Se non specifichi questo flag, e gli agenti utilizzeranno tutta la larghezza di banda a loro disposizione.--display-name
è un nome modificabile per aiutarti a identificare questo pool. Puoi includere dettagli che potrebbero non rientrare nel nome completo della risorsa univoca del pool.
Assegna agenti a un pool
I nuovi pool di agenti sono vuoti e devono essere assegnati ad agenti. 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
Da Pool di agenti seleziona il pool a cui assegnare gli agenti.
Fai clic su Installa agente. Viene visualizzata la guida all'installazione dell'agente.
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 usare con un'origine compatibile con S3, fornisci l'accesso
le credenziali come variabili di ambiente
valori di AWS_ACCESS_KEY_ID
e AWS_SECRET_ACCESS_KEY
o archiviati come
credenziali predefinite nei file di configurazione del tuo sistema.
export AWS_ACCESS_KEY_ID=ID
export AWS_SECRET_ACCESS_KEY=SECRET
gcloud transfer agents install --pool=AGENT_POOL
Per ulteriori dettagli, consulta Gestire gli agenti di trasferimento.
Per ulteriori opzioni, vedi 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 la creazione o l'aggiornamento del job.
Aggiornare 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.
Puoi modificare i seguenti elementi:
Il nome visualizzato del pool di agenti: fai clic
Modifica accanto all'elemento corrente Nome del pool di agenti.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. Puoi aggiornare i seguenti campi del pool di agenti:
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 che stai aggiornando del pool di agenti.AGENT_POOL
: il nome del pool di agenti che stai aggiornando.NEW_DISPLAY_NAME
: il nuovo nome visualizzato per questa pool di agenti.
Di seguito è riportato un esempio di richiesta di patch per aggiornare il limite della larghezza di banda:
PATCH https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL:"bandwidthLimit,NEW_LIMIT"
Dove:
PROJECT_ID
: l'ID progetto in cui stai aggiornando il pool di agenti.AGENT_POOL
: l'ID pool di agenti che sei aggiornamento in corso.NEW_LIMIT
: il nuovo limite di larghezza di banda per questo agente piscina.
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]
È richiesto il seguente argomento:
- AGENT_POOL è l'identificatore univoco permanente per questo pool.
AGENT_POOL
identifica il pool di agenti da aggiornare e non può essere aggiornato per trovare le regole.
Con questo comando puoi specificare i seguenti flag:
--bandwidth-limit
può essere aggiornato o rimosso specificando--clear-bandwidth-limit
in alternativa. Consulta Crea un pool di agenti per ulteriori dettagli sui limiti della larghezza di banda.Puoi aggiornare o eliminare
--display-name
con--clear-display-name
.
Elimina un pool di agenti
Puoi eliminare un pool di agenti senza agenti attivi né esecuzioni di job attivi.
Per eliminare un pool di agenti:
Console Google Cloud
Nella console Google Cloud, vai alla pagina Pool di agenti.
Fai clic su
Elimina. Leggi e 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 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 tuo pool in nella console Google Cloud e fai clic sulla scheda Job di trasferimento.
Ottieni un pool di agenti
Per ottenere un pool di agenti:
Console Google Cloud
Nella console Google Cloud, vai alla pagina Pool di agenti.
La pagina mostra un elenco di tutti gli agenti associati al 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.
Le azioni seguenti sono disponibili nella pagina delle informazioni di un pool di agenti:
- Installa agente: mostra le istruzioni per l'installazione degli agenti di trasferimento.
- Interrompi agente: seleziona un agente nella tabella, quindi fai clic su Interrompi agente.
- Elenca i job di trasferimento: fai clic su Trasferisci job per visualizzare il trasferimento. a cui sono connessi gli agenti dei job in 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
È richiesto il seguente argomento:
- AGENT_POOL è l'identificatore univoco permanente per 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.
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ù elementi nomi con virgole; ad esempio--names=foo,bar
. Se non specificato, tutti i valori nel progetto attuale.--page-size
definisce il comportamento di raggruppamento per questo comando. Per impostazione predefinita, il comandolist
raggruppa le risposte in 256 elementi, recuperando automaticamente passa al batch successivo finché non vengono elencati tutti gli elementi o non viene raggiunto il numerolimit
.
Il comando restituisce un elenco di pool di agenti corrispondenti e la relativa configurazione i dettagli. 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