Membuat repositori cadangan

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

  1. Login ke konsol GDC.
  2. Di menu navigasi, klik Backup for Virtual Machines > Repositories.
  3. Klik Buat repositori.
  4. Masukkan nama repositori dan deskripsi opsional.
  5. 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 kustom Bucket, jalankan perintah berikut:

    kubectl get Bucket BUCKET_NAME -n NAMESPACE -o json | jq -r '.status.endpoint'
    
  6. 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'
    
  7. 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'
    
  8. 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.

  9. Klik Buat.

API

Buat resource kustom BackupRepository menggunakan kredensial S3 Anda.

  1. 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_NAME di langkah berikutnya.

    Ganti kode berikut:

    • PROJECT_NAME: nama project Anda.
    • SA_NAME: nama akun layanan yang digunakan untuk mengakses penyimpanan objek.
  2. Untuk mendapatkan detail bucket seperti FQDN dan endpoint, ekstrak nilai fullyQualifiedName dan zonalEndpoints dari output:

    kubectl get buckets -n PROJECT_NAME BUCKET_NAME -o yaml
    
  3. Buat BackupRepository dalam 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_POLICY
    

    Ganti 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 perintah kubectl get secrets.
    • ENDPOINT: nama domain yang sepenuhnya memenuhi syarat untuk sistem penyimpanan, misalnya, https://objectstorage.google.gdch.test. Untuk kolom type, hanya nilai S3 yang didukung.
    • BUCKET_FQDN: nama bucket yang sepenuhnya memenuhi syarat.
    • REGION: region tempat bucket dibuat.
    • FORCE_PATH_STYLE: gunakan kolom forcePathStyle untuk menerapkan URL gaya jalur untuk objek. Kolom ini harus memiliki nilai true atau false.
    • 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.

    BackupRepository membuat resource BackupRepository yang diaktifkan untuk baca-tulis di server Management API yang memiliki nama yang sama.

Langkah berikutnya