Menginstal Google Cloud CLI.

Panduan memulai ini memandu Anda dalam menginstal dan melakukan inisialisasi Google Cloud CLI serta menjalankan beberapa perintah gcloud CLI inti.

Anda harus membaca artikel Menyiapkan Google Cloud CLI untuk Trusted Cloud sebelum mengikuti petunjuk apa pun dalam panduan ini.

Sebelum memulai

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

    Go to project selector

  2. Verify that billing is enabled for your Trusted Cloud project.

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

    Menginstal gcloud CLI versi terbaru (534.0.0)

    Linux
    1. Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.9 hingga 3.13. Perhatikan, 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 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 149,9 MB bd84779b7cc2eb353213e70c926e85d908f956e0cbb7cf2ced67d130f6dfe9a1
      Linux 64 bit

      (Arm)

      		 google-cloud-cli-linux-arm.tar.gz 56,5 MB b2657d5cbb819ac94c9a0465a8e3e99c433ac004cea23d189a264048653ad45e
      Linux 32 bit

      (x86)

      		 google-cloud-cli-linux-x86.tar.gz 56,5 MB c7ef2ec44da3f0aa38e06de072eddbaa368ee947c3fdb66aa2aca7b126c62e88

      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 (sebaiknya ke direktori home Anda), jalankan perintah berikut: 
      tar -xf google-cloud-cli-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. (Opsional) Tambahkan gcloud CLI ke PATH Anda. Anda juga dapat memilih untuk melakukan pelengkapan perintah untuk shell dan pengumpulan statistik penggunaan. Jalankan skrip penginstalan (dari root folder yang Anda ekstrak pada langkah terakhir) menggunakan perintah berikut: 
      ./google-cloud-sdk/install.sh
       Hal ini juga dapat dilakukan secara noninteraktif (misalnya, menggunakan skrip) dan dengan memberikan preferensi sebagai flag. Untuk melihat flag yang tersedia, jalankan: 
      ./google-cloud-sdk/install.sh --help
      • Untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI, jawab Y saat diminta.
      • Untuk menambahkan gcloud CLI ke PATH dan mengaktifkan penyelesaian perintah, jawab Y saat diminta.
    5. Jika Anda memperbarui PATH di langkah sebelumnya, buka terminal baru agar perubahan diterapkan.
    6. Untuk melakukan inisialisasi gcloud CLI, jalankan gcloud init: 
      7. ./google-cloud-sdk/bin/gcloud init
    7. Opsional: Instal komponen tambahan menggunakan pengelola komponen.
    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.9 hingga 3.13.
      • Skrip penginstalan utama menawarkan penginstalan Python 3.12 CPython.
        • Alat Command Line Xcode diperlukan untuk menginstal Python.
        • Pastikan Alat Command Line Xcode sudah diinstal dengan menjalankan: xcode-select -p.
        • Jika Alat Command Line Xcode tidak diinstal, instal dengan menjalankan: sudo xcode-select --install.
      • Atau, untuk menginstal versi Python yang didukung, buka Rilis Python untuk macOS di Python.org.
      • Jika Anda telah menginstal beberapa penafsir Python di komputer, tetapkan variabel lingkungan CLOUDSDK_PYTHON dalam shell Anda untuk 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:

      3. Platform Paket Ukuran SHA256 Checksum
      macOS 64-bit

      (x86_64)

      		 google-cloud-cli-darwin-x86_64.tar.gz 56,6 MB 547c278754fab51a46615f853fa1909d37773b2fa177387a92541fc14e96a87e
      macOS 64-bit

      (ARM64, Apple silicon)

      		 google-cloud-cli-darwin-arm.tar.gz 56,5 MB 849634e8c95a1507862431c4773cd5312080fd0fa601c00699f2476a4437dfea
      macOS 32-bit

      (x86)

      		 google-cloud-cli-darwin-x86.tar.gz 55,1 MB 7fa38469c7ac8c5b1c9cad40f9fb7adbcd85dab689d32df16785879476ddb6af
    3. Ekstrak arsip ke lokasi mana pun pada sistem file Anda (sebaiknya direktori Home Anda). Di macOS, hal ini dapat dilakukan dengan membuka file arsip .tar.gz yang didownload di lokasi yang diinginkan. Atau jalankan perintah berikut: 
      tar -xf google-cloud-cli-darwin-arm.tar.gz

      Opsional: 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 pada langkah terakhir) menggunakan perintah berikut: 
      ./google-cloud-sdk/install.sh

      Skrip akan meminta untuk menginstal Python 3.12 dan modul tertentu yang direkomendasikan.

      Penginstalan juga dapat dilakukan secara noninteraktif (misalnya, menggunakan skrip) dengan memberikan preferensi sebagai flag. 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
       Opsional:
      • Untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI, jawab Y saat diminta.
      • Untuk menambahkan gcloud CLI ke PATH dan mengaktifkan penyelesaian perintah, jawab Y saat diminta.
    5. Jika Anda memperbarui PATH di langkah sebelumnya, buka terminal baru agar perubahan diterapkan.
    6. Untuk melakukan inisialisasi gcloud CLI, jalankan gcloud init: 
      7. ./google-cloud-sdk/bin/gcloud init
    7. Opsional. Instal komponen tambahan menggunakan pengelola komponen.
    Windows
      Google Cloud CLI dapat digunakan 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://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.

    3. Google Cloud CLI memerlukan Python; versi yang didukung adalah Python 3.9 hingga 3.13. 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.

    Opsional: Instal Library Klien Cloud terbaru

    Anda dapat mendownload Library Klien Cloud untuk bahasa yang didukung.

    Menginisialisasi gcloud CLI

    Gunakan perintah gcloud init untuk melakukan beberapa tugas penyiapan gcloud CLI umum. Hal ini mencakup memberikan otorisasi pada gcloud CLI untuk mengakses Trusted Cloud menggunakan kredensial akun pengguna Anda dan menyiapkan konfigurasi default.

    1. Lakukan inisialisasi gcloud CLI:

      gcloud init

    2. Terima opsi untuk login menggunakan akun pengguna Google Anda:

      To continue, you must log in. Would you like to log in (Y/n)? Y

    3. Di browser, login ke akun pengguna Google Anda saat diminta dan klik Izinkan untuk memberikan izin akses ke resource Trusted Cloud .

    4. Di command prompt, pilih project dari daftar project tempat Anda memiliki izin Pemilik, Editor, atau Pelihat: Trusted Cloud 

      Pick cloud project to use:
 [1] [my-project-1]
 [2] [my-project-2]
 ...
 Please enter your numeric choice:

      Jika Anda hanya memiliki satu project, gcloud init akan memilihnya untuk Anda.

      Jika Anda memiliki akses ke lebih dari 200 project, Anda akan diminta untuk memasukkan project ID, membuat project baru, atau mencantumkan project.

      This account has a lot of projects! Listing them all can take a while.
 [1] Enter a project ID
 [2] Create a new project
 [3] List projects
