Menginstal Google Cloud CLI

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.

Untuk mengikuti panduan langkah demi langkah untuk tugas ini langsung di Google Cloud konsol, klik Pandu saya:

Pandu saya

Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud 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

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud 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

  5. Verify that billing is enabled for your Google Cloud project.

Instal gcloud CLI versi 577.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 penafsir 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 88,5 MB 1c478abfe0fbe256b8ecaba2faeff154e44c308064b1c69d9ec15b879a4944bd
    Linux 64 bit

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 61,3 MB ef8ded3afd45c89bc3900e32579bddfa406b44f7837d993adac417f00b41aa8f
    Linux 32 bit

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 61,4 MB 52164ff332756c784df60ffcca7f6fd89c5465431b2019cbcd117631b76898c2

    Untuk mendownload file arsip Linux, jalankan perintah berikut: 

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/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.
Debian/Ubuntu

Isi paket

Gcloud CLI tersedia dalam format paket untuk diinstal di sistem Debian dan Ubuntu. Paket ini hanya berisi alat command line gcloud, gcloud alpha, gcloud beta, gsutil, dan bq. Versi ini tidak menyertakan ekstensi kubectl atau App Engine yang diperlukan untuk men-deploy aplikasi menggunakan perintah gcloud. Jika menginginkan komponen ini, Anda harus menginstalnya secara terpisah.

Sebelum memulai

Sebelum menginstal gcloud CLI, pastikan sistem operasi Anda memenuhi persyaratan berikut:

  • Ini adalah rilis Ubuntu yang belum mencapai akhir siklus proses atau rilis stabil Debian yang belum mencapai akhir siklus proses.
  • Baru-baru ini, paket-paketnya telah diperbarui. Untuk melakukannya sekarang, jalankan perintah berikut: 
    sudo apt-get update
  • Library ini telah menginstal ca-certificates, gnupg, dan curl. Untuk menginstal paket ini, jalankan perintah berikut: 
    sudo apt-get install ca-certificates gnupg curl

Penginstalan

  1. Impor Google Cloud kunci publik.

    • Untuk distribusi yang lebih baru (Debian 9+ atau Ubuntu 18.04+), jalankan perintah berikut:

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
    • Untuk distribusi yang lebih lama, jalankan perintah berikut: 
      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    • Jika perintah apt-key distribusi Anda tidak mendukung argumen --keyring, jalankan perintah berikut:

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    • Jika Anda tidak bisa mendapatkan update terbaru karena kunci yang sudah tidak berlaku, dapatkan file kunci apt-get.gpg terbaru.

  2. Tambahkan URI distribusi gcloud CLI sebagai sumber paket.
    • Untuk distribusi yang lebih baru (Debian 9+ atau Ubuntu 18.04+), jalankan perintah berikut: 
      echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

    • Untuk distribusi lama yang tidak mendukung opsi ditandatangani oleh, jalankan perintah berikut:

      echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  3. Update dan instal gcloud CLI: 
    sudo apt-get update && sudo apt-get install google-cloud-cli
     Untuk opsi apt-get tambahan, seperti menonaktifkan dialog atau uji coba, lihat halaman manual apt-get.

    Tips Docker: Jika menginstal gcloud CLI di dalam image Docker, gunakan satu langkah RUN saja:

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
    Untuk image dasar lama yang tidak mendukung perintah gpg --dearmor: 
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
  4. Opsional: Instal salah satu komponen tambahan berikut:
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-tools
    • google-cloud-cli-tests
    • kubectl

    Misalnya, komponen google-cloud-cli-app-engine-java dapat diinstal sebagai berikut: 

    sudo apt-get install google-cloud-cli-app-engine-java

Mendowngrade versi gcloud CLI

Untuk kembali ke versi gcloud CLI tertentu, jalankan perintah berikut dengan VERSION dalam bentuk 123.0.0:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

Sepuluh rilis terbaru selalu tersedia di repo. Untuk rilis sebelum 371.0.0, nama paketnya adalah google-cloud-sdk

Red Hat/Fedora/CentOS

Isi paket

Gcloud CLI tersedia dalam format paket untuk diinstal di sistem Red Hat Enterprise Linux 7, 8, 9, dan 10; Fedora 41 dan 42; serta CentOS 7 dan 8. Paket ini hanya berisi perintah gcloud, gcloud alpha, gcloud beta, gsutil, dan bq. Ini tidak mencakup ekstensi kubectl atau App Engine yang diperlukan untuk men-deploy aplikasi menggunakan perintah gcloud, yang dapat diinstal secara terpisah, seperti yang akan dijelaskan nanti di bagian ini.

Penginstalan

  1. Update DNF dengan informasi repositori gcloud CLI.

    • Contoh perintah berikut ditujukan untuk penginstalan yang kompatibel dengan Red Hat Enterprise Linux 7, 8, atau 9, tetapi pastikan Anda memperbarui setelan sesuai kebutuhan untuk konfigurasi Anda:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

    • Untuk penginstalan yang kompatibel dengan RHEL 10, gunakan perintah berikut dengan gpgkey yang diperbarui:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg
EOM

    • Untuk penginstalan ARM64 (aarch64), gunakan https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-aarch64 (kompatibel dengan RHEL 7, 8, atau 9) atau https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-aarch64 (kompatibel dengan RHEL 10) sebagai nilai baseurl.

  2. Instal libxcrypt-compat.x86_64. 
    sudo dnf install libxcrypt-compat.x86_64
  3. Instal gcloud CLI: 
    sudo dnf install google-cloud-cli
  4. Opsional: Instal salah satu komponen tambahan berikut:
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-validator
    • google-cloud-cli-tests
    • kubectl

    Misalnya, untuk menginstal komponen google-cloud-cli-app-engine-java, jalankan perintah berikut: 

    sudo dnf install google-cloud-cli-app-engine-java

Mendowngrade versi gcloud CLI

Untuk kembali ke versi gcloud CLI tertentu, jalankan perintah berikut. Ganti 123.0.0 dengan versi yang ingin Anda instal: 

sudo dnf downgrade google-cloud-cli-123.0.0

Sepuluh rilis terbaru tersedia di repositori. Untuk rilis sebelum 371.0.0, gunakan google-cloud-sdk sebagai nama paket.

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.14 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: