Menginstal Google Cloud CLI

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.

Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Pembersihan.

Instal gcloud CLI versi 549.0.0

Linux

1. Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.9 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	203,0 MB	81320cc3042faadbff2875c8b55c6bdcf6ccd439599c6645c27a5a6f213b4736
   Linux 64 bit (Arm)	google-cloud-cli-linux-arm.tar.gz	57,9 MB	2fced601e0a494e6dcf6dbfb39130aefacabe541d5bcf0a5d53a8c44e71515e9
   Linux 32 bit (x86)	google-cloud-cli-linux-x86.tar.gz	57,9 MB	8fb22634022aa74d23e877279e034e56d4fed4b5883cbfc51b9dd7134a1b96f0

   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.9 hingga 3.14.

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

   Skrip penginstalan dapat menginstal Python untuk Anda jika diperlukan. Hal ini memerlukan Alat Command Line Xcode. Untuk menginstalnya, jalankan sudo xcode-select --install. Atau, Anda dapat menginstal versi Python yang didukung dari python.org.

   Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi penafsir Python, terutama jika Anda telah menginstal beberapa versi, 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	58,0 MB	9f4b289e4545d146410e87363489d11ce30c1326eae0930cd77c81a499336682
   macOS 64-bit (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	57,9 MB	20aa219e61d7ac2b4bf78f9080c0fcf2c0b79d48ce47b9833d4087a468d749d9
   macOS 32-bit (x86)	google-cloud-cli-darwin-x86.tar.gz	56,4 MB	979b7f6e4014d41222b8354495d4e89285021c1b69bf07f751aecdf929024422

   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 umumnya adalah mengekstraknya ke direktori beranda Anda.

   Di macOS, Anda dapat melakukannya dengan membuka file .tar.gz yang didownload di lokasi yang diinginkan. 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.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.

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 petunjuk 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. Lihat 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.

Pembersihan

Agar akun Cloud de Confiance Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

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.