Menginstal gcloud CLI

Halaman ini berisi petunjuk untuk memilih dan mempertahankan penginstalan Google Cloud CLI. Google Cloud CLI mencakup alat command line gcloud, gsutil, dan bq. Untuk mengetahui daftar fitur gcloud CLI, lihat Semua fitur.

Untuk mengakses Google Cloud API menggunakan bahasa pemrograman yang didukung, Anda dapat mendownload Library Klien Cloud.

Anda harus membaca artikel Menyiapkan Google Cloud CLI untuk Cloud de Confiance sebelum mengikuti petunjuk apa pun dalam panduan ini.

Petunjuk penginstalan

Petunjuk ini adalah untuk menginstal Google Cloud CLI. Untuk mengetahui informasi tentang cara menginstal komponen tambahan, seperti perintah gcloud CLI di tingkat rilis alfa atau beta, lihat Mengelola komponen gcloud CLI.

Linux
  1. Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.9 hingga 3.14. Perhatikan, paket Linux x86_64 menyertakan penafsir Python yang dipaketkan yang akan dipilih secara default. Untuk mengetahui informasi cara memilih dan mengonfigurasi penafsir Python Anda, lihat gcloud topic startup.
  2. Download salah satu opsi berikut:
    Platform Nama paket Ukuran SHA256 Checksum
    Linux 64 bit

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 150,5 MB 31000673c1f9e18ec7b38823748031c58949cb0479d36ede999ae8cad6097ae3
    Linux 64 bit

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 57,1 MB a1c1a88274e8bf11561771b9373b566cbb044f1cb3884e454625ec9449ea33f2
    Linux 32 bit

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 57,1 MB 32ff2bea65cd5c79aa86b948219c1e861a0434cc99011f4d977c4a9810e595de

    Untuk mendownload file arsip Linux, jalankan perintah berikut: 

    curl -O https://storage.s3nsapis.fr/cloud-sdk-release/google-cloud-cli-linux-x86_64.tar.gz

    Lihat tabel di atas dan ganti google-cloud-cli-linux-x86_64.tar.gz dengan nama paket *.tar.gz yang berlaku untuk konfigurasi Anda.

  3. Untuk mengekstrak konten file ke sistem file Anda (sebaiknya ke direktori home Anda), jalankan perintah berikut: 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     Opsional: Untuk mengganti penginstalan yang ada, hapus direktori google-cloud-sdk yang ada, lalu ekstrak arsip ke lokasi yang sama.
  4. (Opsional) Tambahkan gcloud CLI ke PATH Anda. Anda juga dapat memilih untuk melakukan pelengkapan perintah untuk shell dan pengumpulan statistik penggunaan. Jalankan skrip penginstalan (dari root folder yang Anda ekstrak pada langkah terakhir) menggunakan perintah berikut: 
    ./google-cloud-sdk/install.sh
     Hal ini juga dapat dilakukan secara noninteraktif (misalnya, menggunakan skrip) dan dengan memberikan preferensi sebagai flag. Untuk melihat flag yang tersedia, jalankan: 
    ./google-cloud-sdk/install.sh --help
    • Untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI, jawab Y saat diminta.
    • Untuk menambahkan gcloud CLI ke PATH dan mengaktifkan penyelesaian perintah, jawab Y saat diminta.
  5. Jika Anda memperbarui PATH di langkah sebelumnya, buka terminal baru agar perubahan diterapkan.
  6. Opsional: Instal komponen tambahan menggunakan pengelola komponen.
