Menginstal Google Cloud CLI

Sebelum mengikuti petunjuk dalam panduan ini, baca bagian Menyiapkan Google Cloud CLI untuk Cloud de Confiance.

Panduan memulai ini menjelaskan metode yang direkomendasikan untuk menginstal dan melakukan inisialisasi Google Cloud CLI. Setelah inisialisasi, jalankan beberapa perintah gcloud CLI inti untuk melihat informasi tentang penginstalan Anda dan memverifikasi keberhasilannya.

Sebelum memulai

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

Instal gcloud CLI versi 563.0.0

Linux
  1. Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.10 hingga 3.14. Paket Linux x86_64 menyertakan interpreter Python yang dipaketkan yang akan dipilih secara default. Untuk mengetahui informasi cara memilih dan mengonfigurasi penafsir Python Anda, lihat dokumentasi 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 204,4 MB 5b52cd57fc55b281c1fd3dc3bdbb23c136eda04395c2067a97b4eae46ebaa8e7
    Linux 64 bit

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 59,2 MB fe1f39a1930048e18af6dd2682ece0a44adf9cbc5a13740490cd1b15a41100dc
    Linux 32 bit

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 59,2 MB ae31fe27f61094a2a71ee5e4bbd3657edf13e9e6157193d25221610e43c4a4df

    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, jalankan perintah berikut: 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     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: 
    ./google-cloud-sdk/install.sh
     Skrip akan meminta Anda melakukan tindakan penyiapan berikut. Untuk menerima, jawab Y saat diminta.
    • Tambahkan gcloud CLI ke PATH Anda.
    • Aktifkan penyelesaian perintah.
    • Pilih untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI.
    Anda juga dapat melakukan penginstalan secara noninteraktif dengan memberikan tanda. Untuk melihat flag yang tersedia, jalankan: 
    ./google-cloud-sdk/install.sh --help
  5. Opsional: Jika Anda memperbarui PATH pada langkah sebelumnya, buka terminal baru agar perubahan diterapkan.
macOS
  1. Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.10 hingga 3.14.

    Untuk memeriksa versi Python Anda, jalankan python3 -V atau python -V.

    Penginstal gcloud akan menginstal Python v3.13 dan modul ekstensi yang diperlukan secara default.

    Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi penafsir Python, lihat dokumentasi gcloud topic startup.

  2. Download salah satu opsi berikut:
    Platform Paket Ukuran SHA256 Checksum
    macOS 64-bit

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 59,4 MB 60e3bd647dc15345fed388964b1eecd2a4686f6eafdf86490715c313330e5324
    macOS 64-bit

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 59,3 MB b447cb69bddf758a6141f29d009b33159b839a1639fb0a93252aeec6cc80d7e9
    macOS 32-bit

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 57,7 MB 5c890a0099f022aec71902616038358524fbef435c40795f5c21813c2b17b661

    Atau, Anda dapat mendownload arsip dari command line. Ganti FILE_NAME dengan nama paket untuk platform Anda dari tabel di atas. 

    curl -O https://storage.s3nsapis.fr/cloud-sdk-release/FILE_NAME
  3. Ekstrak konten file ke lokasi pilihan Anda di sistem file Anda. Praktik yang umum adalah mengekstraknya ke direktori beranda Anda.

    Di macOS, Anda dapat melakukannya dengan membuka file .tar.gz yang didownload di lokasi pilihan Anda. Atau, dari command line, jalankan: 

    tar -xf FILE_NAME

    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: 
    ./google-cloud-sdk/install.sh
     Skrip akan meminta Anda melakukan tindakan penyiapan berikut. Untuk menerima, jawab Y saat diminta.
    • Instal Python 3.13 dan modul yang direkomendasikan jika diperlukan.
    • Tambahkan gcloud CLI ke PATH Anda dan aktifkan penyelesaian perintah.
    • Pilih untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI.
    Anda juga dapat melakukan penginstalan secara noninteraktif dengan memberikan tanda. Untuk melihat flag yang tersedia, jalankan: 
    ./google-cloud-sdk/install.sh --help
     Untuk menjalankan skrip penginstalan dengan mode pembaca layar diaktifkan: 
    ./google-cloud-sdk/install.sh --screen-reader=true
  5. Opsional: Jika Anda memperbarui PATH pada langkah sebelumnya, buka terminal baru agar perubahan diterapkan.
Windows

