Menggunakan gdcloud CLI

gdcloud CLI adalah serangkaian alat untuk membuat dan mengelola resource air-gapped Google Distributed Cloud (GDC). Gunakan alat ini untuk melakukan tugas umum dari command line atau melalui skrip dan otomatisasi. gdcloud CLI memungkinkan Anda melakukan bootstrapping 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 dari internet. Untuk mengetahui informasi selengkapnya, lihat Audiens untuk dokumentasi GDC yang terisolasi dari internet.

Sebelum memulai

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

  • Konfirmasi bahwa 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.

  2. Dari halaman beranda, pilih Download CLI Bundle.

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

    Saat memilih platform non-Linux, langkah-langkah konfigurasi mungkin sedikit berbeda. Perlu diperhatikan juga bahwa beberapa paket gdcloud CLI non-Linux hanya menyediakan subset perintah gdcloud. Untuk mengetahui informasi selengkapnya, lihat Paket gcloud 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 diinstal 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 zonal. Contoh, https://console.org-1.google.gdch.test/.

    • project: nama project GDC Anda. Jika Anda belum memiliki project, 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