Riferimento CTPU
Panoramica
Lo strumento ctpu
open source viene utilizzato per creare un gruppo 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
documentazione e codice per ctpu
su GitHub.
Lo strumento ctpu
utilizza la seguente sintassi:
ctpu <subcommand> <flags> <subcommand> <subcommand args>
Di seguito sono riportati i comandi secondari per ctpu
:
auth
- Descrizione
- Imposta o mostra 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
- Sottocomandi
Il comando
ctpu auth
supporta i seguenti sottocomandi:- add-bigtable: assicurati che Cloud TPU sia autorizzato per Cloud Bigtable
- add-gcs: verifica che Cloud TPU sia autorizzato per Cloud Storage
- Elenco delle autorizzazioni di visualizzazione 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 comandi facoltativi per
ctpu auth
.name | project | zone
elimina (RM)
- Descrizione
- Elimina VM e Cloud TPU di Compute Engine.
- 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 di Compute Engine e Cloud TPU nella zona specificata.
- Utilizzo
ctpu ls <flags>
- Esempio
ctpu ls --zone=us-central1-b
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 la Cloud TPU sia arrestata, devi specificare il nome e la zona della 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
Print-config (cfg)
- Descrizione
- Stampa sullo schermo la configurazione attuale di nome, nome del progetto e zona Cloud TPU.
- Esempio
ctpu print-config
quota
- Descrizione
- Visualizza un URL dove 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 una Cloud TPU ancora in stato di ESECUZIONE (mostrato in
ctpu status
), ma la sua esecuzione è stata interrotta a causa di un problema hardware. Utilizzagcloud compute tpu start
o il pulsante START nella pagina Compute Engine > TPU in Cloud Console se la TPU è in stato STOPPED.restart
non riavvia una Cloud TPU prerilasciata. 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 Cloud TPU e della VM 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
località tpu
- Descrizione
- Elenca tutte le zone in cui sono disponibili i tipi di TPU.
- Utilizzo
- tpu tpu-locations
- 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 determinate zone. (valore predefinito = zona predefinita)
- Utilizzo
tpu-sizes <zone>
- Esempio
ctpu tpu-sizes --zone=us-central1-a
Freccia su
- Descrizione
Mostra un set di risorse
ctpu
. La prima volta che eseguictpu up
su un progetto, ci vuole più tempo di quanto non sia nelle esecuzioni future perché esegue attività come la propagazione della chiave 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
). - Garantisce che la Cloud TPU abbia accesso alle risorse necessarie dal 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 si trova 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 le dimensioni del volume principale della VM di Compute Engine. Il valore deve essere un numero intero. (valore predefinito = 250)--dry-run
Non apportare modifiche; stampa solo cosa sarebbe successo.--forward-agent
Abilita l'inoltro dell'agente SSH durante l'applicazione di ssh alla VM di Compute Engine. Il forwarding dell'agente SSH consente l'accesso a repository condivisi (ad esempio GitHub) senza dover inserire chiavi private nella VM di Compute Engine. (predefinito = vero)--forward-ports
Inoltra automaticamente le porte utili dalla VM di Compute Engine alla tua macchina locale. Le porte inoltrati sono: 6006 (tensorboard), 8888 (quaderni di jupyter), 8470 (porta TPU), 8466 (porta del profilo TPU). (predefinito = vero)--gce-image
Esegui l'override dell'immagine di Compute Engine scelta automaticamente. Utilizza questo flag quando utilizzi immagini personalizzate invece di quelle fornite con TensorFlow installato.--gcp-network
Specifica la rete in cui deve essere creata la Cloud TPU e la VM associata. Per informazioni sulle reti, consulta la 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 il flag su true. Utilizza questo flag quando hai bisogno dell'output del log per presentare una segnalazione di bug a fronte dictpu
. Per maggiori dettagli, consulta la paginactpu
LEGGI.--machine-type
Configura le dimensioni della tua VM di Compute Engine. Un elenco completo dei tipi di macchine è disponibile nella pagina Tipi di macchine di Cloud. (valore predefinito = n1-standard-2)--name
Sostituisci il nome da utilizzare per le VM e Cloud TPU. (valore predefinito = nome utente)--noconf
Salta la conferma.--preemptible
Crea un nodo Cloud TPU prerilasciabile. Una Cloud TPU prerilasciabile costa meno all'ora rispetto a una Cloud prerilasciabili. 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 costa meno all'ora 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 cloud o dai metadati 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. (valore predefinito = ultima release stabile)--tpu-only
Assegna una Cloud TPU solo da utilizzare solo se hai già una VM.--tpu-size
Configura le dimensioni e la versione hardware di una Cloud TPU.--use-dl-images
Utilizza le immagini Deep Learning VM (vedi documenti: https://cloud.google.com/deep-learning-vm/) anziché le immagini della macchina TPU. (valore predefinito = immagini macchina TPU)--vm-only
È necessario allocare solo una VM; utilizzala quando non è tutto pronto per la configurazione e il pagamento di una TPU.--zone
Esegui l'override della zona Compute Engine da utilizzare per l'allocazione di VM e Cloud TPU. Sulla 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