macOS
  1. Pastikan Anda memiliki versi Python yang didukung:
    • Untuk memeriksa versi Python Anda saat ini, jalankan python3 -V atau python -V. Versi yang didukung adalah Python 3.9 hingga 3.14.
    • Skrip penginstalan utama menawarkan penginstalan Python 3.12 CPython.
      • Alat Command Line Xcode diperlukan untuk menginstal Python.
      • Pastikan Alat Command Line Xcode sudah diinstal dengan menjalankan: xcode-select -p.
      • Jika Alat Command Line Xcode tidak diinstal, instal dengan menjalankan: sudo xcode-select --install.
    • Atau, untuk menginstal versi Python yang didukung, buka Rilis Python untuk macOS di Python.org.
    • Jika Anda telah menginstal beberapa penafsir Python di komputer, tetapkan variabel lingkungan CLOUDSDK_PYTHON dalam shell Anda untuk mengarah ke jalur penafsir pilihan Anda.
    • Untuk mengetahui informasi selengkapnya tentang cara memilih dan mengonfigurasi penafsir Python Anda, lihat gcloud topic startup.
  2. Download salah satu opsi berikut:

    3. Platform Paket Ukuran SHA256 Checksum
    macOS 64-bit

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 57,2 MB b24a11aa4f1816bff3122b3560c909c1eb7109bf8979821251d8bc5679582f10
    macOS 64-bit

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 57,1 MB b4d2b8b63593ad226cf1c4da0667ffa4a9cb923bd41ec269e67891491aeb126a
    macOS 32-bit

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 55,7 MB 6e66bdc92029fd3a3856e6a9bc03f2799079184ff3fe436c7ade1ef1a8f03452
  3. Ekstrak arsip ke lokasi mana pun pada sistem file Anda (sebaiknya direktori Home Anda). Di macOS, hal ini dapat dilakukan dengan membuka file arsip .tar.gz yang didownload di lokasi yang diinginkan. Atau jalankan perintah berikut: 
    tar -xf google-cloud-cli-darwin-arm.tar.gz

    Opsional: Untuk mengganti penginstalan yang ada, hapus direktori google-cloud-sdk yang ada, lalu ekstrak arsip ke lokasi yang sama.

  4. Jalankan skrip penginstalan (dari root folder yang Anda ekstrak pada langkah terakhir) menggunakan perintah berikut: 
    ./google-cloud-sdk/install.sh

    Skrip akan meminta untuk menginstal Python 3.12 dan modul tertentu yang direkomendasikan.

    Penginstalan juga dapat dilakukan secara noninteraktif (misalnya, menggunakan skrip) dengan memberikan preferensi sebagai flag. Untuk mendeskripsikan flag yang tersedia, jalankan: 
    ./google-cloud-sdk/install.sh --help
     Untuk menjalankan skrip penginstalan dengan mode pembaca layar aktif: 
    ./google-cloud-sdk/install.sh --screen-reader=true
     Opsional:
    • Untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI, jawab Y saat diminta.
    • Untuk menambahkan gcloud CLI ke PATH dan mengaktifkan penyelesaian perintah, jawab Y saat diminta.
  5. Jika Anda memperbarui PATH di langkah sebelumnya, buka terminal baru agar perubahan diterapkan.
  6. Opsional. Instal komponen tambahan menggunakan pengelola komponen.
Windows
    Google Cloud CLI dapat digunakan di Windows 8.1 dan yang lebih baru, serta Windows Server 2012 dan yang lebih baru.

  1. Download penginstal Google Cloud CLI.

    Atau, buka terminal PowerShell dan jalankan perintah PowerShell berikut: 

    (New-Object Net.WebClient).DownloadFile("https://storage.s3nsapis.fr/cloud-sdk-release/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")

