Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Menginstal dan mengonfigurasi CLI penyimpanan

Halaman ini memandu Anda cara menginstal dan mengonfigurasi gdcloud CLI untuk mengelola penyimpanan objek saat menggunakan project Google Distributed Cloud (GDC) yang terisolasi. Halaman 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.

Mendownload gdcloud CLI

Ikuti petunjuk untuk mendownload gdcloud CLI.

Menginstal gdcloud CLI

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

Ikuti Menginstal gdcloud CLI.
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.

Ganti ACCESS_KEY_ID dengan ID kunci akses yang diperoleh dari kunci rahasia dalam mendapatkan kredensial akses:
```
gdcloud config set storage/s3_access_key_id ACCESS_KEY_ID
```
Ganti SECRET_ACCESS_KEY dengan kunci rahasia yang diperoleh dari kunci rahasia dalam mendapatkan kredensial akses:
```
gdcloud config set storage/s3_secret_access_key SECRET_ACCESS_KEY
```
Ganti CA_BUNDLE_FILE dengan jalur ke Sertifikat CA. Ini adalah sertifikat digital yang dimiliki Certificate Authority (CA), organisasi tepercaya yang menjamin identitas:
```
gdcloud config set storage/s3_custom_ca_certs_file CA_BUNDLE_FILE
```
Catatan: Jika CA Certs untuk GDC sudah diinstal di lingkungan, maka Anda dapat menetapkannya ke /etc/ssl/certs/ca-certificates.crt
Ganti ENDPOINT dengan endpoint yang disediakan oleh Operator Infrastruktur (IO):
```
gdcloud config set storage/s3_endpoint ENDPOINT
```
Catatan: Ini adalah endpoint lengkap yang dimulai dengan https://.

Langkah ini sedikit berbeda untuk bucket zona ganda. Setiap bucket zona ganda menyediakan tiga endpoint yang dapat Anda pilih untuk mengakses bucket. Untuk sebagian besar situasi, endpoint global sesuai untuk memanfaatkan failover otomatis:
- Endpoint zona1: Endpoint ini selalu diterima oleh zona1. Jika menggunakan endpoint ini, Anda memiliki konsistensi baca setelah tulis untuk objek apa pun yang ditulis ke zona1. Namun, jika zona1 tidak berfungsi, klien harus beralih menggunakan endpoint zona2 atau global untuk terus membaca/menulis ke bucket ini. Jika klien berasal dari cluster pengguna, endpoint ini hanya dapat diakses dari dalam zona1.
- Endpoint zona2: Endpoint ini selalu diterima oleh zona2. Jika menggunakan endpoint ini, Anda memiliki konsistensi baca setelah tulis untuk objek apa pun yang ditulis ke zona2. Namun, jika zona2 tidak berfungsi, klien harus beralih menggunakan endpoint zona1 atau global untuk terus membaca/menulis ke bucket ini. Jika klien berasal dari cluster pengguna, endpoint ini hanya dapat diakses dari dalam zona2.
- Endpoint global: Endpoint ini akan merutekan permintaan Anda ke zona1 atau zona2. Opsi ini tidak memberikan afinitas sesi, yang berarti bahwa 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 zona tidak berfungsi, sehingga pengguna tidak perlu mengubah endpoint dalam workload mereka seperti yang 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 dan pilih 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
```