Menyiapkan Google Cloud CLI untuk Cloud de Confiance

Panduan ini memberikan petunjuk untuk menyiapkan Google Cloud CLI (gcloud CLI) agar dapat digunakan denganCloud de Confiance. gcloud CLI membantu Anda membuat dan menggunakan resource Cloud de Confiancedari command line.

Untuk mengetahui informasi umum selengkapnya tentang cara mengonfigurasi dan menggunakan gcloud CLI, lihat dokumentasi Google Cloud CLI.

Perbedaan dengan penyiapan di Google Cloud

Jika Anda sudah terbiasa menyiapkan dan menggunakan CLI dengan Google Cloud, perhatikan hal berikut:

  • Ada beberapa penyiapan awal tambahan yang diperlukan untuk menggunakan gcloud CLI dengan Cloud de Confiance, seperti yang dijelaskan dalam panduan ini.
  • Cloud Shell tidak tersedia di Cloud de Confiance. gcloud CLI harus diinstal di komputer lokal Anda.
  • Melakukan inisialisasi gcloud CLI dalam satu langkah dengan gcloud init tidak tersedia.
  • Jika fitur atau produk tidak tersedia di Cloud de Confiance, perintah dan parameter gcloud CLI yang sesuai juga tidak tersedia.

Sebelum memulai

Selain detail login Anda sendiri untuk Cloud de Confiance, Anda memerlukan hal berikut untuk menyiapkan gcloud CLI untuk pertama kalinya. Jika Anda bukan administrator untuk organisasi, administrator Anda harus memberikan informasi ini kepada Anda.

  • Nama workload identity pool organisasi Anda.
  • Penyedia identitas (IdP) organisasi Anda.

Menginstal gcloud CLI

Instal gcloud CLI, dengan mengikuti petunjuk untuk OS Anda.

Linux
  1. Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.10 hingga 3.15. Paket Linux x86_64 dan Arm 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 94,7 MB 181a74765ab1f2d3dd37bc1b7f9b53b6f5b348eef44ea2e194b9ed41310b44bb
    Linux 64 bit

    (Arm)

    google-cloud-cli-linux-arm.tar.gz 90,7 MB 13e40f07f44bb6380a8d17275e352964360543af8ea18a7ddfee0445481f9413
    Linux 32 bit

    (x86)

    google-cloud-cli-linux-x86.tar.gz 54,8 MB 476eef9d8f890795c246b6c567e7623e3c404c0c824d2e3be6f6be81d08bfe74

    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 untuk melakukan tindakan penyiapan berikut. Untuk menerima, jawab Y saat diminta.
    • Tambahkan gcloud CLI ke PATH Anda.
    • Aktifkan penyelesaian perintah.
    • Ikut serta untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI.
    Anda juga dapat melakukan penginstalan secara non-interaktif dengan memberikan flag. 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.10 hingga 3.15.

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

    Penginstal gcloud akan menginstal Python v3.14 dan modul ekstensi yang diperlukan secara default.

    Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi penafsir Python, 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 54,9 MB 108c1a0bb5d273703b61c4dc9cafab9cc0e674797347ab18d5357d228a517131
    macOS 64-bit

    (ARM64, Apple silicon)

    google-cloud-cli-darwin-arm.tar.gz 54,8 MB 563b2102362a54506836b73ef3485b6abfe112c1e48559022bbb5dbf45f55e4e
    macOS 32-bit

    (x86)

    google-cloud-cli-darwin-x86.tar.gz 53,2 MB 35d83632d1b2fc48fe342c957a3105995d5f855c2d770b37de277178f0cfe2d8

    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. Praktik yang umum adalah mengekstraknya ke direktori utama 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 untuk melakukan tindakan penyiapan berikut. Untuk menerima, jawab Y saat diminta.
    • Instal Python 3.14 dan modul yang direkomendasikan jika diperlukan.
    • Tambahkan gcloud CLI ke PATH Anda dan aktifkan penyelesaian perintah.
    • Ikut serta untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI.
    Anda juga dapat melakukan penginstalan secara non-interaktif dengan memberikan flag. 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.10 hingga 3.15. 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 Menu Mulai dan pintasan Desktop, memulai shell Google Cloud CLI, dan mengonfigurasi gcloud CLI. Biarkan opsi untuk memulai shell dan mengonfigurasi penginstalan telah dipilih. Penginstal memulai jendela terminal dan menjalankan perintah gcloud init untuk melakukan inisialisasi, mengizinkan, dan mengonfigurasi gcloud CLI.
  4. 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) Membuat konfigurasi khusus universe

Jika Anda perlu menggunakan penginstalan gcloud CLI dengan beberapa universe (misalnya, dengan Google Cloud danCloud de Confiance), Anda dapat membuat konfigurasi gcloud CLI tertentu untuk setelanCloud de Confiance .

