Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

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

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.

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

Verify that billing is enabled for your Google Cloud project.

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

Verify that billing is enabled for your Google Cloud project.

Instal gcloud CLI versi 579.0.0

Linux

Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.10 hingga 3.14. Paket Linux x86_64 mencakup interpreter Python yang dibundel yang akan lebih disukai secara default. Untuk mengetahui informasi cara memilih dan mengonfigurasi penafsir Python Anda, lihat dokumentasi gcloud topic startup.

Download salah satu opsi berikut:

Catatan: Untuk menentukan platform Linux Anda, jalankan uname -a di command line.

Platform	Nama paket	Ukuran	SHA256 Checksum
Linux 64 bit (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	96,1 MB	bd0f7eab135cfe64ca28d4cf1c4af2b20da40c63966f05066a546de41775713e
Linux 64 bit (Arm)	google-cloud-cli-linux-arm.tar.gz	61,5 MB	1908a3c9feade59310532d555c02530301ed23f5eca524a6ef4bb6fe55396160
Linux 32 bit (x86)	google-cloud-cli-linux-x86.tar.gz	61,6 MB	6a19488ae14a8211b9d2f677f22cc219df0b51ecb1e2558501e136597d445d3f

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.

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.
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
```
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

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.
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
```
Catatan: Pastikan Anda tidak memiliki entri duplikat untuk repositori cloud-sdk di /etc/apt/sources.list.d/google-cloud-sdk.list.

Update dan instal gcloud CLI:

sudo apt-get update && sudo apt-get install google-cloud-cli

Catatan: Jika menginstal di mesin virtual, image container, atau runner CI/CD otomatis yang memiliki keterbatasan resource, Anda dapat mengekspor variabel lingkungan CLOUDSDK_SKIP_PY_COMPILATION=1 selama penginstalan untuk melewati kompilasi Python sisi host. Hal ini mengurangi waktu penginstalan paket dari beberapa menit menjadi beberapa detik:

sudo CLOUDSDK_SKIP_PY_COMPILATION=1 apt-get install google-cloud-cli

Menetapkan variabel ini akan melewati kompilasi byte saat penginstalan, sehingga menukar beberapa kecepatan penyiapan paket dengan sedikit overhead eksekusi perintah interaktif.

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

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

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.

Instal libxcrypt-compat.x86_64.

sudo dnf install libxcrypt-compat.x86_64

Instal gcloud CLI:
```
sudo dnf install google-cloud-cli
```
Catatan: Jika menginstal di mesin virtual, image container, atau runner CI/CD otomatis yang memiliki keterbatasan resource, Anda dapat mengekspor variabel lingkungan CLOUDSDK_SKIP_PY_COMPILATION=1 selama penginstalan untuk melewati kompilasi Python sisi host. Hal ini mengurangi waktu penginstalan paket dari beberapa menit menjadi beberapa detik:
```
sudo CLOUDSDK_SKIP_PY_COMPILATION=1 dnf install google-cloud-cli
```
Menetapkan variabel ini akan melewati kompilasi byte saat penginstalan, sehingga menukar beberapa kecepatan penyiapan paket dengan sedikit overhead eksekusi perintah interaktif.
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.
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