Menggunakan gdcloud CLI

gdcloud CLI adalah serangkaian alat untuk membuat dan mengelola resource Google Distributed Cloud (GDC) yang terisolasi. Gunakan alat ini untuk melakukan tugas umum dari command line atau melalui skrip dan otomatisasi. gdcloud CLI memungkinkan Anda melakukan bootstrap infrastruktur, mengelola autentikasi, dan menyesuaikan konfigurasi lokal.

Dokumen ini ditujukan untuk semua grup audiens yang perlu menyiapkan CLI khusus GDC untuk mengelola alur kerja hardware dan software yang terisolasi. Untuk mengetahui informasi selengkapnya, lihat Audiens untuk dokumentasi GDC dengan air gap.

Sebelum memulai

  • Pastikan Anda memiliki akses ke konsol GDC dan catat URL organisasi Anda. Untuk mengetahui informasi selengkapnya, lihat Akses konsol GDC.

  • Pastikan Anda memiliki sertifikat Certificate Authority (CA) yang diinstal di penyimpanan sertifikat tepercaya sistem Anda. Untuk mengetahui informasi selengkapnya, lihat Mengambil paket kepercayaan GDC.

  • Pastikan Anda memiliki kebijakan jaringan organisasi yang mengizinkan traffic dari CIDR tertentu di luar organisasi Anda ke registry artefak. Misalnya, konfigurasi nama layanan all di resource OrganizationNetworkPolicy. Untuk mengetahui informasi selengkapnya, lihat Membuat kebijakan jaringan organisasi.

  • Pastikan Anda telah menginstal browser di perangkat Anda.

Menyiapkan gdcloud CLI

Untuk menyiapkan gdcloud CLI, selesaikan langkah-langkah berikut:

  1. Buka konsol GDC dengan memasukkan URL global atau zona organisasi Anda di browser Anda.

  2. Dari halaman beranda, pilih Download CLI Bundle.

  3. Pilih platform Linux dan versi paket gdcloud CLI yang sesuai dengan lingkungan GDC Anda.

    Saat memilih platform non-Linux, langkah-langkah konfigurasi mungkin sedikit berbeda. Perlu diketahui juga bahwa beberapa paket gdcloud CLI non-Linux hanya menyediakan subset perintah gdcloud. Untuk mengetahui informasi selengkapnya, lihat Paket gdcloud CLI yang tersedia.

  4. Klik Download.

  5. Dari perangkat Anda, buka folder Downloads:

    cd ~/Downloads

  6. Ekstrak konten paket gdcloud CLI:

    tar -xf ./gdcloud_cli.tar.gz

  7. Tambahkan paket gdcloud CLI ke jalur Anda:

    eval echo 'export GDCLOUD_PATH=$(pwd)/google-distributed-cloud-hosted-cli' >> ~/.bashrc
echo 'export PATH="$GDCLOUD_PATH/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

  8. Pastikan gdcloud CLI terinstal dengan benar:

    gdcloud version

    Outputnya mirip dengan hal berikut ini:

    gdcloud version: 1.15.0-gdch.380608

  9. Lakukan inisialisasi gdcloud CLI:

    gdcloud init

  10. Berikan dua properti yang diminta untuk menyelesaikan inisialisasi:

    • organization_console_url: URL ke konsol organisasi GDC Anda saat ini. URL ini dapat berupa global atau zona. Misalnya, https://console.org-1.google.gdch.test/.

    • project: nama project GDC Anda. Jika Anda tidak memiliki project yang ada, gunakan default.

    Untuk memperbarui konfigurasi gdcloud CLI setelah inisialisasi, lihat Mengelola konfigurasi gdcloud CLI.

  11. Instal komponen gdcloud-k8s-auth-plugin:

    gdcloud components install gdcloud-k8s-auth-plugin

  12. Lakukan autentikasi dengan gdcloud CLI untuk login:

    gdcloud auth login

    Anda akan dialihkan ke browser untuk memilih identitas dan login.

  13. Pastikan penyiapan gdcloud CLI Anda terhubung ke lingkungan GDC Anda:

    gdcloud compute images list

    Outputnya mirip dengan hal berikut ini:

    METADATA.NAME               METADATA.NAMESPACE SPEC.OPERATINGSYSTEM.NAME SPEC.MINIMUMDISKSIZE
rocky-8-v20250809-gdch      vm-system          rocky-linux-8             12G
ubuntu-20.04-v20250809-gdch vm-system          ubuntu-2004               12G
ubuntu-22.04-v20250809-gdch vm-system          ubuntu-2204               12G
ubuntu-24.04-v20250809-gdch vm-system          ubuntu-2404               12G

Langkah berikutnya