복합 상태 리소스 보기, 업데이트, 삭제

이 페이지에서는 복합 상태 리소스를 만든 후에 관리하는 방법을 설명합니다. 상태 집계 정책, 상태 소스, 복합 상태 점검을 나열, 설명, 업데이트, 삭제할 수 있습니다.

상태 집계 정책 관리

이 섹션에서는 건강 집계 정책을 관리하는 방법을 설명합니다.

상태 집계 정책 나열

구성한 상태 집계 정책을 나열할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 상태 집계 정책을 클릭합니다.

gcloud

리전의 모든 상태 집계 정책을 나열하려면 gcloud compute health-aggregation-policies list 명령어를 사용합니다.

gcloud compute health-aggregation-policies list \
    --regions=REGION

REGION을 상태 집계 정책 리전으로 바꿉니다.

API

리전의 모든 상태 집계 정책을 나열하려면 regionHealthAggregationPolicies.list 메서드에 요청을 전송합니다.

HTTP 메서드 및 URL:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies

다음을 바꿉니다.

  • PROJECT_ID: 상태 집계 정책의 프로젝트 ID입니다.
  • REGION: 상태 집계 정책의 리전입니다.

상태 집계 정책 설명

상태 집계 정책을 설명하여 세부정보를 볼 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 상태 집계 정책을 클릭합니다.

  3. 설명하려는 상태 집계 정책의 이름을 클릭합니다.

gcloud

gcloud compute health-aggregation-policies describe 명령어를 사용합니다.

gcloud compute health-aggregation-policies describe POLICY \
    --region=REGION

다음을 바꿉니다.

  • POLICY: 상태 집계 정책 이름
  • REGION: 상태 집계 정책 리전

API

regionHealthAggregationPolicies.get 메서드에 요청을 전송합니다.

HTTP 메서드 및 URL:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY

다음을 바꿉니다.

  • PROJECT_ID: 상태 집계 정책의 프로젝트 ID입니다.
  • REGION: 상태 집계 정책의 리전입니다.
  • POLICY: 상태 집계 정책의 이름입니다.

상태 집계 정책 업데이트

상태 집계 정책의 설명, 정상 비율 기준점 또는 최소 정상 기준점을 업데이트할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 상태 집계 정책을 클릭합니다.

  3. 업데이트할 상태 집계 정책의 이름을 클릭합니다.

  4. 수정을 클릭합니다.

  5. 변경하려는 필드를 업데이트합니다.

  6. 저장을 클릭합니다.

gcloud

gcloud compute health-aggregation-policies update 명령어를 사용합니다. 업데이트하지 않으려는 속성의 플래그를 생략합니다.

gcloud compute health-aggregation-policies update POLICY \
    --region=REGION \
    --description="DESCRIPTION" \
    --healthy-percent-threshold=PERCENT_HEALTHY \
    --min-healthy-threshold=MINIMUM_HEALTHY

다음을 바꿉니다.

  • POLICY: 업데이트할 상태 집계 정책의 이름
  • REGION: 상태 집계 정책 리전
  • DESCRIPTION: 정책에 대한 업데이트된 설명
  • PERCENT_HEALTHY: 상태 소스가 정상으로 간주되려면 정상이어야 하는 백엔드 서비스의 업데이트된 최소 엔드포인트 비율(예: 75)
  • MINIMUM_HEALTHY: 상태 소스가 정상으로 간주되려면 정상이어야 하는 백엔드 서비스의 업데이트된 최소 엔드포인트 수(예: 2)

API

  1. 상태 집계 정책을 설명하고 다음 단계에서 사용할 fingerprint 키의 값을 기록해 둡니다.

  2. regionHealthAggregationPolicies.patch 메서드에 요청을 전송합니다. 업데이트하지 않을 속성의 필드를 생략합니다.

    HTTP 메서드 및 URL:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY

    JSON 요청 본문:

    {
  "description": "DESCRIPTION",
  "healthyPercentThreshold": PERCENT_HEALTHY,
  "minHealthyThreshold": MINIMUM_HEALTHY,
  "fingerprint": "FINGERPRINT"
}

    다음을 바꿉니다.

    • PROJECT_ID: 상태 집계 정책의 프로젝트 ID입니다.
    • REGION: 상태 집계 정책의 리전입니다.
    • POLICY: 업데이트할 상태 집계 정책의 이름입니다.
    • DESCRIPTION: 정책에 대한 업데이트된 설명입니다.
    • PERCENT_HEALTHY: 상태 소스가 정상으로 간주되려면 정상이어야 하는 백엔드 서비스의 업데이트된 최소 엔드포인트 비율(예: 75)
    • MINIMUM_HEALTHY: 상태 소스가 정상으로 간주되려면 정상이어야 하는 백엔드 서비스의 업데이트된 최소 엔드포인트 수(예: 2)
    • FINGERPRINT: 이전 단계에서 찾은 fingerprint 키의 최신 값

