서비스 및 워크로드 관리

애플리케이션 설정 모델을 선택할 때 관리 프로젝트에서 App Hub 애플리케이션의 애플리케이션 관리 경계를 정의합니다. 그런 다음 이 경계 내의 애플리케이션에 서비스와 워크로드를 등록할 수 있습니다. 애플리케이션 관리 관행을 도입하기 위한 권장 사용 사례는 애플리케이션 수명 주기 관리 준비를 참고하세요.

구성 드리프트를 방지하고 명확한 신뢰할 수 있는 소스를 유지하려면 원래 정의된 환경에서 애플리케이션 구성요소를 관리하는 것이 좋습니다.

  • App Design Center 템플릿에서 배포된 애플리케이션의 경우: App Design Center를 사용하여 애플리케이션을 관리하고 업데이트합니다. 애플리케이션 디자인을 변경하려면 템플릿을 수정하고, 애플리케이션 및 구성요소 세부정보와 같은 설정을 업데이트하려면 애플리케이션 수정사항을 만드세요.

    App Design Center로 이동

  • App Hub에서 기존 리소스를 등록하여 생성된 애플리케이션의 경우: App Hub 내에서 직접 애플리케이션, 서비스, 워크로드를 관리합니다.

    App Hub로 이동

이 페이지에서는 App Hub 내에서 직접 검색되거나 등록된 서비스와 워크로드를 관리하는 방법을 설명합니다. Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 이러한 작업을 수행할 수 있습니다. 템플릿에서 배포된 애플리케이션의 경우 App Design Center 문서를 참고하세요.

시작하기 전에

이 문서에서는 지원되는 리소스가 등록된 애플리케이션이 있다고 가정합니다.

필요한 역할

App Hub에서 서비스와 워크로드를 관리하는 데 필요한 권한을 얻으려면 관리자에게 애플리케이션 관리 경계를 정의하는 관리 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 서비스 및 워크로드 업데이트 및 등록 해제: App Hub 편집자 (roles/apphub.editor)
  • 서비스, 워크로드, 세부정보 보기: App Hub 뷰어 (roles/apphub.viewer)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

App Hub 역할에 대한 자세한 내용은 App Hub IAM 역할 및 권한을 참고하세요.

서비스 및 워크로드 세부정보 보기

다음 단계에 따라 애플리케이션 관리 경계 내에서 서비스 및 워크로드의 세부정보(위치, 애플리케이션 등록 상태, 속성, 속성 등)를 확인하세요. 이러한 세부정보에 대한 자세한 내용은 App Hub 개념 및 데이터 모델을 참고하세요.

콘솔

등록 상태 값이 등록됨 또는 분리됨인 애플리케이션의 서비스 및 워크로드에서 세부정보를 확인합니다.

  1. Google Cloud 콘솔에서 프로젝트 선택 도구를 사용하여 관리 프로젝트를 선택합니다.

  2. App Hub에서 애플리케이션 페이지로 이동합니다.

    애플리케이션으로 이동

    페이지에 애플리케이션 목록이 표시됩니다.

  3. 서비스 또는 워크로드 세부정보를 보려는 애플리케이션의 이름을 클릭합니다.

  4. 서비스 및 워크로드 탭에서 보려는 서비스 또는 워크로드의 이름을 클릭합니다.

  5. 구성요소의 세부정보 페이지에서 표시 이름, 위치, 등록 상태, 속성, 속성과 같은 정보를 확인할 수 있습니다.

또는 등록 상태 값이 탐색됨 또는 등록됨인 모든 서비스 및 워크로드 목록을 확인합니다.

  1. App Hub에서 서비스 및 워크로드 페이지로 이동합니다.

    서비스 및 워크로드로 이동

    이 페이지에는 검색되고 등록된 모든 서비스와 워크로드 목록이 표시됩니다.

  2. 필터 필드를 사용하여 환경, 소유자, 등록 상태와 같은 값을 사용하여 속성, 속성 또는 상태별로 결과를 좁힙니다.