Untuk membuat dan beralih ke konfigurasi baru, jalankan perintah berikut:

gcloud config configurations create CONFIG_NAME
gcloud config configurations activate CONFIG_NAME

Ganti kode berikut:

  • CONFIG_NAME: nama unik yang Anda pilih untuk konfigurasi Anda.

Jika Anda tidak membuat konfigurasi khusus universe, langkah-langkah selanjutnya akan menggunakan konfigurasi gcloud CLI default (bernama default).

Membuat file konfigurasi login Anda

Untuk menyiapkan akses ke universe, Anda perlu membuat file konfigurasi JSON untuk gcloud CLI, termasuk domain yang digunakan oleh Cloud de Confiance dan IdP yang disiapkan untuk organisasi Anda.

Untuk membuat file konfigurasi login:

  • Tetapkan domain universe untuk gcloud CLI dalam konfigurasi aktif Anda:

    gcloud config set universe_domain s3nsapis.fr
    
  • Jalankan perintah berikut:

    AUDIENCE=locations/global/workforcePools/POOL_ID/providers/PROVIDER_ID
    UNIVERSE_WEB_DOMAIN="cloud.s3nscloud.fr"
    UNIVERSE_API_DOMAIN="s3nsapis.fr"
    
    gcloud iam workforce-pools create-login-config \
    $AUDIENCE \
    --universe-cloud-web-domain="$UNIVERSE_WEB_DOMAIN" \
    --universe-domain="$UNIVERSE_API_DOMAIN" \
    --output-file="wif-login-config.json"
    

    Ganti kode berikut:

    • POOL_ID: ID unik untuk workload identity pool organisasi Anda.
    • PROVIDER_ID: penyedia identitas (IdP) organisasi Anda.

Outputnya mirip dengan hal berikut ini:

Created login configuration file [wif-login-config.json].

Setelah membuat file konfigurasi, Anda tidak perlu mengulangi langkah ini selama Anda login dari komputer yang sama.

Login ke Cloud de Confiance dengan gcloud CLI

Sekarang Anda dapat menggunakan file konfigurasi setiap kali perlu login ke Cloud de Confiance:

  • Untuk login dari command line, jalankan perintah berikut:

    gcloud auth login --login-config=wif-login-config.json
    
  • Jika Anda perlu menggunakan Kredensial Default Aplikasi (ADC) (diperlukan untuk menjalankan modul Terraform), jalankan perintah berikut:

    gcloud auth application-default login --login-config=wif-login-config.json
    

Halaman web akan terbuka dan Anda dapat login dengan detail login Anda. Setelah login, Anda dapat melanjutkan untuk mengonfigurasi dan menggunakan gcloud CLI seperti yang dijelaskan dalam dokumentasi lainnya.

(Opsional) Menyiapkan properti default

Saat menyiapkan gcloud CLI, Anda akan diberi konfigurasi bernama default yang dapat digunakan untuk properti yang memberikan nilai flag default atau mengatur perilaku alat. Meskipun bersifat opsional, sebaiknya konfigurasikan beberapa properti default untuk gcloud CLI, seperti project default Anda, sebelum menggunakan alat ini. Properti default berguna jika Anda tidak ingin menentukan project atau lokasi komputasi pilihan setiap kali menjalankan perintah.

Langkah-langkah berikut menetapkan properti yang sama dengan yang dikonfigurasi oleh gcloud init untuk pengguna Google Cloud:

  1. Untuk menetapkan project default, jalankan perintah berikut, dengan menentukan project ID yang Anda pilih:

    gcloud config set project PROJECT_ID
    
  2. Jika Anda menggunakan Compute Engine atau GKE, beberapa perintah mengharuskan Anda menentukan region atau zona komputasi. Untuk menetapkan region default untuk perintah, jalankan perintah berikut:

    gcloud config set compute/region u-france-east1
    

    Untuk menetapkan zona default, jalankan perintah berikut:

    gcloud config set compute/zone ZONE
    
  3. Untuk melihat properti konfigurasi saat ini, termasuk pengguna yang diautentikasi, jalankan perintah berikut:

    gcloud config list
    

Anda dapat mempelajari cara kerja konfigurasi gcloud CLI serta cara membuat dan menggunakan konfigurasi tambahan di Mengelola konfigurasi gcloud CLI. Anda dapat mempelajari lebih lanjut cara menentukan properti di Mengelola properti gcloud CLI.

(Opsional) Menjalankan perintah

Jalankan perintah inti untuk melihat informasi tentang penginstalan gcloud CLI Anda:

  1. Tampilkan daftar akun yang kredensialnya disimpan di sistem lokal:

    gcloud auth list
    

    Gcloud CLI menampilkan daftar akun dengan kredensial:

    Credentialed Accounts
    ACTIVE             ACCOUNT
    *                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
    

  2. Cantumkan 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. 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.

Langkah berikutnya