상태 집계 정책 삭제

기존 상태 소스와 연결되지 않은 경우 상태 집계 정책을 삭제할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 상태 집계 정책을 클릭합니다.

  3. 삭제하려는 건강 집계 정책 옆에 있는 체크박스를 선택합니다.

  4. 삭제를 클릭합니다.

  5. 삭제를 클릭하여 확인합니다.

gcloud

gcloud compute health-aggregation-policies delete 명령어를 사용합니다.

gcloud compute health-aggregation-policies delete POLICY \
    --region=REGION

다음을 바꿉니다.

  • POLICY: 삭제할 상태 집계 정책의 이름
  • REGION: 상태 집계 정책 리전

API

regionHealthAggregationPolicies.delete 메서드에 요청을 전송합니다.

HTTP 메서드 및 URL:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY

다음을 바꿉니다.

  • PROJECT_ID: 상태 집계 정책의 프로젝트 ID입니다.
  • REGION: 상태 집계 정책의 리전입니다.
  • POLICY: 삭제할 상태 집계 정책의 이름입니다.

상태 소스 관리

다음 섹션에서는 상태 소스를 관리하는 방법을 설명합니다.

상태 소스 나열

구성한 상태 소스를 나열할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 건강 소스를 클릭합니다.

gcloud

리전의 모든 상태 소스를 나열하려면 gcloud compute health-sources list 명령어를 사용합니다.

gcloud compute health-sources list \
    --regions=REGION

REGION을 상태 소스 리전으로 바꿉니다.

API

리전의 모든 상태 소스를 나열하려면 regionHealthSources.list 메서드에 요청을 전송합니다.

HTTP 메서드 및 URL:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources

다음을 바꿉니다.

  • PROJECT_ID: 건강 소스의 프로젝트 ID입니다.
  • REGION: 상태 소스의 리전입니다.

상태 소스 설명

상태 소스를 설명하여 세부정보를 볼 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 건강 소스를 클릭합니다.

  3. 설명하려는 건강 소스의 이름을 클릭합니다.

gcloud

gcloud compute health-sources describe 명령어를 사용합니다.

gcloud compute health-sources describe HEALTH_SOURCE \
    --region=REGION

다음을 바꿉니다.

  • HEALTH_SOURCE: 상태 소스 이름
  • REGION: 상태 소스 리전

API

regionHealthSources.get 메서드에 요청을 전송합니다.

HTTP 메서드 및 URL:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE

다음을 바꿉니다.

  • PROJECT_ID: 건강 소스의 프로젝트 ID입니다.
  • REGION: 상태 소스의 리전입니다.
  • HEALTH_SOURCE: 상태 소스의 이름입니다.

상태 소스 업데이트

기존 상태 소스의 설명, 백엔드 서비스 또는 상태 집계 정책을 업데이트할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 건강 소스를 클릭합니다.

  3. 업데이트할 건강 소스의 이름을 클릭합니다.

  4. 수정을 클릭합니다.

  5. 변경하려는 필드를 업데이트합니다.

  6. 저장을 클릭합니다.

gcloud

gcloud compute health-sources update 명령어를 사용합니다. 업데이트하지 않으려는 속성의 플래그를 생략합니다.

gcloud compute health-sources update HEALTH_SOURCE \
    --region=REGION \
    --description="DESCRIPTION" \
    --sources=BACKEND_SERVICE \
    --health-aggregation-policy=POLICY

다음을 바꿉니다.

  • HEALTH_SOURCE: 업데이트할 상태 소스의 이름
  • REGION: 상태 소스 리전
  • DESCRIPTION: 상태 소스에 대한 업데이트된 설명

  • BACKEND_SERVICE: 상태 소스로 사용할 백엔드 서비스의 이름

    백엔드 서비스는 다음 요구사항을 충족해야 합니다.

    • 부하 분산 스킴이 INTERNAL 또는 INTERNAL_MANAGED여야 합니다.
    • 생성하는 상태 소스와 동일한 리전에 있어야 합니다.
    • 백엔드는 GCE_VM_IP 또는 GCE_VM_IP_PORT 유형의 인스턴스 그룹이거나 네트워크 엔드포인트 그룹이어야 합니다.

  • POLICY: 이 상태 소스에 적용할 업데이트된 상태 집계 정책의 이름