Please enter your numeric choice:

    5. Jika Anda telah mengaktifkan Compute Engine API, gcloud init memungkinkan Anda memilih zona Compute Engine default:

      Which compute zone would you like to use as project default?
 [1] [asia-east1-a]
 [2] [asia-east1-b]
 ...
 [14] Do not use default zone
 Please enter your numeric choice:

      gcloud init mengonfirmasi bahwa Anda telah berhasil menyelesaikan langkah-langkah penyiapan:

      Run `gcloud help config` to learn how to change individual settings

This gcloud configuration is called [default]. You can create additional configurations if you work with multiple accounts and/or projects.
Run `gcloud topic configurations` to learn more.

Some things to try next:

* Run `gcloud --help` to see the Cloud Platform services you can interact with. And run `gcloud help COMMAND` to get help on any gcloud command.
* Run `gcloud topic --help` to learn about advanced features of the SDK like arg files and output formatting
* Run `gcloud cheat-sheet` to see a roster of go-to `gcloud` commands.

    6. (Opsional) Untuk meningkatkan pengalaman pembaca layar, aktifkan properti accessibility/screen_reader:

      gcloud config set accessibility/screen_reader true

      Untuk mengetahui detail selengkapnya tentang fitur aksesibilitas yang disertakan dengan gcloud CLI, 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
*                  example-user-1@gmail.com
                   example-user-2@gmail.com

    2. Mencantumkan properti dalam konfigurasi gcloud CLI aktif Anda:

      gcloud config list

      gcloud CLI menampilkan daftar properti:

      [core]
account = example-user-1@gmail.com
disable_usage_reporting = False
project = example-project

    3. Melihat informasi tentang penginstalan gcloud CLI dan konfigurasi aktif:

      gcloud info

      gcloud CLI menampilkan ringkasan informasi tentang penginstalan Anda. Hal ini mencakup informasi tentang sistem Anda, komponen yang diinstal, akun pengguna aktif dan project saat ini, serta properti dalam konfigurasi aktif.

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

    Pembersihan

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

    1. In the Trusted Cloud console, go to the Manage resources page.

      Go to Manage resources

    2. In the project list, select the project that you want to delete, and then click Delete.
    3. In the dialog, type the project ID, and then click Shut down to delete the project.

    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 Trusted Cloud.
    • Lihat lembar contekan gcloud CLI untuk mengetahui daftar perintah yang umum digunakan dan konsep utama.
    • Instal komponen tambahan seperti emulator App Engine atau kubectl menggunakan pengelola komponen gcloud CLI.