Riferimento CTPU
Panoramica
Lo strumento open source ctpu
viene utilizzato per creare un fo di risorse di calcolo,
che consiste in una VM di Compute Engine e uno o più
dispositivi Cloud TPU. Lo strumento è preinstallato in Cloud Shell.
Puoi trovare la documentazione e il codice per ctpu
su GitHub.
Lo strumento ctpu
utilizza la seguente sintassi:
ctpu <subcommand> <flags> <subcommand> <subcommand args>
Di seguito sono riportati i sottocomandi per ctpu
:
auth
- Descrizione
- Imposta o visualizza le autorizzazioni per le Cloud TPU.
- Utilizzo
ctpu auth <flags> <subcommand> <subcommand args>
- Esempio
ctpu auth list --project="my-project" --zone=us-central1-a ctpu auth list --project my-project --zone us-central1-a
- Comandi secondari
Il comando
ctpu auth
supporta i seguenti sottocomandi:- add-bigtable: assicurati che Cloud TPU sia autorizzato per Cloud Bigtable
- add-gcs - assicurati che Cloud TPU sia autorizzato per Cloud Storage
- elenco - Visualizza le autorizzazioni degli account di servizio Cloud TPU
- comandi: elenca tutti i nomi dei comandi
- flag - Descrivi tutti i flag di primo livello noti
- guida - descrivi i sottocomandi e la relativa sintassi
- Flag facoltativi
Di seguito sono riportati i comandi facoltativi per
ctpu auth
.name | project | zone
elimina (rm)
- Descrizione
- Elimina la tua VM di Compute Engine e Cloud TPU.
- Utilizzo
ctpu rm <flags>
- Esempio
ctpu rm --zone=us-central1-b
help
- Descrizione
- Elenca tutti i
ctpu
comandi secondari e i flag di primo livello. - Utilizzo
ctpu help ctpu help <subcommand>
- Esempio
ctpu help // list all ctpu subcommands and top level flags ctpu help auth // list all flags that can be used with `ctpu auth` ctpu help up // list all flags that can be used with `ctpu up`
elenco (ls)
- Descrizione
- Elenca tutte le VM e l'istanza Cloud TPU di Compute Engine nella zona specificata.
- Utilizzo
ctpu ls <flags>
- Esempio
ctpu ls --zone=us-central1-b
metti in pausa (zz)
- Descrizione
Arresta la VM di Compute Engine ed elimina la tua Cloud TPU. Interrompi la ricarica per l'utilizzo di Cloud TPU finché non esegui
ctpu up
.Per assicurarti che Cloud TPU venga arrestato, devi specificare il nome e la zona di Cloud TPU dalla riga di comando.
- Utilizzo
ctpu pause <name, zone>
- Esempio
ctpu pause --name=my-tpu --zone=us-central1-a // pause the named TPU in the specified zone
stampa-config (cfg)
- Descrizione
- Stampa sullo schermo l'attuale configurazione di Cloud TPU, nome del progetto e zona.
- Esempio
ctpu print-config
quota
- Descrizione
- Visualizza un URL in cui puoi vedere le quote.
- Utilizzo
ctpu quota
- Esempio
ctpu quota Output: Quotas cannot currently be displayed within
ctpu
. To view your quota, open <url> Request additional quota from <url>
riavvio
- Descrizione
Riavvia un dispositivo Cloud TPU ancora in stato di esecuzione (mostrato in
ctpu status
), ma l'esecuzione è stata interrotta a causa di un problema hardware. Utilizzagcloud compute tpu start
o il pulsante AVVIA nella pagina Compute Engine > TPU nella console Google Cloud se lo stato del TPU è impostato su STOPPED.restart
non riavvia Cloud TPU prerilasciato. Devi eseguirectpu delete
ectpu up
se la tua Cloud TPU è stata prerilasciata.- Utilizzo
ctpu restart <flags>
- Esempio
ctpu restart --zone=us-central1-a
stato (st)
- Descrizione
Esegui una query sulle API GCP (solo zona predefinita) per determinare lo stato attuale della tua VM Cloud TPU e di Compute Engine.
- Utilizzo
ctpu st
- Esempio
ctpu st --zone=us-central1-a Status message: Your cluster is running! Compute Engine VM: RUNNING Cloud TPU: RUNNING
sedi tpu
- Descrizione
- Elenca tutte le zone in cui sono disponibili i tipi di TPU.
- Utilizzo
- località tpu ctpu
- Output
Cloud TPU Locations: asia-east1-c europe-west4-a us-central1-a us-central1-b us-central1-c
dimensioni tpu
- Descrizione
- Elenca tutte le dimensioni TPU disponibili nella zona specificata. Alcune dimensioni sono disponibili solo in alcune zone. (valore predefinito = zona predefinita)
- Utilizzo
tpu-sizes <zone>
- Esempio
ctpu tpu-sizes --zone=us-central1-a
Freccia su
- Descrizione
Visualizza un set di risorse
ctpu
. La prima volta che eseguictpu up
su un progetto, ci vuole più tempo rispetto alle esecuzioni future perché esegue attività come la propagazione delle chiavi SSH e la visualizzazione delle API.- Abilita i servizi Compute Engine e Cloud TPU.
- Crea una VM di Compute Engine con l'ultima versione stabile di TensorFlow preinstallata.
- Assegna una zona predefinita, ad esempio
us-central1-b
, in base alla tua posizione. - Trasmette il nome della Cloud TPU alla VM di Compute Engine come variabile di ambiente (
TPU_NAME
). - Assicurati che Cloud TPU abbia accesso alle risorse di cui ha bisogno dal tuo progetto Google Cloud, concedendo ruoli IAM specifici al tuo account di servizio Cloud TPU.
- Esegue una serie di altri controlli.
- Accedi alla nuova VM di Compute Engine. Il prompt shell cambia da
username@project
ausername@tpuname
.
Puoi eseguire
ctpu up
tutte le volte che vuoi. Ad esempio, se perdi la connessione SSH alla VM di Compute Engine, eseguictpu up
per ripristinare la connessione. Devi specificare una zona se Compute Engine non è nella zona predefinita. Ad esempio:$ ctpu up --zone=us-central1-a
- Utilizzo
ctpu up <flags>
- Esempio
ctpu up --tpu-size=v2-8 --disk-size-gb=320 --preemptible
- Flag
--disk-size-gb
Configura la dimensione del volume root della VM di Compute Engine. Il valore deve essere un numero intero. (valore predefinito = 250)--dry-run
Non apportare modifiche: stampa solo quello che sarebbe successo.--forward-agent
Abilita l'inoltro SSH dell'agente quando esegui lo ssh nella VM di Compute Engine. L'inoltro SSH dell'agente consente l'accesso ai repository condivisi (come GitHub) senza dover inserire chiavi private sulla VM di Compute Engine. (valore predefinito = true)--forward-ports
Inoltra automaticamente porte utili dalla VM di Compute Engine alla tua macchina locale. Le porte inoltrate sono: 6006 (tensorboard), 8888 (notebook Jupyter), 8470 (porta TPU), 8466 (porta profiler TPU). (valore predefinito = true)--gce-image
Esegui l'override dell'immagine di Compute Engine scelta automaticamente. Utilizza questo flag quando utilizzi immagini personalizzate anziché quelle fornite con TensorFlow installato.--gcp-network
Specifica la rete in cui creare la Cloud TPU e la VM associata. Per informazioni sulle reti, consulta Panoramica della rete Virtual Private Cloud (VPC). (valore predefinito = rete predefinita)--log-http
Stampa l'intero contenuto delle coppie di richiesta/risposta http. Per attivare la stampa, imposta questo flag su true. Utilizza questo flag quando hai bisogno di un output del log per inviare una segnalazione di bug actpu
. Per informazioni dettagliate, consultactpu
README.--machine-type
Configura le dimensioni della tua VM di Compute Engine. Un elenco completo dei tipi di macchine è disponibile nella pagina relativa ai tipi di macchine di Cloud. (predefinito = n1-standard-2)--name
Esegui l'override del nome da utilizzare per le VM e Cloud TPU. (predefinito = il tuo nome utente)--noconf
Salta la conferma.--preemptible
Crea un nodo Cloud TPU prerilasciabile. Un Cloud TPU prerilasciabile ha un costo orario inferiore rispetto a quello di un Cloud non prerilasciabile. Il servizio Cloud TPU può uscire da un dispositivo prerilasciabile in qualsiasi momento. (valore predefinito = non prerilasciabile)--preemptible-vm
Crea una VM di Compute Engine prerilasciabile. Una VM prerilasciabile ha un costo orario inferiore rispetto a una VM non prerilasciabile. Il servizio Compute Engine può uscire dall'istanza VM in qualsiasi momento. (valore predefinito = non prerilasciabile)--print-welcome
Stampa sempre il messaggio di benvenuto.--project
Esegui l'override del nome del progetto GCP da utilizzare durante l'allocazione di VM e TPU. Specifica un valore dalla configurazione del cloud o dai metadati di Compute Engine, in genere il nome del progetto. Se non è possibile trovare un valore valido, devi fornire un valore nella riga di comando.--tf-version
Imposta la versione di TensorFlow da utilizzare durante la creazione della VM di Compute Engine e di Cloud TPU. (predefinita = release stabile più recente)--tpu-only
Assegnare solo una Cloud TPU; utilizza questa opzione solo se hai già una VM disponibile.--tpu-size
Configura le dimensioni e la versione hardware di una Cloud TPU.--use-dl-images
Utilizza immagini di Deep Learning VM (fai riferimento alla documentazione all'indirizzo https://cloud.google.com/deep-learning-vm/) anziché alle immagini delle macchine TPU. (predefinito = immagini macchina TPU)--vm-only
Allocazione solo a una VM; utilizza questa opzione quando non vuoi configurare e pagare un TPU.--zone
Esegui l'override della zona di Compute Engine da utilizzare per l'allocazione di VM e Cloud TPU. Dalla riga di comando, eseguictpu help up
per visualizzare l'elenco.
version
- Descrizione
- Stampa la versione di
ctpu
installata. - Utilizzo
ctpu version
- Output
ctpu version Output: ctpu version: 1.9