Halaman ini menjelaskan cara membuat repositori cadangan untuk virtual machine (VM) yang terisolasi dari internet di Google Distributed Cloud (GDC).
Sebelum membuat cadangan atau snapshot, Anda harus menentukan setidaknya satu repositori cadangan yang dapat dibagikan di antara beberapa cadangan atau snapshot. Repositori cadangan memberi tahu sistem pencadangan tempat menyimpan atau mengambil cadangan. Repositori cadangan untuk VM dibatasi ke server Management API.
Sebelum memulai
Sebelum membuat repositori cadangan, Anda harus menyediakan penyimpanan yang mendasarinya dan mengonfigurasi izin yang diperlukan, termasuk:
- Bucket penyimpanan objek dan endpoint yang kompatibel dengan S3.
- Akun layanan yang telah diberi akses ke bucket, dan kredensial S3-nya.
Peran IAM yang diperlukan:
- Admin Pencadangan Organisasi: mengelola resource pencadangan seperti rencana pencadangan dan pemulihan di cluster pengguna.
- Secret Viewer: melihat secret Kubernetes di project.
Minta Admin IAM Organisasi Anda untuk memberi Anda peran Organization Backup Admin (
organization-backup-admin) dan Secret Viewer (secret-viewer). Untuk mengetahui informasi selengkapnya, lihat Definisi peran.
Membuat repositori cadangan
Buat repositori menggunakan konsol GDC atau API.
Konsol
- Login ke konsol GDC.
- Di menu navigasi, klik Backup for Virtual Machines > Repositories.
- Klik Buat repositori.
- Masukkan nama repositori dan deskripsi opsional.
Di kolom Endpoint URI S3, masukkan endpoint dengan nama domain yang sepenuhnya memenuhi syarat dari situs penyimpanan objek Anda, seperti
https://objectstorage.ORG.ZONE.DOMAIN.SUFFIX:PORT. Misalnya,https://objectstorage.org-1.zone1.google.gdch.test. Untuk mendapatkan nilai dari resource kustomBucket, jalankan perintah berikut:kubectl get Bucket BUCKET_NAME -n NAMESPACE -o json | jq -r '.status.endpoint'Di kolom Bucket name, masukkan nama domain yang sepenuhnya memenuhi syarat dari bucket. Anda bisa mendapatkan nama ini dari halaman Bucket details di konsol GDC, atau untuk mendapatkan nilai dari resource kustom
Bucket, jalankan perintah berikut:kubectl get Bucket BUCKET_NAME -n NAMESPACE -o json | jq -r '.status.fullyQualifiedName'Di kolom Bucket region, masukkan region tempat bucket dibuat dan dapatkan nilai dari Bucket custom resource dengan menjalankan perintah berikut:
kubectl get Bucket BUCKET_NAME -n NAMESPACE -o json | jq -r '.status.region'Di kolom Access Key ID dan Access key, masukkan ID kunci akses dan kunci akses rahasia. Untuk mengetahui informasi selengkapnya tentang cara mendapatkan kredensial ini, lihat Memberikan dan mendapatkan akses bucket penyimpanan.
Klik Buat.
API
Buat resource kustom BackupRepository menggunakan kredensial S3 Anda.
Dapatkan nama secret yang berisi kredensial S3:
export PROJECT_NAME=PROJECT_NAME export SA_NAME=SA_NAME kubectl get secrets --namespace $PROJECT_NAME -o json | jq -r --arg USER_NAME "${SA_NAME:?}" '.items[] | select( (.metadata.annotations."object.gdc.goog/subject"==$USER_NAME)) | .metadata.name'Pastikan untuk mencatat nama rahasia yang ditampilkan oleh perintah dan menggunakannya sebagai
SECRET_NAMEdi langkah berikutnya.Ganti kode berikut:
PROJECT_NAME: nama project Anda.SA_NAME: nama akun layanan yang digunakan untuk mengakses penyimpanan objek.
Untuk mendapatkan detail bucket seperti FQDN dan endpoint, ekstrak nilai
fullyQualifiedNamedanzonalEndpointsdari output:kubectl get buckets -n PROJECT_NAME BUCKET_NAME -o yamlBuat
BackupRepositorydalam server Management API:apiVersion: backup.gdc.goog/v1 kind: BackupRepository metadata: name: REPOSITORY_NAME spec: secretReference: namespace: PROJECT_NAME name: SECRET_NAME endpoint: ENDPOINT type: "S3" s3Options: bucket: BUCKET_FQDN region: REGION forcePathStyle: FORCE_PATH_STYLE importPolicy: IMPORT_POLICYGanti kode berikut:
REPOSITORY_NAME: nama repositori cadangan.PROJECT_NAME: nama project Anda.SA_NAME: nama akun layanan yang digunakan untuk mengakses penyimpanan objek.SECRET_NAME: nama secret yang ditampilkan dari perintahkubectl get secrets.ENDPOINT: nama domain yang sepenuhnya memenuhi syarat untuk sistem penyimpanan, misalnya,https://objectstorage.google.gdch.test. Untuk kolomtype, hanya nilaiS3yang didukung.BUCKET_FQDN: nama bucket yang sepenuhnya memenuhi syarat.REGION: region tempat bucket dibuat.FORCE_PATH_STYLE: gunakan kolomforcePathStyleuntuk menerapkan URL gaya jalur untuk objek. Kolom ini harus memiliki nilaitrueataufalse.IMPORT_POLICY: tetapkan ke salah satu opsi berikut:ReadWrite: Repositori ini dapat digunakan untuk menjadwalkan atau membuat cadangan, rencana cadangan, dan pemulihan.ReadOnly: Repositori ini hanya dapat digunakan untuk mengimpor dan melihat cadangan. Tidak ada cadangan atau resource baru yang dapat dibuat di repositori ini, tetapi pemulihan dapat menggunakan dan mereferensikan cadangan hanya baca untuk pemulihan. Tidak ada batasan seberapa sering repositori cadangan dapat digunakan sebagai ReadOnly.
BackupRepositorymembuat resourceBackupRepositoryyang diaktifkan untuk baca-tulis di server Management API yang memiliki nama yang sama.