Google Cloud CLI di Windows memerlukan Windows 8.1 dan yang lebih baru, atau 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.
    • Google Cloud CLI memerlukan Python; versi yang didukung adalah Python 3.10 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.

  3. Setelah penginstalan selesai, penginstal akan memberi Anda opsi untuk membuat pintasan Menu Mulai dan Desktop, serta memulai shell Google Cloud CLI. Hapus centang pada opsi untuk memulai shell. Anda akan menjalankan dan mengonfigurasi gcloud CLI pada langkah berikutnya.

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.

Melakukan inisialisasi dan otorisasi gcloud CLI

Jika Anda berada di belakang proxy atau firewall, lihat Konfigurasi proxy untuk mengaktifkan akses jaringan untuk gcloud CLI.

Setelah menginstal gcloud CLI, lakukan inisialisasi untuk memberikan otorisasi akses ke Cloud de Confiance dan menyiapkan konfigurasi default. Untuk mengetahui informasi selengkapnya, lihat gcloud init.

  1. Jalankan gcloud init untuk melakukan inisialisasi gcloud CLI:

    gcloud init

    Secara default, perintah ini akan membuka browser web untuk mengizinkan akses. Untuk memberikan otorisasi dari command line, tambahkan flag --console-only. Untuk otorisasi non-interaktif, buat akun layanan dengan cakupan yang sesuai di konsolCloud de Confiance , lalu gunakan gcloud auth activate-service-account dengan file kunci JSON-nya.

  2. Ikuti perintah untuk memberikan otorisasi dan mengonfigurasi:

    • Saat diminta untuk login, terima, lalu login ke Akun Google Anda di browser. Klik Izinkan untuk memberikan izin akses ke resource.

    • Dari daftar project yang izin Pemilik, Editor, atau Pelihat-nya Anda miliki, pilih project. Jika Anda hanya memiliki satu project, gcloud init akan memilihnya untuk Anda.

      Jika memiliki lebih dari 200 project, Anda akan diminta untuk memasukkan project ID, membuat project, atau mencantumkan project. Jika memilih untuk membuat project, Anda juga harus mengaktifkan penagihan di project tersebut.

    • Jika Anda telah mengaktifkan Compute Engine API, pilih zona Compute Engine default.

  3. Opsional: Untuk pengalaman pembaca layar yang lebih baik, aktifkan properti accessibility/screen_reader dengan perintah berikut:

    gcloud config set accessibility/screen_reader true

    Untuk mengetahui informasi selengkapnya, lihat panduan Mengaktifkan fitur aksesibilitas.

Menjalankan perintah inti

Jalankan perintah inti untuk melihat informasi tentang penginstalan gcloud CLI Anda:

  1. Mencantumkan akun yang kredensialnya disimpan di sistem lokal:

    gcloud auth list

    gcloud CLI menampilkan daftar akun yang memiliki kredensial:

    Credentialed Accounts
ACTIVE             ACCOUNT
*                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com

  2. Mencantumkan properti dalam konfigurasi gcloud CLI aktif Anda:

    gcloud config list

    gcloud CLI menampilkan daftar properti:

    [core]
account = principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
disable_usage_reporting = False
project = my-project

  3. Melihat informasi tentang perintah gcloud dan topik lainnya:

    gcloud help

    Misalnya, untuk melihat bantuan untuk gcloud compute instances create:

    gcloud help compute instances create

    gcloud CLI menampilkan topik bantuan yang berisi deskripsi perintah, daftar flag dan argumen perintah, serta contoh cara menggunakan perintah.

Opsional: Menginstal komponen tambahan

Untuk menginstal komponen tambahan, seperti emulator App Engine, kubectl, atau perintah gcloud CLI di tingkat rilis alfa atau beta, lihat Mengelola komponen gcloud CLI.

Langkah berikutnya

  • Baca panduan gcloud CLI untuk mengetahui ringkasan gcloud CLI, termasuk pengantar singkat tentang konsep utama, konvensi perintah, dan tips bermanfaat.
  • Baca panduan referensi gcloud CLI untuk melihat halaman mendetail tentang setiap perintah gcloud CLI, termasuk deskripsi, flag, dan contoh, yang dapat Anda gunakan untuk melakukan berbagai tugas di Cloud de Confiance.
  • Lihat ringkasan gcloud CLI untuk mengetahui daftar perintah yang umum digunakan dan konsep utama.