Riferimento CTPU

Panoramica

Importante: lo strumento ctpu è stato deprecato e la sua funzionalità è stata sostituita dai comandi gcloud compute tpus corrispondenti.

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 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 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.

Importante: ti verrà comunque addebitato lo spazio su disco utilizzato dalla VM mentre è in pausa.

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. Utilizza gcloud 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 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 VM Cloud TPU e di Compute Engine.

Importante: se le risorse sono in esecuzione in una regione o una zona non predefinita, devi _devi_ specificare il flag "--zone".

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 esegui ctpu 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 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 è 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 a ctpu. Per informazioni dettagliate, consulta ctpuREADME.

--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, 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