Menginstal dan mengonfigurasi CLI penyimpanan untuk project

Halaman ini memandu Anda cara menginstal dan mengonfigurasi gdcloud CLI untuk mengelola penyimpanan objek saat menggunakan project Google Distributed Cloud (GDC) dengan air gap. Lab ini membahas cara mendownload, menginstal, dan mengonfigurasi komponen dan setelan yang diperlukan untuk menggunakan bucket dan objek penyimpanan secara efektif di lingkungan yang terisolasi ini.

Halaman ini ditujukan untuk audiens seperti admin IT dalam grup operator infrastruktur atau developer dalam grup operator aplikasi yang ingin menyediakan dan mengelola bucket penyimpanan objek untuk project dalam lingkungan GDC dengan air gap. Untuk mengetahui informasi selengkapnya, lihat Audiens untuk dokumentasi GDC dengan air gap.

Sebelum memulai

Untuk menginstal dan mengonfigurasi CLI penyimpanan, hubungi Admin Org IAM Anda untuk meminta peran Org Network Policy Admin (org-network-policy-admin), yang memungkinkan Anda membuat, mengedit, dan menghapus kebijakan jaringan organisasi.

Mendownload gdcloud CLI

Ikuti petunjuk untuk mendownload gdcloud CLI.

Menginstal gdcloud CLI

Untuk menggunakan hierarki perintah penyimpanan, komponen dependensi penyimpanan harus diinstal.

  1. Ikuti Menginstal gdcloud CLI.

  2. Untuk menginstal komponen dependensi penyimpanan, jalankan perintah berikut:

    gdcloud components install storage-cli-dependencies

    Untuk mengetahui informasi selengkapnya tentang perintah components install, lihat Menginstal gdcloud CLI.

Mengonfigurasi gdcloud CLI untuk penyimpanan objek

Konfigurasi berikut harus ditetapkan untuk menggunakan gdcloud CLI untuk penyimpanan objek.

  1. Ganti ACCESS_KEY_ID dengan ID kunci akses yang diperoleh dari secret di bagian mendapatkan kredensial akses:

    gdcloud config set storage/s3_access_key_id ACCESS_KEY_ID

  2. Ganti SECRET_ACCESS_KEY dengan kunci rahasia yang diperoleh dari secret di bagian mendapatkan kredensial akses:

    gdcloud config set storage/s3_secret_access_key SECRET_ACCESS_KEY

  3. Ganti CA_BUNDLE_FILE dengan jalur ke Sertifikat CA. Sertifikat ini adalah sertifikat digital milik Certificate Authority (CA), organisasi tepercaya yang menjamin identitas. Anda dapat meminta paket kepercayaan CA GDC dari anggota grup operator infrastruktur (IO) Anda. Untuk mengetahui informasi selengkapnya tentang cara mendapatkan sertifikat CA GDC, lihat Mengambil paket kepercayaan GDC.

    gdcloud config set storage/s3_custom_ca_certs_file CA_BUNDLE_FILE

  4. Ganti ENDPOINT dengan endpoint yang disediakan oleh Infrastructure Operator (IO) Anda:

    gdcloud config set storage/s3_endpoint ENDPOINT

    Langkah ini sedikit berbeda untuk bucket dua zona. Setiap bucket dua zona menyediakan tiga endpoint yang dapat Anda pilih untuk mengakses bucket. Untuk sebagian besar situasi, endpoint global sesuai untuk memanfaatkan failover otomatis:

    • Endpoint zone1: Endpoint ini selalu diterima oleh zone1. Jika menggunakan endpoint ini, Anda memiliki konsistensi baca-setelah-tulis untuk objek apa pun yang ditulis ke zone1. Namun, jika zone1 tidak aktif, klien harus beralih menggunakan endpoint zone2 atau global untuk terus membaca/menulis ke bucket ini. Jika klien berasal dari cluster pengguna, endpoint ini hanya akan dapat diakses dari dalam zone1.
    • Endpoint zone2: Endpoint ini selalu diterima oleh zone2. Jika menggunakan endpoint ini, Anda memiliki konsistensi baca-setelah-tulis untuk objek apa pun yang ditulis ke zone2. Namun, jika zone2 tidak aktif, klien harus beralih menggunakan endpoint zone1 atau global untuk terus membaca/menulis ke bucket ini. Jika klien berasal dari cluster pengguna, endpoint ini hanya akan dapat diakses dari dalam zone2.
    • Endpoint global: Endpoint ini menyebabkan permintaan Anda dirutekan ke zone1 atau zone2. Opsi ini tidak menyediakan afinitas sesi, yang berarti permintaan yang dibuat menggunakan sesi yang sama dapat tiba di zona1 atau zona2. Artinya, tidak ada jaminan baca setelah tulis untuk permintaan yang dibuat ke endpoint global. Endpoint global menyediakan failover otomatis jika suatu zona tidak aktif, sehingga pengguna tidak perlu mengubah endpoint dalam workload mereka seperti yang harus mereka lakukan jika menggunakan endpoint zona. Selain itu, endpoint ini dapat diakses dari cluster pengguna di semua zona.

    Jalankan perintah berikut terhadap server API pengelolaan untuk melihat endpoint global dan zona untuk bucket Anda, lalu pilih endpoint yang ingin Anda gunakan:

    kubectl get buckets BUCKET_NAME -n PROJECT_NAME -o jsonpath="{.status.globalEndpoint}" --kubeconfig MANAGEMENT_API_SERVER

kubectl get buckets BUCKET_NAME -n PROJECT_NAME -o jsonpath="{.status.zonalEndpoints}" --kubeconfig MANAGEMENT_API_SERVER