Referensi CTPU

Ringkasan

Alat ctpu open source digunakan untuk membuat flock resource komputasi, yang terdiri dari VM Compute Engine dan satu atau beberapa perangkat Cloud TPU. Alat ini sudah diinstal sebelumnya di Cloud Shell Anda.

Anda dapat menemukan dokumentasi dan kode untuk ctpu di GitHub.

Alat ctpu menggunakan sintaksis berikut:

ctpu <subcommand> <flags> <subcommand> <subcommand args>

Berikut adalah subperintah untuk ctpu:

auth

Deskripsi
Tetapkan atau tampilkan otorisasi untuk Cloud TPU.
Penggunaan
ctpu auth <flags> <subcommand> <subcommand args>
Contoh
ctpu auth list --project="my-project" --zone=us-central1-a
ctpu auth list --project my-project --zone us-central1-a
Subperintah

Perintah ctpu auth mendukung subperintah berikut:

  • add-bigtable - memastikan Cloud TPU diotorisasi untuk Cloud Bigtable
  • add-gcs - memastikan Cloud TPU diotorisasi untuk Cloud Storage
  • list - menampilkan otorisasi akun layanan Cloud TPU
  • perintah - mencantumkan semua nama perintah
  • tanda - mendeskripsikan semua tanda tingkat atas yang diketahui
  • bantuan - menjelaskan sub-perintah dan sintaksnya
Tanda Opsional

Berikut adalah perintah opsional untuk ctpu auth. name | project | zone

hapus (rm)

Deskripsi
Hapus VM Compute Engine dan Cloud TPU Anda.
Penggunaan
ctpu rm <flags>
Contoh
ctpu rm --zone=us-central1-b

bantuan

