Membuat penggunaan berulang

Halaman ini mencakup petunjuk bagi Operator Infrastruktur (IO) untuk membuat penggunaan berulang guna mengelola biaya Penagihan untuk informasi penggunaan layanan dan instance yang terisolasi dari internet Google Distributed Cloud (GDC) Anda.

Dengan resource RecurringUsage, Anda dapat menentukan biaya untuk SKU tertentu pada linimasa yang konstan dan ditentukan. Misalnya, Anda memesan layanan selama satu tahun yang dimulai dan berakhir dalam satu tahun. Distributed Cloud menawarkan unit penyimpanan persediaan (SKU) yang menimbulkan biaya berdasarkan penggunaan dan SKU yang tidak berbasis penggunaan. Untuk mengelola biaya tetap berulang bulanan, gunakan resource RecurringUsage dari Billing API.

Menentukan persyaratan penagihan Anda

Menyiapkan langganan biaya tetap dengan resource RecurringUsage adalah langkah opsional. Untuk menentukan persyaratan penagihan, pertimbangkan kasus penggunaan berikut:

  • Jika Anda menggunakan Google Cloud Penagihan untuk melacak biaya tetap dan pembuatan invoice, Anda tidak perlu menyiapkan biaya penggunaan berulang di lingkungan Distributed Cloud.

  • Jika Anda ingin menambahkan biaya berulang tetap bulanan, misalnya, biaya dukungan, Anda harus mengaitkan biaya berulang dengan SKU, misalnya, SKU dukungan. Dalam hal ini, Anda harus melanjutkan penyiapan resource ReccurringUsage.

Sebelum memulai

Sebelum melanjutkan, pastikan Anda memiliki hal berikut:

  • Peran Organization Billing Viewer di cluster admin org. Hubungi Admin Keamanan Anda untuk memberi Anda peran Organization Billing Viewer (organization-billing-viewer) untuk namespace billing-system. Izin ini memungkinkan Anda membaca resource terkait untuk validasi.

  • Repositori iac dengan file kustomization.yaml dan direktori recurringusages untuk menyimpan file dengan resource kustom RecurringUsages.

Membuat resource kustom RecurringUsage

Untuk membuat resource RecurringUsage, ikuti langkah-langkah berikut:

  1. Buat file YAML dengan jalur infrastructure/zonal/zones/ZONE_NAME/TARGET_CLUSTER/bil/recurringusages/RECURRING_USAGE_NAME.yaml.

    Ganti variabel berikut:

    • TARGET_CLUSTER: nama cluster yang aksesnya Anda miliki, di sini dengan cluster admin org.
    • RECURRING_USAGE_NAME: nama yang Anda berikan ke file YAML.

  2. Tambahkan resource RecurringUsage dan konten berikut:

    apiVersion: billing.private.gdc.goog/v1alpha1
kind: RecurringUsage
metadata:
  name: RECURRING_USAGE_NAME
  namespace: billing-system
skuDescriptionRef:
  name: SKU_DESCRIPTION_NAME
  namespace: billing-system
usageQuantity:
  units: UNITS
  nanos: NANOS
startTime: START_TIME
endTime: END_TIME

    Ganti variabel berikut:

    Variabel Deskripsi
    RECURRING_USAGE_NAME Nama yang akan diberikan ke resource. Untuk setiap resource yang Anda buat, Anda harus memberikan nama yang unik. Untuk membuat nama unik, tambahkan stempel waktu setelah nama yang Anda berikan ke SKU_DESCRIPTION_NAME. Contoh:
    RECURRING_USAGE_NAME=${SKU_DESCRIPTION_NAME}-$(date +"%Y-%m-%d-%H%M%S")
    SKU_DESCRIPTION_NAME Nama deskripsi SKU yang direferensikan, yaitu SKU_ID huruf kecil. Nama deskripsi SKU terdiri dari 12 karakter alfanumerik huruf kecil, yang dipisahkan dengan tanda hubung dalam kelompok empat karakter. Contoh: 0000-ffff-aaaa.
    UNITS Seluruh unit jumlah penggunaan. Misalnya, jika tagihan adalah untuk 1.50 unit, tetapkan kolom ini ke 1 dan kolom NANOS ke 500000000.
    NANOS Nano dari seluruh unit. Misalnya, jika tagihan adalah untuk 1,50 unit, tetapkan kolom UNITS ke 1 dan kolom ini ke 500000000.
    START_TIME Stempel waktu untuk memulai pengisian daya untuk SKU tertentu. Stempel waktu harus mengikuti format RFC 3339. Misalnya, jika Anda memesan layanan yang dimulai pada 01/01/2024, tambahkan nilai stempel waktu sebagai 2024-01-01T00:00:00Z.

    Kolom ini bersifat opsional, dan jika tidak disetel, biaya akan dikenakan segera setelah Anda mengirimkan permintaan penggabungan di GitLab. Anda tidak dapat menetapkan kolom ini sebelum waktu saat Anda mengirimkan permintaan penggabungan di GitLab. Jika waktu mulai yang diminta sudah berlalu, eskalasikan insiden tersebut ke Dukungan GDC.
    END_TIME Stempel waktu untuk mengakhiri tagihan untuk SKU tertentu. Stempel waktu harus mengikuti format RFC 3339. Misalnya, jika Anda memesan layanan yang dimulai pada 01/01/2024 dan berakhir pada 01/01/2025, tambahkan nilai stempel waktu sebagai 2025-01-01T00:00:00Z.

    Kolom ini bersifat opsional, dan jika tidak ditetapkan, biaya akan terus dikenakan. Anda tidak dapat menetapkan kolom ini sebelum waktu saat Anda mengirimkan permintaan penggabungan di GitLab. Jika waktu berakhir yang diminta sudah berlalu, eskalasikan insiden tersebut ke Dukungan GDC.

  3. Simpan dan simpan penggunaan berulang di folder recurringusages.

  4. Buat pull request yang berisi file YAML beserta file kustomization yang diperlukan.

  5. Pastikan resource kustom RecurringUsage dibuat:

    kubectl get recurringusages.billing.private.gdc.goog RECURRING_USAGE_NAME -n billing-system -o yaml

    Jika Anda tidak dapat membuat resource kustom RecurringUsage, ikuti petunjuk di 'IAC-R0001' untuk menyelidiki masalah lebih lanjut.