gcloud

등록 상태 값이 등록됨 또는 분리됨인 애플리케이션의 서비스 및 워크로드에서 세부정보를 확인합니다.

  1. 관리 프로젝트의 프로젝트 ID를 찾습니다.

  2. 애플리케이션의 서비스 또는 워크로드를 설명하여 속성 및 속성을 포함한 세부정보를 검토합니다.

    • 서비스를 설명합니다.

      gcloud apphub applications services describe SERVICE \
    --project=PROJECT_ID \
    --application=APPLICATION \
    --location=LOCATION

      다음을 바꿉니다.

      • SERVICE: 서비스의 ID입니다.
      • PROJECT_ID: 관리 프로젝트의 ID입니다.
      • APPLICATION: 서비스가 등록된 애플리케이션의 ID입니다.
      • LOCATION: 서비스의 위치입니다. 전역 리소스에는 global을 사용하고 리전 리소스에는 특정 리전(예: us-east1)을 사용합니다.

    • 워크로드를 설명합니다.

      gcloud apphub applications workloads describe WORKLOAD \
    --project=PROJECT_ID \
    --application=APPLICATION \
    --location=LOCATION

      다음을 바꿉니다.

      • WORKLOAD: 워크로드의 ID입니다.
      • PROJECT_ID: 관리 프로젝트의 ID입니다.
      • APPLICATION: 워크로드가 등록된 애플리케이션의 ID입니다.
      • LOCATION: 워크로드의 위치입니다. 전역 리소스에는 global을 사용하고 리전 리소스에는 특정 리전(예: us-east1)을 사용합니다.

출력에는 표시 이름, 위치, 등록 상태 등 구성요소의 세부정보가 표시됩니다. 리소스에 있는 경우 속성 및 속성도 포함됩니다.

또는 등록 상태 값이 탐색됨 또는 등록됨인 모든 서비스 및 워크로드 목록을 확인합니다.

발견됨

애플리케이션 관리 경계 내에서 검색된 Google Cloud 리소스는 애플리케이션에서 서비스 또는 워크로드로 등록할 수 있습니다. 검색된 리소스를 나열하려면 다음 단계를 따르세요.

  1. 탐색된 서비스 나열:

    gcloud apphub discovered-services list \
    --project=PROJECT_ID \
    --location=LOCATION

    다음을 바꿉니다.

    • PROJECT_ID: 관리 프로젝트의 ID입니다.
    • LOCATION: 리소스를 검색할 위치입니다. 전역 리소스의 경우 global을 사용하고 리전 리소스의 경우 특정 리전(예: us-east1)을 사용합니다.

  2. 탐색된 워크로드를 나열합니다.

    gcloud apphub discovered-workloads list \
    --project=PROJECT_ID \
    --location=LOCATION

등록됨

등록된 서비스와 워크로드는 애플리케이션의 일부입니다. 다음 단계에 따라 특정 애플리케이션의 등록된 구성요소를 나열합니다. --filter 플래그를 사용하여 속성을 기반으로 목록을 필터링할 수 있습니다.

  1. 애플리케이션에 등록된 서비스를 나열합니다.

    gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --filter=FILTER_EXPRESSION

    다음을 바꿉니다.

    • APPLICATION_NAME: 애플리케이션의 이름입니다. 애플리케이션을 만들 때 이 값을 지정합니다.
    • PROJECT_ID: 관리 프로젝트의 ID입니다.
    • LOCATION: 구성요소 위치 전역 구성요소에는 global를 사용하고 리전 구성요소에는 us-east1와 같은 특정 리전을 사용합니다.
    • 선택사항: FILTER_EXPRESSION: 속성을 지정하는 필터 표현식입니다. 예를 들어 PRODUCTION 환경 유형의 구성요소를 나열하려면 attributes.environment.type=PRODUCTION를 사용합니다.

  2. 애플리케이션에 등록된 워크로드를 나열합니다.

    gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --filter=FILTER_EXPRESSION