Deskripsi
Cantumkan semua subperintah ctpu dan tanda tingkat atas.
Penggunaan
ctpu help
ctpu help <subcommand>
Contoh
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`

daftar (ls)

Deskripsi
Cantumkan semua VM Compute Engine dan Cloud TPU di zona yang ditentukan.
Penggunaan
ctpu ls <flags>
Contoh
ctpu ls --zone=us-central1-b

jeda (zz)

Deskripsi

Hentikan VM Compute Engine, dan hapus Cloud TPU Anda. Hentikan tagihan untuk penggunaan Cloud TPU hingga Anda menjalankan ctpu up.

Untuk memastikan Cloud TPU dihentikan, Anda harus menentukan nama Cloud TPU dan zona pada command line.

Penggunaan
ctpu pause <name, zone>
Contoh
ctpu pause --name=my-tpu --zone=us-central1-a  // pause the named TPU
in the specified zone
Deskripsi
Mencetak konfigurasi nama, nama project, dan zona Cloud TPU saat ini di layar.
Contoh
ctpu print-config

kuota

Deskripsi
Tampilkan URL yang dapat melihat kuota.
Penggunaan
ctpu quota
Contoh
ctpu quota
Output: Quotas cannot currently be displayed within ctpu.
To view your quota, open <url>
Request additional quota from <url>

restart

Deskripsi

Memulai ulang Cloud TPU yang masih dalam status BERJALAN (ditampilkan di ctpu status), tetapi berhenti berjalan karena masalah hardware. Gunakan gcloud compute tpu start atau tombol MULAI di halaman Compute Engine > TPU di Cloud Console jika TPU dalam status DIHENTIKAN.

restart tidak memulai ulang Cloud TPU yang di-preempt. Anda harus menjalankan ctpu delete dan ctpu up jika Cloud TPU Anda telah di-preempt.

Penggunaan
ctpu restart <flags>
Contoh
ctpu restart --zone=us-central1-a

status (st)

Deskripsi

Buat kueri GCP API (khusus zona default) untuk menentukan status Cloud TPU dan VM Compute Engine saat ini.

Penggunaan

ctpu st

Contoh
ctpu st --zone=us-central1-a
Status message:
  Your cluster is running!
    Compute Engine VM:  RUNNING
    Cloud TPU:     RUNNING

tpu-locations

Deskripsi
Cantumkan semua zona tempat jenis TPU tersedia.
Penggunaan
tpu-lokasi ctpu
Output
Cloud TPU Locations:
    asia-east1-c
    europe-west4-a
    us-central1-a
    us-central1-b
    us-central1-c

ukuran tpu

Deskripsi
Mencantumkan semua ukuran TPU yang tersedia di zona yang ditentukan. Beberapa ukuran hanya tersedia di zona tertentu. (default = zona default)
Penggunaan
tpu-sizes <zone>
Contoh
ctpu tpu-sizes --zone=us-central1-a

panah atas

Deskripsi

Munculkan set resource ctpu. Saat pertama kali menjalankan ctpu up pada project, diperlukan waktu lebih lama daripada project tersebut pada masa mendatang karena project tersebut menjalankan tugas seperti penerapan kunci SSH dan perubahan API.

  • Mengaktifkan layanan Compute Engine dan Cloud TPU.
  • Membuat VM Compute Engine dengan versi TensorFlow stabil terbaru yang telah diinstal sebelumnya.
  • Menetapkan zona default, seperti us-central1-b berdasarkan lokasi Anda.
  • Meneruskan nama Cloud TPU ke VM Compute Engine sebagai variabel lingkungan (TPU_NAME).
  • Memastikan Cloud TPU Anda memiliki akses ke resource yang dibutuhkan dari project Google Cloud Anda, dengan memberikan peran IAM tertentu ke akun layanan Cloud TPU Anda.
  • Melakukan sejumlah pemeriksaan lain.
  • Anda akan login ke VM Compute Engine baru. Perintah shell Anda berubah dari username@project menjadi username@tpuname.

Anda dapat menjalankan ctpu up sesering yang Anda inginkan. Misalnya, jika Anda kehilangan koneksi SSH ke VM Compute Engine, jalankan ctpu up untuk memulihkan koneksi. Anda harus menentukan zona jika Compute Engine Anda tidak berada di zona default. Contoh:

$ ctpu up --zone=us-central1-a
Penggunaan
ctpu up <flags>
Contoh
ctpu up --tpu-size=v2-8 --disk-size-gb=320 --preemptible
Flag

--disk-size-gb
Konfigurasi ukuran volume root VM Compute Engine Anda. Nilai harus berupa bilangan bulat. (default = 250)

--dry-run
Jangan membuat perubahan; cetak hanya hal yang akan terjadi.

--forward-agent
Aktifkan penerusan agen SSH saat melakukan ssh ke VM Compute Engine. Penerusan Agen SSH memungkinkan akses ke repositori bersama (seperti GitHub) tanpa harus menempatkan kunci pribadi di VM Compute Engine. (default = true)

--forward-ports
Meneruskan port yang berguna dari VM Compute Engine ke komputer lokal Anda secara otomatis. Port yang diteruskan adalah: 6006 (tensorboard), 8888 (notebook jupyter), 8470 (port TPU), 8466 (port TPU profiler). (default = true)

--gce-image
Ganti Image Compute Engine yang dipilih secara otomatis. Gunakan flag ini saat Anda menggunakan image kustom Anda sendiri, bukan image yang disediakan dengan TensorFlow yang diinstal.

--gcp-network
Tentukan jaringan tempat Cloud TPU dan VM terkait harus dibuat. Lihat Ringkasan Jaringan Virtual Private Cloud (VPC) untuk mendapatkan informasi tentang jaringan. (default = jaringan default)

--log-http
Cetak konten lengkap pasangan permintaan-respons http. Untuk mengaktifkan hasil cetak, tetapkan tanda ini ke true. Gunakan flag ini saat Anda memerlukan output log untuk mengajukan laporan bug terhadap ctpu. Baca README ctpu untuk mengetahui detailnya.

--machine-type
Konfigurasi ukuran VM Compute Engine Anda. Daftar lengkap jenis mesin tersedia di halaman Machine Types Cloud. (default = n1-standard-2)

--name
Ganti nama yang akan digunakan untuk VM dan Cloud TPU. (default = nama pengguna Anda)

--noconf
Lewati konfirmasi.

--preemptible
Buat node Cloud TPU yang dapat dihentikan. Biaya Cloud TPU yang dapat dihentikan lebih murah per jam dibandingkan dengan yang tidak dapat diakhiri. Layanan Cloud TPU dapat keluar dari perangkat yang dapat dihentikan kapan saja. (default = non-preemptible)

--preemptible-vm
Buat preemptible VM Compute Engine. Biaya preemptible VM lebih murah per jam dibandingkan non-preemptible VM. Layanan Compute Engine dapat keluar dari instance VM kapan saja. (default = non-preemptible)

--print-welcome
Selalu cetak pesan selamat datang.

--project
Ganti nama project GCP yang akan digunakan saat mengalokasikan VM dan TPU. Tentukan nilai dari konfigurasi cloud atau metadata Compute Engine, biasanya nama project Anda. Jika nilai yang baik tidak dapat ditemukan, Anda harus memberikan nilai di command line.

--tf-version
Tetapkan versi TensorFlow yang akan digunakan saat membuat VM Compute Engine dan Cloud TPU. (default = rilis stabil terbaru)

--tpu-only
Hanya alokasikan Cloud TPU; gunakan opsi ini hanya jika VM Anda sudah tersedia.

--tpu-size
Konfigurasi ukuran dan versi hardware Cloud TPU.

--use-dl-images
Gunakan Deep Learning VM Image (lihat dokumen: https://cloud.google.com/deep-learning-vm/), bukan image mesin TPU. (default = image mesin TPU)

--vm-only
Alokasikan VM saja; gunakan opsi ini jika Anda belum siap untuk menyiapkan dan membayar TPU.

--zone
Ganti zona Compute Engine yang akan digunakan saat mengalokasikan VM dan Cloud TPU. Pada command line, jalankan ctpu help up untuk melihat daftar.

version

Deskripsi
Mencetak versi ctpu yang terinstal.
Penggunaan
ctpu version
Output
ctpu version
Output: ctpu version: 1.9