API

  1. 건강 소스를 설명하고 다음 단계에서 사용할 fingerprint 키의 값을 기록합니다.

  2. regionHealthSources.patch 메서드에 요청을 전송합니다. 업데이트하지 않을 속성의 필드를 생략합니다.

    HTTP 메서드 및 URL:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE

    JSON 요청 본문:

    {
  "description": "DESCRIPTION",
  "sources": [
    "projects/PROJECT_ID/regions/REGION/backendServices/BACKEND_SERVICE"
  ],
  "healthAggregationPolicy": "projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY",
  "fingerprint": "FINGERPRINT"
}

    다음을 바꿉니다.

    • PROJECT_ID: 건강 소스의 프로젝트 ID입니다.
    • REGION: 상태 소스의 리전입니다.
    • HEALTH_SOURCE: 업데이트할 상태 소스의 이름
    • DESCRIPTION: 상태 소스에 대한 업데이트된 설명입니다.

    • BACKEND_SERVICE: 상태 소스로 사용할 백엔드 서비스의 이름입니다.

      백엔드 서비스는 다음 요구사항을 충족해야 합니다.

      • 부하 분산 스킴이 INTERNAL 또는 INTERNAL_MANAGED여야 합니다.
      • 생성하는 상태 소스와 동일한 리전에 있어야 합니다.
      • 백엔드는 GCE_VM_IP 또는 GCE_VM_IP_PORT 유형의 인스턴스 그룹이거나 네트워크 엔드포인트 그룹이어야 합니다.

    • POLICY: 이 상태 소스에 적용할 업데이트된 상태 집계 정책

    • FINGERPRINT: 이전 단계에서 찾은 fingerprint 키의 최신 값

상태 소스 삭제

기존 복합 상태 점검과 연결되어 있지 않은 경우 상태 소스를 삭제할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 건강 소스를 클릭합니다.

  3. 삭제할 건강 소스 옆에 있는 체크박스를 선택합니다.

  4. 삭제를 클릭합니다.

  5. 삭제를 클릭하여 확인합니다.

gcloud

gcloud compute health-sources delete 명령어를 사용합니다.

gcloud compute health-sources delete HEALTH_SOURCE \
    --region=REGION

다음을 바꿉니다.

  • HEALTH_SOURCE: 삭제할 상태 소스의 이름
  • REGION: 상태 소스 리전

API

regionHealthSources.delete 메서드에 요청을 전송합니다.

HTTP 메서드 및 URL:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE

다음을 바꿉니다.

  • PROJECT_ID: 건강 소스의 프로젝트 ID입니다.
  • REGION: 상태 소스의 리전입니다.
  • HEALTH_SOURCE: 삭제할 상태 소스의 이름입니다.

복합 상태 점검 관리

다음 섹션에서는 복합 상태 점검을 관리하는 방법을 설명합니다.

복합 상태 점검 나열

구성한 복합 상태 점검을 나열할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 복합 상태 점검을 클릭합니다.

gcloud

리전의 모든 복합 상태 점검을 나열하려면 gcloud compute composite-health-checks list 명령어를 사용합니다.

gcloud compute composite-health-checks list \
    --regions=REGION

REGION을 복합 상태 점검 리전으로 바꿉니다.

API

리전의 모든 복합 상태 점검을 나열하려면 regionCompositeHealthChecks.list 메서드에 요청을 전송합니다.

HTTP 메서드 및 URL:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks

다음을 바꿉니다.

  • PROJECT_ID: 복합 상태 점검의 프로젝트 ID입니다.
  • REGION: 복합 상태 점검의 리전입니다.

복합 상태 점검 설명

복합 상태 점검을 설명하여 세부정보를 볼 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 복합 상태 점검을 클릭합니다.

  3. 설명하려는 복합 상태 점검의 이름을 클릭합니다.

gcloud

gcloud compute composite-health-checks describe 명령어를 사용합니다.

gcloud compute composite-health-checks describe COMPOSITE_HEALTH_CHECK \
    --region=REGION

다음을 바꿉니다.

  • COMPOSITE_HEALTH_CHECK: 복합 상태 점검 이름
  • REGION: 복합 상태 점검 리전

API

regionCompositeHealthChecks.get 메서드에 요청을 전송합니다.

HTTP 메서드 및 URL:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK

다음을 바꿉니다.

  • PROJECT_ID: 복합 상태 점검의 프로젝트 ID입니다.
  • REGION: 복합 상태 점검의 리전입니다.
  • COMPOSITE_HEALTH_CHECK: 복합 상태 점검의 이름입니다.

복합 상태 점검 업데이트

복합 상태 점검의 설명, 상태 소스 또는 상태 대상을 업데이트할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 복합 상태 점검을 클릭합니다.

  3. 업데이트할 복합 상태 점검의 이름을 클릭합니다.

  4. 수정을 클릭합니다.

  5. 변경하려는 필드를 업데이트합니다.

  6. 저장을 클릭합니다.

gcloud

gcloud compute composite-health-checks update 명령어를 사용합니다. 업데이트하지 않으려는 속성의 플래그를 생략합니다.

gcloud compute composite-health-checks update COMPOSITE_HEALTH_CHECK \
    --region=REGION \
    --description="DESCRIPTION" \
    --health-sources=HEALTH_SOURCES \
    --health-destination=HEALTH_DESTINATION

다음을 바꿉니다.

  • COMPOSITE_HEALTH_CHECK: 업데이트할 복합 상태 점검의 이름
  • REGION: 복합 상태 점검 리전
  • DESCRIPTION: 업데이트된 설명

  • HEALTH_SOURCES: 복합 상태 점검과 연결할 상태 소스 하나 이상의 이름

    쉼표로 구분된 목록으로 건강 소스 여러 개를 포함할 수 있습니다.

  • HEALTH_DESTINATION: 이 복합 상태 점검에서 복합 상태를 수신하는 전달 규칙의 URI(예: projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE)

    전달 규칙은 복합 상태를 지원하고 다음 요구사항을 충족하는 프로듀서 부하 분산기와 연결되어야 합니다.

    • 부하 분산 스킴이 INTERNAL 또는 INTERNAL_MANAGED여야 합니다.
    • 복합 상태 점검과 동일한 리전에 있어야 합니다.

API

  1. 복합 상태 점검을 설명하고 다음 단계에서 사용할 fingerprint 키의 값을 기록해 둡니다.

  2. regionCompositeHealthChecks.patch 메서드에 요청을 전송합니다. 업데이트하지 않을 속성의 필드를 생략합니다.

    HTTP 메서드 및 URL:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK

    JSON 요청 본문:

    {
  "description": "DESCRIPTION",
  "healthSources": [
    "projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE"
  ],
  "healthDestination": "projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE",
  "fingerprint": "FINGERPRINT"
}

    다음을 바꿉니다.

    • PROJECT_ID: 복합 상태 점검의 프로젝트 ID입니다.
    • REGION: 복합 상태 점검의 리전입니다.
    • COMPOSITE_HEALTH_CHECK: 업데이트할 복합 상태 점검의 이름입니다.
    • DESCRIPTION: 업데이트된 설명입니다.
    • HEALTH_SOURCE: 복합 상태 점검과 연결할 상태 소스의 이름입니다. 여러 상태 소스를 연결하려면 각 소스를 healthSources 배열에 추가합니다.
    • FORWARDING_RULE: 이 복합 상태 점검에서 복합 상태를 수신하는 전달 규칙입니다.
    • FINGERPRINT: 이전 단계에서 찾은 fingerprint 키의 최신 값

복합 상태 점검 삭제

복합 상태 점검을 삭제할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 컴포지트 상태 페이지로 이동합니다.

    복합 상태로 이동

  2. 복합 상태 점검을 클릭합니다.

  3. 삭제할 복합 상태 점검 옆에 있는 체크박스를 선택합니다.

  4. 삭제를 클릭합니다.

  5. 삭제를 클릭하여 확인합니다.

gcloud

gcloud compute composite-health-checks delete 명령어를 사용합니다.

gcloud compute composite-health-checks delete COMPOSITE_HEALTH_CHECK \
    --region=REGION

다음을 바꿉니다.

  • COMPOSITE_HEALTH_CHECK: 삭제할 복합 상태 점검의 이름
  • REGION: 복합 상태 점검 리전

API

regionCompositeHealthChecks.delete 메서드에 요청을 전송합니다.

HTTP 메서드 및 URL:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK

다음을 바꿉니다.

  • PROJECT_ID: 복합 상태 점검의 프로젝트 ID입니다.
  • COMPOSITE_HEALTH_CHECK: 삭제할 복합 상태 점검의 이름입니다.
  • REGION: 복합 상태 점검의 리전입니다.