Panduan memulai: Menginstal Google Cloud CLI (original) (raw)

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

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

Pandu saya

Sebelum memulai

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
    Go to project selector
  3. Make sure 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.
    Go to project selector
  5. Make sure that billing is enabled for your Google Cloud project.

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

Menginstal gcloud CLI versi terbaru (520.0.0)

Linux

  1. Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.8 hingga 3.13. Perhatikan bahwa paket Linux x86_64 menyertakan penafsir Python yang dipaketkan yang akan dipilih secara default. Untuk mengetahui informasi cara memilih dan mengonfigurasi penafsir Python Anda, lihatgcloud 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 148,5 MB f74150eefbf97a1f5b8a521525df90595676408ea4b293d3ca3b19ac2173c6b0
    Linux 64 bit (Arm) google-cloud-cli-linux-arm.tar.gz 55,2 MB 19a697bc202435d8cece93653c19fb7c11d420d317d2c27936b4bdd074f7762a
    Linux 32 bit (x86) google-cloud-cli-linux-x86.tar.gz 55,2 MB b872fea3ad2ccf0bc0c255426cf6fe0f28887c951a621827fb8a0f8e3fa7c838
    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 (sebaiknya ke direktori utama Anda), jalankan perintah berikut:
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
    Opsional: Untuk mengganti penginstalan yang ada, hapus direktorigoogle-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:

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

  1. Opsional: Instal komponen tambahan menggunakanpengelola komponen.

Debian/Ubuntu

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 harusmenginstalnya secara terpisah.

Sebelum memulai

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

  1. Impor Google Cloud kunci publik.
  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:

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

Isi paket

Gcloud CLI tersedia dalam format paket untuk diinstal di 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. Mengupdate 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
  4. (Opsional) Instal salah satukomponen 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, dan VERSION adalah bentuk123.0.0, jalankan:sudo dnf downgrade google-cloud-cli-VERSIONSepuluh 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.13.
    • Skrip penginstalan utama menawarkan penginstalan Python 3.12 CPython.
    • Jika tidak, untuk menginstal versi Python yang didukung, buka Rilis Python untuk macOS di Python.org.
    • Jika Anda menginstal beberapa penafsir Python di komputer, tetapkan variabel lingkungan CLOUDSDK_PYTHON dalam shell untuk mengarah ke jalur penafsir pilihan Anda.
    • Untuk mengetahui informasi selengkapnya tentang cara memilih dan mengonfigurasi penafsir Python Anda, lihatgcloud 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 55,3 MB 3bb221362f40271d79bed23bb5d20d6dc05698e3b37d55fb3147a00a4a7f13f7
macOS 64-bit(ARM64, Apple silicon) google-cloud-cli-darwin-arm.tar.gz 55,2 MB c8777fc2598ebc5bc0d83dc460b28917f011c762aee04b96b8d387d260424e08
macOS 32-bit(x86) google-cloud-cli-darwin-x86.tar.gz 53,8 MB b003bd25c802a5a878342376403f67de8d20c770fe2c08a8da758bedb2b15051
  1. 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.
    Untuk mengganti penginstalan yang ada, hapus direktorigoogle-cloud-sdk yang ada, lalu ekstrak arsip ke lokasi yang sama.
  2. 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.
  3. Jika Anda memperbarui PATH di langkah sebelumnya, buka terminal baru agar perubahan diterapkan.
  4. Untuk melakukan inisialisasi gcloud CLI, jalankan gcloud init:

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

  1. Opsional. Instal komponen tambahan menggunakanpengelola 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://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, lihatPanduan fitur aksesibilitas.
  3. Google Cloud CLI memerlukan Python; versi yang didukung adalah Python 3.8 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:

Chromebook

  1. Aktifkan fitur Linux di Chromebook Anda. Menginstal Google Cloud CLI di Chromebook memerlukan fitur ini.
  2. Tambahkan URI distribusi gcloud CLI sebagai sumber paket:
    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
  3. Impor Google Cloud kunci publik:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
  4. Update dan instal gcloud CLI:
    sudo apt-get update && sudo apt-get install google-cloud-cli
  5. (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
  6. 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

Opsional: Instal Library Klien Cloud terbaru

Anda dapat mendownload Library Klien Cloud untuk bahasa yang didukung.

Melakukan inisialisasi gcloud CLI

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

  1. Lakukan inisialisasi gcloud CLI:
gcloud init
  1. Terima opsi untuk login menggunakan akun pengguna Google Anda:
    To continue, you must log in. Would you like to log in (Y/n)? Y
  2. Di browser, login ke akun pengguna Google Anda saat diminta, lalu klikIzinkan untuk memberikan izin guna mengakses Google Cloud resource.
  3. Di command prompt, pilih project Google Cloud dari daftar project tempat Anda memiliki izin Pemilik, Editor, atau Pelihat:
    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 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:
  4. 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:
  1. (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. Cantumkan akun yang kredensialnya disimpan di sistem lokal:
gcloud auth list

gcloud CLI menampilkan daftar akun yang memiliki kredensial:
Credentialed Accounts
ACTIVE ACCOUNT

  1. Cantumkan 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. Lihat 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. Lihat informasi tentang perintah gcloud dan topik lainnya: 

gcloud help

Misalnya, untuk melihat bantuan 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 Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan di halaman ini, ikuti langkah-langkah berikut.

  1. In the Google 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 clickShut down to delete the project.

Langkah berikutnya