애플리케이션 관리 경계에서 프로젝트 또는 폴더를 이동하거나 기본 리소스를 삭제하면 애플리케이션의 서비스 및 워크로드 등록 상태가 분리됨으로 변경될 수 있습니다. 분리된 서비스 및 워크로드는 등록 취소할 때까지 애플리케이션에 남아 있지만 App Hub에서 더 이상 관리하거나 모니터링할 수 없습니다. 자세한 내용은 서비스 및 워크로드의 등록 상태를 참고하세요.

서비스 또는 워크로드를 애플리케이션에 다시 연결하려면 다시 등록해야 합니다.

서비스 및 워크로드 속성 업데이트

애플리케이션에 등록된 서비스 및 워크로드의 속성을 수정하려면 다음 단계를 따르세요.

콘솔

  1. Google Cloud 콘솔에서 프로젝트 선택 도구를 사용하여 관리 프로젝트를 선택합니다.

  2. App Hub에서 애플리케이션 페이지로 이동합니다.

    애플리케이션으로 이동

    페이지에 애플리케이션 목록이 표시됩니다.

  3. 서비스 또는 워크로드 속성을 업데이트할 애플리케이션의 이름을 클릭합니다.

  4. 서비스 및 워크로드 탭에서 업데이트하려는 서비스 또는 워크로드의 이름을 찾습니다.

  5. more_vert 더보기를 클릭한 다음 서비스 수정 또는 워크로드 수정을 클릭합니다.

  6. 열린 창에서 필요에 따라 필드를 수정하고 저장을 클릭합니다.

gcloud

  1. 관리 프로젝트의 프로젝트 ID를 찾습니다.

  2. 서비스 또는 워크로드 속성을 업데이트합니다.

    • 서비스 속성을 업데이트합니다.

      gcloud apphub applications services update SERVICE_NAME \
    --application=APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --display-name=DISPLAY_NAME \
    --criticality-type=CRITICALITY_LEVEL \
    --environment-type=ENVIRONMENT \
    --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
    --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
    --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL

      SERVICE_NAME을 업데이트할 서비스의 이름으로 바꿉니다.

    • 워크로드 속성을 업데이트합니다.

      gcloud apphub applications workloads update WORKLOAD_NAME \
    --application=APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --display-name=DISPLAY_NAME \
    --criticality-type=CRITICALITY_LEVEL \
    --environment-type=ENVIRONMENT \
    --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
    --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
    --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL

      WORKLOAD_NAME을 업데이트하려는 워크로드의 이름으로 바꿉니다.

      다음 필수 및 선택적 플래그를 바꿉니다.

      • 필수: APPLICATION_NAME: 애플리케이션의 이름입니다. 애플리케이션을 만들 때 이 값을 지정합니다.
      • 필수: PROJECT_ID: 관리 프로젝트의 ID입니다.
      • 필수: LOCATION: 구성요소 위치입니다. 전역 구성요소에는 global를 사용하고 리전 구성요소에는 특정 리전(예: us-east1)을 사용합니다.
      • 선택사항: DISPLAY_NAME: 구성요소의 표시 이름입니다.

      • 선택사항: CRITICALITY_LEVEL: 구성요소의 중요도 수준입니다. 다음 값 중 하나를 사용하세요.

        • MISSION_CRITICAL
        • HIGH
        • MEDIUM
        • LOW

      • 선택사항: ENVIRONMENT: 소프트웨어 수명 주기의 단계입니다. 다음 중 한 가지 값을 사용합니다.

        • PRODUCTION
        • STAGING
        • DEVELOPMENT
        • TEST

      • 선택사항: DEV_NAME 및 DEV_EMAIL: 개발자 소유자의 표시 이름과 이메일 주소입니다.

      • 선택사항: OPERATOR_NAME 및 OPERATOR_EMAIL: 운영자 소유자의 표시 이름과 이메일 주소입니다.

      • 선택사항: BUSINESS_NAME 및 BUSINESS_EMAIL: 비즈니스 소유자의 표시 이름과 이메일 주소입니다.

