Menginstal gcloud CLI

Halaman ini berisi petunjuk untuk memilih dan mengelola 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.

Petunjuk penginstalan

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

Catatan: Jika Anda berada di belakang proxy atau firewall, lihat halaman setelan proxy untuk mengetahui informasi selengkapnya tentang penginstalan.

Linux

1. Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.8 hingga 3.12. Perhatikan bahwa paket Linux x86_64 menyertakan paket penafsir Python 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:
   Catatan: Untuk menentukan versi Linux, jalankan getconf LONG_BIT di command line.

   Platform	Nama paket	Ukuran	SHA256 Checksum
   Linux 64 bit (x86_64)	google-cloud-cli-472.0.0-linux-x86_64.tar.gz	202,1 MB	f80fea5087bc82b2c4d3aefee8112c25163f44dc47773529eb5e46b0001c8b8f
   Linux 64 bit (Arm)	google-cloud-cli-472.0.0-linux-arm.tar.gz	119,0 MB	f024989b5080f00ab711039c7595a7d9195cc873a89d4f50575afff8a3d9415d
   Linux 32 bit (x86)	google-cloud-cli-472.0.0-linux-x86.tar.gz	117,1 MB	676af5fdb89427c91665face39c9c25ae02860453350525ef12f96bf8ce819f2

   Untuk mendownload file arsip Linux, jalankan perintah berikut:

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-472.0.0-linux-x86_64.tar.gz

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

3. Untuk mengekstrak isi file ke sistem file Anda (sebaiknya ke direktori utama Anda), jalankan perintah berikut:

   tar -xf google-cloud-cli-472.0.0-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. Tambahkan gcloud CLI ke jalur Anda. Jalankan skrip penginstalan dari root folder yang Anda ekstrak menggunakan perintah berikut:

   ./google-cloud-sdk/install.sh

   Hal ini juga dapat dilakukan secara noninteraktif (misalnya, menggunakan skrip) dan dengan memberikan preferensi sebagai tanda. Untuk melihat flag yang tersedia, jalankan:

   ./google-cloud-sdk/install.sh --help

   Opsional:
   • Untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI, jawab Y saat diminta.
   • Untuk menambahkan gcloud CLI ke PATH dan mengaktifkan pelengkapan perintah, jawab Y saat diminta.
5. Buka terminal baru agar perubahan diterapkan.
6. Untuk melakukan inisialisasi gcloud CLI, jalankan gcloud init:

./google-cloud-sdk/bin/gcloud init

7. Opsional: Instal komponen tambahan menggunakan pengelola komponen.

Debian/Ubuntu

Catatan: Bergantung pada penyiapan, Anda dapat memilih metode penginstalan lainnya:

• Jika Anda ingin gcloud dan gsutil diupdate secara otomatis ke versi terbaru dan menjalankan rilis Ubuntu modern yang menggunakan Pengelola Paket Snap, Anda dapat menginstal Google Cloud CLI sebagai paket snap.
• Jika Anda menggunakan instance di Compute Engine, gcloud CLI akan diinstal secara default pada sejumlah OS image. Lihat detail OS untuk mengetahui daftar lengkapnya.

Isi paket

Gcloud CLI tersedia dalam format paket untuk diinstal di sistem Debian dan Ubuntu. Paket ini hanya berisi perintah 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 Anda 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 masa pakai
• Baru-baru ini, paket-paketnya telah diperbarui:

  sudo apt-get update

• Library ini telah menginstal apt-transport-https dan curl:

  sudo apt-get install apt-transport-https ca-certificates gnupg curl

Penginstalan

1. Impor kunci publik Google Cloud.

   • 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 bertanda tangan, 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

   Catatan: Pastikan Anda tidak memiliki entri duplikat untuk repositori cloud-sdk di /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 utama 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 | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -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
   • 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, komponen google-cloud-cli-app-engine-java dapat diinstal sebagai berikut:

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

5. Jalankan gcloud init untuk memulai:

   gcloud init

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.

CATATAN: Untuk rilis sebelum 371.0.0, nama paketnya adalah google-cloud-sdk

Red Hat/Fedora/CentOS

Catatan: Jika Anda menggunakan instance di Compute Engine, Google Cloud CLI diinstal secara default pada sejumlah OS image. Lihat detail OS untuk mengetahui daftar lengkapnya.

Isi paket

Gcloud CLI tersedia dalam format paket untuk penginstalan pada sistem Red Hat Enterprise Linux 7, 8, dan 9; Fedora 33 dan 34; 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. Memperbarui DNF dengan informasi repositori gcloud CLI. Contoh perintah berikut ditujukan untuk penginstalan yang kompatibel dengan Red Hat Enterprise Linux 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

