Referensi CTPU

Ringkasan

Alat ctpu open source digunakan untuk membuat kelompok 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
Menetapkan atau menampilkan 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
  • commands - list all command names
  • flags - menjelaskan semua flag tingkat atas yang diketahui
  • help - menjelaskan subperintah dan sintaksisnya
Flag 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
Mencantumkan semua subperintah ctpu dan flag level teratas.
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`

list (ls)

Deskripsi
Mencantumkan 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 penagihan untuk penggunaan Cloud TPU hingga Anda menjalankan ctpu up.

Untuk memastikan Cloud TPU dihentikan, Anda harus menentukan nama Cloud TPU dan zona di 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
Cetak konfigurasi nama Cloud TPU, nama project, dan zona saat ini di layar.
Contoh
ctpu print-config

kuota

Deskripsi
Menampilkan URL tempat Anda 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 telah berhenti berjalan karena masalah hardware. Gunakan gcloud compute tpu start atau tombol START di halaman Compute Engine > TPUs di konsol Cloud jika TPU berada dalam status STOPPED.

restart tidak memulai ulang Cloud TPU yang dihentikan. Anda harus menjalankan ctpu delete dan ctpu up jika Cloud TPU Anda telah didahului.

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

status (st)

Deskripsi

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

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
Mencantumkan semua zona tempat jenis TPU tersedia.
Penggunaan
ctpu tpu-locations
Output
Cloud TPU Locations:
    asia-east1-c
    europe-west4-a
    us-central1-a
    us-central1-b
    us-central1-c

tpu-sizes

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

naik

Deskripsi

Tampilkan set resource ctpu. Saat pertama kali menjalankan ctpu up pada project, prosesnya akan memerlukan waktu lebih lama daripada saat dijalankan di masa mendatang karena melakukan tugas seperti penerapan kunci SSH dan turn-up 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 diperlukan dari project Google Cloud Anda, dengan memberikan peran IAM tertentu ke akun layanan Cloud TPU Anda.
  • Melakukan sejumlah pemeriksaan lainnya.
  • Login ke VM Compute Engine baru Anda. 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 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
Konfigurasikan ukuran volume root VM Compute Engine Anda. Nilai harus berupa bilangan bulat. (default = 250)

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

--forward-agent
Mengaktifkan 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
Teruskan port yang berguna dari VM Compute Engine ke komputer lokal Anda secara otomatis. Port yang diteruskan adalah: 6006 (tensorboard), 8888 (jupyter notebook), 8470 (port TPU), 8466 (port profiler TPU). (default = true)

--gce-image
Ganti Image Compute Engine yang dipilih secara otomatis. Gunakan flag ini saat Anda menggunakan image kustom Anda sendiri, bukan 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 mengetahui informasi tentang jaringan. (default = jaringan default)

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

--machine-type
Konfigurasikan 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. Cloud TPU preemptible memiliki biaya per jam yang lebih rendah daripada Cloud TPU yang tidak dapat diakhiri. Layanan Cloud TPU dapat keluar dari perangkat preemptible kapan saja. (default = non-preemptible)

--preemptible-vm
Buat VM Compute Engine preemptible. Biaya preemptible VM lebih murah per jam daripada VM non-preemptible. 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 ini hanya jika Anda sudah memiliki VM.

--tpu-size
Mengonfigurasi 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
Hanya alokasikan VM; gunakan opsi ini jika Anda belum siap menyiapkan dan membayar TPU.

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

versi

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