Terraform

Terraform으로 서비스 또는 워크로드 속성을 업데이트하려면 구성 파일에서 해당 google_apphub_service 또는 google_apphub_workload 리소스 블록 내의 인수를 수정합니다. 변경사항을 적용하면 Terraform에서 새 구성과 일치하도록 리소스를 업데이트합니다.

다음 예에서는 리전 애플리케이션의 서비스 및 워크로드의 중요도 및 환경 속성을 업데이트합니다.

  • 서비스 속성을 업데이트합니다.

    resource "google_apphub_service" "example" {
    # ... other arguments
    attributes {
        criticality {
            type = "HIGH" # Updated criticality
        }
        environment {
            type = "PRODUCTION"
        }
        # ... other attributes
    }
}

  • 워크로드 속성을 업데이트합니다.

    resource "google_apphub_workload" "example" {
    # ... other arguments
    attributes {
        criticality {
            type = "HIGH" # Updated criticality
        }
        environment {
            type = "PRODUCTION"
        }
        # ... other attributes
    }
}

서비스 및 워크로드 등록 취소

서비스 또는 워크로드를 등록 취소하면 애플리케이션에서 삭제됩니다. 기본 리소스는 삭제되지 않습니다. 여전히 애플리케이션 관리 경계 내에 있는 경우 등록 상태 값이 발견됨인 리소스가 되어 다른 애플리케이션에 등록할 수 있습니다.

서비스와 워크로드를 등록 취소하려면 다음 단계를 따르세요.

콘솔

  1. Google Cloud 콘솔에서 프로젝트 선택 도구를 사용하여 관리 프로젝트를 선택합니다.

  2. App Hub에서 애플리케이션 페이지로 이동합니다.

    애플리케이션으로 이동

    페이지에 애플리케이션 목록이 표시됩니다.

  3. 서비스 또는 워크로드의 등록을 취소할 애플리케이션의 이름을 클릭합니다.

  4. 서비스 및 워크로드 탭에서 등록 취소하려는 서비스 또는 워크로드의 이름을 클릭합니다.

  5. 구성요소의 세부정보 페이지에서 등록 취소를 클릭합니다.

gcloud

  1. 관리 프로젝트의 프로젝트 ID를 찾습니다.

  2. 서비스 또는 워크로드 등록 취소:

    • 서비스를 등록 취소합니다.

      gcloud apphub applications services delete SERVICE_NAME \
    --application=APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION

      다음을 바꿉니다.

      • SERVICE_NAME: 등록 해제할 서비스의 이름입니다.
      • APPLICATION_NAME: 애플리케이션의 이름입니다. 애플리케이션을 만들 때 이 값을 지정합니다.
      • PROJECT_ID: 관리 프로젝트의 ID입니다.
      • LOCATION: 구성요소 위치 전역 구성요소에는 global을 사용하고 리전 구성요소에는 특정 리전(예: us-east1)을 사용합니다.

    • 워크로드를 등록 취소합니다.

      gcloud apphub applications workloads delete WORKLOAD_NAME \
    --application=APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION

      WORKLOAD_NAME을 등록 해제할 워크로드의 이름으로 바꿉니다.

Terraform

Terraform에서 관리하는 서비스 또는 워크로드를 등록 해제하려면 구성 파일에서 해당 google_apphub_service 또는 google_apphub_workload 리소스 블록을 삭제하고 terraform apply를 실행합니다. 변경사항을 적용하면 Terraform이 App Hub에서 등록을 삭제합니다.

모든 서비스와 워크로드를 등록 취소한 후 애플리케이션을 삭제할 수 있습니다.

다음 단계