Riferimento CTPU

Panoramica

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

Lo strumento open source ctpu viene utilizzato per creare uno insieme di risorse di computing, costituite da una VM di Compute Engine e una o più Dispositivi Cloud TPU. Lo strumento è preinstallato in Cloud shell.

Puoi visualizzare 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 sottocomandi 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

Subcomandi

Il comando ctpu auth supporta i seguenti sottocomandi:

• add-bigtable: assicurati che Cloud TPU sia autorizzato per Cloud Bigtable
• add-gcs - garantisce che Cloud TPU sia autorizzato per Cloud Storage
• list: mostra le autorizzazioni dell'account di servizio Cloud TPU
• commands: elenca tutti i nomi dei comandi
• flag: descrivi tutte le segnalazioni di primo livello note
• help: descrive 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 VM di Compute Engine e Cloud TPU.

Utilizzo

ctpu rm <flags>

Esempio

ctpu rm --zone=us-central1-b

help

Descrizione

Elenca tutti i comandi secondari ctpu 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`

list (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 Cloud TPU venga arrestato, devi specificare il nome di Cloud TPU e la zona dall'interfaccia a riga di comando.

Importante: ti verrà comunque addebitato l'importo di spazio su disco consumato 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 la configurazione corrente del nome, del progetto e della zona di Cloud TPU.

Esempio

ctpu print-config

quota

Descrizione

Visualizza un URL in cui puoi visualizzare 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>

restart

Descrizione

Riavvia una Cloud TPU che è ancora in stato RUNNING (indicata in ctpu status), ma la cui esecuzione è stata interrotta a causa di un problema hardware. Utilizza gcloud compute tpu start o il pulsante Avv avvia nella pagina Compute Engine > TPU della console Cloud se la TPU è nello 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

status (st)

Descrizione

Esegui query sulle API Google Cloud (solo zona predefinita) per determinare lo stato corrente della Cloud TPU e della VM Compute Engine.

Importante: se le risorse vengono eseguite in una regione o zona diversa da quella predefinita, _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 

località-tpu

Descrizione

Elenca tutte le zone in cui i tipi di TPU disponibili.

Utilizzo

località-tpu-ctpu

Output

Cloud TPU Locations:
    asia-east1-c
    europe-west4-a
    us-central1-a
    us-central1-b
    us-central1-c

tpu-sizes

Descrizione

Elenca tutte le dimensioni TPU disponibili nella zona specificata. Sono disponibili alcune dimensioni solo in alcune zone. (default = default zone)

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 in un progetto, l'operazione richiede più tempo rispetto alle esecuzioni future perché vengono eseguite attività come la propagazione delle chiavi SSH e l'attivazione delle API.

• Abilita i servizi Compute Engine e Cloud TPU.
• Crea una VM di Compute Engine con la versione stabile più recente di TensorFlow è preinstallata.
• Assegna una zona predefinita, ad esempio us-central1-b, in base alla tua posizione.
• Passa 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 all'account di servizio Cloud TPU.
• Esegue una serie di altri controlli.
• Accedi alla nuova VM Compute Engine. Il prompt shell viene modificato dalle ore username@project alle ore username@tpuname.

Puoi eseguire ctpu up tutte le volte che vuoi. Ad esempio, se perdi l'accesso SSH alla VM Compute Engine, esegui ctpu up per ripristinare connessione. Devi specificare una zona se Compute Engine non si trova in la 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

Bandiere

--disk-size-gb
Configura le dimensioni del volume principale della VM Compute Engine. Il valore deve essere un numero intero. (valore predefinito = 250)

--dry-run
Non apportare modifiche. e non stampare solo quello che sarebbe successo.

--forward-agent
Abilita il forwarding dell'agente SSH durante l'accesso tramite SSH alla VM di Compute Engine. Il forwarding dell'agente SSH consente di accedere ai repository condivisi (ad esempio GitHub) senza dover inserire le chiavi private sulla VM Compute Engine. (valore predefinito = true)

--forward-ports
Inoltra automaticamente le porte utili dalla VM di Compute Engine alla tua rete locale in una macchina virtuale. Le porte presentate sono: 6006 (tensorboard), 8888 (notebook Jupyter), 8470 (porta TPU), 8466 (porta profiler TPU). (valore predefinito = true)

--gce-image
Esegui l'override dell'immagine Compute Engine scelta automaticamente. Utilizza questo flag se utilizzi le tue immagini personalizzate anziché quelle fornite con la versione di TensorFlow installata.

--gcp-network
Specifica la rete in cui devono essere creati Cloud TPU e la VM associata. Consulta Panoramica della rete Virtual Private Cloud (VPC) per informazioni sulle reti. (predefinita = rete predefinita)

--log-http
Stampa i contenuti completi delle coppie di richieste e risposte HTTP. Per abilitare la stampa, imposta questo flag su true. Usa questo flag quando hai bisogno di un output di log per inviare una segnalazione di bug su ctpu. Fai riferimento a ctpu README per maggiori dettagli.

--machine-type
Configura le dimensioni della tua VM di Compute Engine. Un elenco completo di macchine sono disponibili nel Cloud pagina Tipi di macchine. (valore predefinito = n1-standard-2)

--name
Sostituisci il nome da utilizzare per le VM e Cloud TPU. (valore predefinito = il tuo nome utente)

--noconf
Salta conferma.

--preemptible
Crea un nodo Cloud TPU prerilasciabile. Una Cloud TPU prerilasciabile costa meno all'ora rispetto a una non prerilasciabile. Il servizio Cloud TPU può uscire da un dispositivo prerilasciabile in qualsiasi momento. (valore predefinito = non prerilasciabile)

--preemptible-vm
Creare 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 prelevabile)

--print-welcome
Stampa sempre il messaggio di benvenuto.

--project
Sostituisci il nome del progetto Google Cloud da utilizzare per l'allocazione di VM e TPU. Specifica un valore dai metadati di cloud config o Compute Engine, in genere il nome del progetto. Se non è possibile trovare un valore valido, devi fornire un valore sulla riga di comando.

--tf-version
Imposta la versione di TensorFlow da utilizzare per la creazione della VM Compute Engine e di Cloud TPU. (valore predefinito = release stabile più recente)

--tpu-only
Alloca 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 le immagini VM per il deep learning (consulta la documentazione all'indirizzo https://cloud.google.com/deep-learning-vm/) anziché le immagini VM TPU. (valore predefinito = immagini macchina TPU)

--vm-only
Alloca solo una VM. da utilizzare se non vuoi configurare e pagare una TPU.

--zone
Sostituisci la zona Compute Engine da utilizzare per l'allocazione di VM e Cloud TPU. Nella riga di comando, esegui ctpu help up per visualizzare l'elenco.

versione

Descrizione

Stampa la versione di ctpu installata.

Utilizzo

ctpu version

Output

ctpu version
Output: ctpu version: 1.9