2. Jika Anda menginstal di Fedora 34 atau 35, instal libxcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. Instal gcloud CLI:

   sudo dnf install google-cloud-cli

Catatan: Jika belum berpindah ke dnf di sistem, Anda dapat menjalankan perintah ini menggunakan yum sebagai gantinya.

Anda juga dapat menggunakan opsi dnf/yum, seperti menonaktifkan dialog atau uji coba, dengan perintah yang disediakan.

4. (Opsional) Instal salah satu komponen tambahan berikut:
   • google-cloud-cli
   • 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, komponen google-cloud-cli-app-engine-java dapat diinstal sebagai berikut:

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

5. Jalankan gcloud init untuk memulai:

   gcloud init

Mendowngrade versi gcloud CLI

Jika Anda ingin kembali ke versi gcloud CLI tertentu, dengan VERSION dalam bentuk 123.0.0, jalankan: sudo dnf downgrade google-cloud-cli-VERSION Sepuluh rilis terbaru akan selalu tersedia di repositori. CATATAN: Untuk rilis sebelum 371.0.0, nama paketnya adalah google-cloud-sdk

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.8 hingga 3.12.
   • Skrip penginstalan utama menawarkan untuk menginstal Python 3.11.
   • Jika tidak, untuk menginstal versi Python yang didukung, kunjungi Python Releases for macOS Python.org.
   • Jika ada beberapa penafsir Python yang terinstal di komputer Anda, setel variabel lingkungan CLOUDSDK_PYTHON dalam shell agar 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:
   Catatan: Untuk menentukan nama hardware mesin, jalankan uname -m dari command line.

Platform	Paket	Ukuran	SHA256 Checksum
macOS 64-bit (x86_64)	google-cloud-cli-472.0.0-darwin-x86_64.tar.gz	124,8 MB	cc9d313ed286aae4f4a28b57897bde46199122295cd44109461b2ab0ecc94d59
macOS 64-bit (ARM64, Apple M1 silicon)	google-cloud-cli-472.0.0-darwin-arm.tar.gz	121,9 MB	bd13287a300d4e2c220a49be56008ae67147ab2b263eb61806d80016762bb583
macOS 32-bit (x86)	google-cloud-cli-472.0.0-darwin-x86.tar.gz	123,5 MB	5ca87cb1a9fff1ccb9da488451e6bd50d2eb295db3fc6d4aa5d39d3f41d8b0ff

1. Ekstrak arsip ke lokasi mana pun pada sistem file Anda (sebaiknya direktori Home). Di macOS, hal ini dapat dilakukan dengan membuka file arsip .tar.gz yang didownload di lokasi yang diinginkan.

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

2. (Opsional) Gunakan skrip penginstalan untuk menambahkan alat gcloud CLI ke PATH.Anda juga dapat memilih untuk mengaktifkan pelengkapan perintah untuk shell, kumpulan statistik penggunaan, dan menginstal Python 3.11.

   Jalankan skrip (dari root folder yang Anda ekstrak pada langkah terakhir) menggunakan perintah ini:

   ./google-cloud-sdk/install.sh

   Hal ini juga dapat dilakukan secara noninteraktif (misalnya, menggunakan skrip) dengan memberikan preferensi sebagai tanda. 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

   Buka terminal baru agar perubahan diterapkan.
3. Untuk melakukan inisialisasi gcloud CLI, jalankan gcloud init:

./google-cloud-sdk/bin/gcloud init

4. Opsional. Instal komponen tambahan menggunakan pengelola komponen.

Windows

Google Cloud CLI berfungsi 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://dl.google.com/dl/cloudsdk/channels/rapid/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.8 hingga 3.12. 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, daripada 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 noninteraktif versi gcloud CLI tertentu.
• Perlu menjalankan gcloud CLI sebagai image Docker? Gunakan image Docker gcloud CLI untuk rilis terbaru (atau versi tertentu) dari gcloud CLI.
• Menjalankan Ubuntu dan lebih memilih update otomatis? Gunakan paket snap untuk menginstal gcloud CLI.
• Untuk penginstalan interaktif Windows dan macOS, dan semua kasus penggunaan lainnya, jalankan penginstal interaktif untuk menginstal rilis terbaru gcloud CLI.

Mengelola penginstalan

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

Catatan: Jika menggunakan apt-get atau yum untuk menginstal gcloud CLI, Anda harus menggunakan apt-get atau yum untuk mengupdate atau menghapus komponen, bukan gcloud components.

Versi gcloud CLI sebelumnya

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

Versi Python yang didukung

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

Cobalah sendiri

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

Mulai secara gratis