& $env:Temp\GoogleCloudSDKInstaller.exe

  2. Luncurkan penginstal dan ikuti petunjuknya. Penginstal ditandatangani oleh Google LLC.

    Jika Anda menggunakan pembaca layar, centang kotak Aktifkan mode pembaca layar. Opsi ini mengonfigurasi gcloud untuk menggunakan pelacak status, bukan indikator lingkaran berputar unicode, serta menampilkan progres sebagai persentase, dan meratakan tabel. Untuk mengetahui informasi selengkapnya, lihat Panduan fitur aksesibilitas.

  3. Google Cloud CLI memerlukan Python; versi yang didukung adalah Python 3.9 hingga 3.14. Secara default, Google Cloud CLI versi Windows dilengkapi dengan Python 3. Untuk menggunakan Google Cloud CLI, sistem operasi Anda harus dapat menjalankan versi Python yang didukung.

    Penginstal menginstal semua dependensi yang diperlukan, termasuk versi Python yang diperlukan. Meskipun Google Cloud CLI menginstal dan mengelola Python 3 secara default, Anda dapat menggunakan penginstalan Python yang sudah ada jika diperlukan dengan menghapus centang opsi untuk Menginstal Python yang Dipaketkan. Lihat gcloud topic startup untuk mempelajari cara menggunakan penginstalan Python yang sudah ada.

  4. Setelah penginstalan selesai, penginstal akan memberi Anda opsi untuk membuat Menu Mulai dan pintasan Desktop, memulai shell Google Cloud CLI, dan mengonfigurasi gcloud CLI. Pastikan Anda membiarkan opsi untuk memulai shell dan mengonfigurasi penginstalan telah dipilih. Penginstal memulai jendela terminal dan menjalankan perintah gcloud init.

  5. Penginstalan default tidak menyertakan ekstensi App Engine yang diperlukan untuk men-deploy aplikasi menggunakan perintah gcloud. Komponen ini dapat diinstal menggunakan pengelola komponen gcloud CLI.
Tips pemecahan masalah:
  • Jika penginstalan Anda tidak berhasil karena perintah find tidak dikenali, pastikan variabel lingkungan PATH Anda ditetapkan untuk menyertakan folder yang berisi find. Biasanya, ini adalah C:\WINDOWS\system32;.
  • Jika gcloud CLI di-uninstal, Anda harus memulai ulang sistem sebelum menginstal gcloud CLI lagi.
  • Jika proses ekstrak gagal, jalankan penginstal sebagai administrator.

Opsi penginstalan lainnya

Bergantung pada kebutuhan pengembangan Anda, bukan penginstalan yang direkomendasikan, Anda dapat menggunakan metode alternatif untuk menginstal gcloud CLI:

  • Menggunakan gcloud CLI dengan skrip atau Continuous Integration/Deployment? Download arsip berversi untuk penginstalan non-interaktif gcloud CLI versi tertentu.
  • Menjalankan Ubuntu dan lebih memilih update otomatis? Gunakan paket snap untuk menginstal gcloud CLI.
  • Untuk penginstalan interaktif Windows dan macOS, serta semua kasus penggunaan lainnya, jalankan penginstal interaktif untuk menginstal rilis gcloud CLI terbaru.

Mengelola penginstalan

Setelah menginstal gcloud CLI, Anda dapat menggunakan perintah di grup perintah gcloud components untuk mengelola penginstalan Anda. Hal ini mencakup melihat komponen yang diinstal, menambahkan dan menghapus komponen, serta mengupgrade ke versi baru atau mendowngrade ke versi tertentu dari gcloud CLI.

Misalnya, Anda dapat menggunakan perintah berikut untuk mengupgrade gcloud CLI ke versi yang lebih baru:

gcloud components update

Versi gcloud CLI sebelumnya

Jika Anda memerlukan gcloud CLI versi lain, instal versi saat ini menggunakan petunjuk yang muncul di halaman ini sebelumnya, lalu login. Setelah login, Anda dapat mendownload rilis sebelumnya. Untuk melihat versi yang diurutkan berdasarkan tanggal, pastikan Anda mengaktifkan Urutkan dan filter lalu klik kolom Dibuat.

Versi Python yang didukung

Google Cloud CLI memerlukan Python 3.9 hingga 3.14. Untuk mengetahui informasi tentang cara memilih dan mengonfigurasi penafsir Python Anda, lihat gcloud topic startup.