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 ctpucomandi 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
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. Utilizza gcloud 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 eseguire ctpu delete e ctpu 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 esegui ctpu 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 a username@tpuname.

Puoi eseguire ctpu up tutte le volte che vuoi. Ad esempio, se perdi la connessione SSH alla VM di Compute Engine, esegui ctpu 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 di ctpu. Per maggiori dettagli, consulta la pagina ctpu 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, esegui ctpu 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