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 inittidak 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.
- 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. - 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.gzyang berlaku untuk konfigurasi Anda. - Untuk mengekstrak konten file ke sistem file Anda, jalankan perintah berikut:
Untuk mengganti penginstalan yang ada, hapus direktoritar -xf google-cloud-cli-linux-x86_64.tar.gz
google-cloud-sdkyang ada, lalu ekstrak arsip ke lokasi yang sama. - Jalankan skrip penginstalan dari root folder yang Anda ekstrak:
Skrip akan meminta Anda untuk melakukan tindakan penyiapan berikut. Untuk menerima, jawab./google-cloud-sdk/install.sh
Ysaat diminta.- Tambahkan gcloud CLI ke
PATHAnda. - Aktifkan penyelesaian perintah.
- Ikut serta untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI.
./google-cloud-sdk/install.sh --help - Tambahkan gcloud CLI ke
- Opsional: Jika Anda memperbarui
PATHpada langkah sebelumnya, buka terminal baru agar perubahan diterapkan.
- Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.10 hingga 3.15.
Untuk memeriksa versi Python Anda, jalankan
python3 -Vataupython -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. -
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_NAMEdengan nama paket untuk platform Anda dari tabel di atas.curl -O https://storage.s3nsapis.fr/cloud-sdk-release/FILE_NAME
- 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.gzyang didownload di lokasi yang diinginkan. Atau, dari command line, jalankan:tar -xf FILE_NAME
Untuk mengganti penginstalan yang ada, hapus direktori
google-cloud-sdkyang ada, lalu ekstrak arsip ke lokasi yang sama. - Jalankan skrip penginstalan dari root folder yang Anda ekstrak:
Skrip akan meminta Anda untuk melakukan tindakan penyiapan berikut. Untuk menerima, jawab./google-cloud-sdk/install.sh
Ysaat diminta.- Instal Python 3.14 dan modul yang direkomendasikan jika diperlukan.
- Tambahkan gcloud CLI ke
PATHAnda dan aktifkan penyelesaian perintah. - Ikut serta untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI.
Untuk menjalankan skrip penginstalan dengan mode pembaca layar diaktifkan:./google-cloud-sdk/install.sh --help./google-cloud-sdk/install.sh --screen-reader=true
- Opsional: Jika Anda memperbarui
PATHpada langkah sebelumnya, buka terminal baru agar perubahan diterapkan.
Google Cloud CLI di Windows memerlukan Windows 8.1 dan yang lebih baru, atau Windows Server 2012 dan yang lebih baru.
-
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
-
Luncurkan penginstal dan ikuti petunjuknya. Penginstal ditandatangani oleh Google LLC.
- Jika Anda menggunakan pembaca layar, centang kotak Aktifkan mode pembaca layar. Opsi
ini mengonfigurasi
gclouduntuk 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 startupuntuk mempelajari cara menggunakan penginstalan Python yang sudah ada.
- Jika Anda menggunakan pembaca layar, centang kotak Aktifkan mode pembaca layar. Opsi
ini mengonfigurasi
- 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 inituntuk melakukan inisialisasi, mengizinkan, dan mengonfigurasi gcloud CLI. - 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
findtidak dikenali, pastikan variabel lingkunganPATHAnda ditetapkan untuk menyertakan folder yang berisifind. Biasanya, ini adalahC:\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.frJalankan 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.jsonJika 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:
Untuk menetapkan project default, jalankan perintah berikut, dengan menentukan project ID yang Anda pilih:
gcloud config set project PROJECT_IDJika 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-east1Untuk menetapkan zona default, jalankan perintah berikut:
gcloud config set compute/zone ZONEUntuk 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:
Tampilkan daftar akun yang kredensialnya disimpan di sistem lokal:
gcloud auth listGcloud CLI menampilkan daftar akun dengan kredensial:
Credentialed Accounts ACTIVE ACCOUNT * principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
Cantumkan properti dalam konfigurasi gcloud CLI aktif Anda:
gcloud config listgcloud 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
Melihat informasi tentang perintah
gclouddan topik lainnya:gcloud helpMisalnya, untuk melihat bantuan untuk
gcloud compute instances create:gcloud help compute instances creategcloud CLI menampilkan topik bantuan yang berisi deskripsi perintah, daftar flag dan argumen perintah, serta contoh cara menggunakan perintah.
Langkah berikutnya
- Jika Anda adalah administrator yang menyiapkan organisasi Cloud de Confiance untuk pertama kalinya, cari tahu cara mengonfigurasi organisasi Anda di Menyiapkan organisasi.
- Untuk mengetahui lebih lanjut hal yang dapat Anda lakukan dengan Google Cloud CLI, lihat dokumentasi Google Cloud CLI
- Untuk mengetahui informasi selengkapnya tentang cara mulai menggunakan Cloud de Confiance, lihat Mulai menggunakan Cloud de Confiance.