반복 사용량 만들기

이 페이지에서는 인프라 운영자 (IO)가 Google Distributed Cloud (GDC) 오프라인 인스턴스의 결제 비용과 서비스 사용 정보를 관리하기 위해 반복 사용량을 만드는 방법을 설명합니다.

RecurringUsage 리소스를 사용하면 일정하고 정의된 타임라인에서 특정 SKU의 수수료를 정의할 수 있습니다. 예를 들어 연도 내에 시작되고 종료되는 1년 서비스를 주문합니다. Distributed Cloud는 사용량에 따라 요금이 청구되는 재고 관리 단위 (SKU)와 사용량 기반이 아닌 SKU를 모두 제공합니다. 월간 반복 고정 수수료를 관리하려면 Billing API의 RecurringUsage 리소스를 사용하세요.

결제 요구사항 확인

RecurringUsage 리소스를 사용하여 고정 요금 구독을 설정하는 것은 선택사항입니다. 청구 요구사항을 확인하려면 다음 사용 사례를 고려하세요.

  • Google Cloud Billing을 사용하여 고정 비용과 인보이스를 추적하는 경우 Distributed Cloud 환경에서 반복 사용 요금을 설정할 필요가 없습니다.

  • 예를 들어 지원 비용과 같은 월별 고정 반복 수수료를 추가하려면 반복 수수료를 SKU(예: 지원 SKU)와 연결해야 합니다. 이 경우 ReccurringUsage 리소스 설정을 진행해야 합니다.

시작하기 전에

계속하기 전에 다음 사항을 확인하세요.

  • 조직 관리 클러스터의 조직 결제 뷰어 역할 보안 관리자에게 연락하여 billing-system 네임스페이스에 대한 조직 결제 뷰어(organization-billing-viewer) 역할을 부여해 달라고 요청하세요. 이 권한을 사용하면 검증을 위해 관련 리소스를 읽을 수 있습니다.

  • kustomization.yaml 파일과 recurringusages 디렉터리가 있는 iac 저장소로, RecurringUsages 맞춤 리소스가 있는 파일을 저장합니다.

RecurringUsage 커스텀 리소스 만들기

RecurringUsage 리소스를 만들려면 다음 단계를 따르세요.

  1. infrastructure/zonal/zones/ZONE_NAME/TARGET_CLUSTER/bil/recurringusages/RECURRING_USAGE_NAME.yaml 경로를 사용하여 YAML 파일을 만듭니다.

    다음 변수를 바꿉니다.

    • TARGET_CLUSTER: 액세스할 수 있는 클러스터의 이름입니다. 여기서는 조직 관리자 클러스터입니다.
    • RECURRING_USAGE_NAME: YAML 파일에 지정한 이름입니다.

  2. RecurringUsage 리소스와 다음 내용을 추가합니다.

    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

    다음 변수를 바꿉니다.

    변수 설명
    RECURRING_USAGE_NAME 리소스에 지정할 이름입니다. 생성하는 각 리소스에 고유한 이름을 지정해야 합니다. 이름을 고유하게 만들려면 SKU_DESCRIPTION_NAME에 지정한 이름 뒤에 타임스탬프를 추가하세요. 예를 들면 다음과 같습니다.
    RECURRING_USAGE_NAME=${SKU_DESCRIPTION_NAME}-$(date +"%Y-%m-%d-%H%M%S")
    SKU_DESCRIPTION_NAME 참조된 SKU 설명의 이름입니다. 소문자 SKU_ID입니다. SKU 설명 이름은 12개의 소문자 영숫자 문자로 구성되며, 4개의 문자로 된 그룹으로 대시로 구분됩니다. 예를 들면 0000-ffff-aaaa입니다.
    UNITS 사용량의 전체 단위입니다. 예를 들어 청구 금액이 1.50 단위인 경우 이 필드를 1으로 설정하고 NANOS 필드를 500000000으로 설정합니다.
    NANOS 전체 단위의 나노입니다. 예를 들어 요금이 1.50단위인 경우 UNITS 필드를 1로 설정하고 이 필드를 500000000로 설정합니다.
    START_TIME 특정 SKU의 요금 청구를 시작할 타임스탬프입니다. 타임스탬프는 RFC 3339 형식을 따라야 합니다. 예를 들어 01/01/2024에 시작하는 서비스를 주문하는 경우 타임스탬프 값을 2024-01-01T00:00:00Z로 추가합니다.

    이 필드는 선택사항이며 설정하지 않으면 GitLab에서 병합 요청을 제출하는 즉시 요금이 발생합니다. GitLab에서 병합 요청을 제출하기 전에는 이 필드를 설정할 수 없습니다. 요청된 시작 시간이 과거인 경우 GDC 지원팀으로 인시던트를 에스컬레이션합니다.
    END_TIME 특정 SKU의 청구를 종료할 타임스탬프입니다. 타임스탬프는 RFC 3339 형식을 따라야 합니다. 예를 들어 01/01/2024에 시작하고 01/01/2025에 종료되는 서비스를 주문하는 경우 타임스탬프 값을 2025-01-01T00:00:00Z로 추가합니다.

    이 필드는 선택사항이며 설정하지 않으면 요금이 계속 발생합니다. GitLab에서 병합 요청을 제출하기 전에는 이 필드를 설정할 수 없습니다. 요청된 종료 시간이 과거인 경우 GDC 지원팀으로 인시던트를 에스컬레이션합니다.

  3. 반복 사용을 저장하고 recurringusages 폴더에 저장합니다.

  4. 필요한 kustomization 파일과 함께 YAML 파일이 포함된 풀 요청을 만듭니다.

  5. RecurringUsage 커스텀 리소스가 생성되었는지 확인합니다.

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

    RecurringUsage 커스텀 리소스를 만들 수 없는 경우 'IAC-R0001'의 안내에 따라 문제를 자세히 조사하세요.