App Hub 리소스 수정

터미널 또는 Cloud Shell에서 Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 앱 지원 폴더의 App Hub 리소스를 나열, 확인, 업데이트, 삭제할 수 있습니다.

이 페이지의 정보를 사용하여 App Hub에서 만든 애플리케이션을 업데이트하세요. Application Design Center에 애플리케이션을 배포한 경우 템플릿을 업데이트하여 애플리케이션을 업데이트해야 합니다. 자세한 내용은 배포된 애플리케이션 수정을 참고하세요.

기본 요건

App Hub 리소스를 수정하기 전에 다음 작업을 완료하세요.

  1. 기본 요건에 따라 App Hub를 설정합니다.
  2. 수정하려는 리소스 유형에 따라 App Hub 설정 단계를 실행했는지 확인합니다. 자세한 내용은 App Hub 설정을 참고하세요.

필요한 역할

App Hub 리소스를 수정하는 데 필요한 권한을 얻으려면 관리자에게 앱 지원 폴더에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 애플리케이션을 만들고 업데이트하고, 서비스와 워크로드를 등록하고 등록 취소하고, 연결된 속성을 업데이트하려면 다음 단계를 따르세요.
  • 애플리케이션, 서비스, 워크로드 및 속성을 보려면 다음이 필요합니다. App Hub 뷰어 (roles/apphub.viewer)
  • Cloud Hub에서 애플리케이션 수준 및 프로젝트 수준 데이터를 보려면 다음이 필요합니다. Cloud Hub 운영자 (roles/cloudhub.operator)

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

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

애플리케이션 나열

앱 지원 폴더에서 애플리케이션을 나열하고 필터링할 수 있습니다.

콘솔

  1. 앱 지원 폴더의 애플리케이션을 보려면Google Cloud 콘솔에서 App Hub 애플리케이션 페이지로 이동합니다.

    애플리케이션으로 이동

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

  2. 애플리케이션을 필터링하려면 다음 단계를 따르세요.

    1. 필터 필드에서 중요도와 같은 필터를 선택합니다.
    2. 필터 값을 지정합니다. 예를 들어 중요도가 높은 애플리케이션을 표시하려면 값으로 높음을 선택합니다.
      지정된 필터와 일치하는 애플리케이션 목록이 표시됩니다.

gcloud

  1. 앱 지원 폴더에서 애플리케이션을 보려면 다음 단계를 따르세요.

    gcloud apphub applications list \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    다음을 바꿉니다.

    • MANAGEMENT_PROJECT_ID: 관리 프로젝트의 ID입니다. 관리 프로젝트 ID는 Google Cloud 콘솔의 Identity and Access Management (IAM) & Admin Settings 페이지에서 확인할 수 있습니다. 관리 프로젝트 ID를 찾을 수 없는 경우 앱이 사용 설정된 폴더에 있지 않을 수 있습니다. 보기 선택기 (또는 프로젝트 선택기)에서 앱 지원 폴더를 선택합니다. 애플리케이션 관리를 위해 폴더를 사용 설정하는 방법에 대한 자세한 내용은 애플리케이션 관리 사용 설정을 참고하세요.
    • REGION: 애플리케이션의 리전입니다. 애플리케이션의 --scope-type에 따라 global 값 또는 애플리케이션의 리전(예: us-east1)을 지정합니다. 애플리케이션의 --scope-type 설정에 관한 자세한 내용은 애플리케이션 만들기를 참고하세요.

  2. 변수 속성을 기준으로 애플리케이션을 필터링하려면 --filter 플래그를 사용합니다. 예를 들어 environment-type 속성이 PRODUCTION로 설정된 모든 애플리케이션을 나열하려면 다음을 실행합니다.

    gcloud apphub applications list \
    --filter='attributes.environment.type=PRODUCTION' \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

애플리케이션 보기

앱 지원 폴더에서 애플리케이션을 설명할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 App Hub 애플리케이션 페이지로 이동합니다.

    애플리케이션으로 이동

  2. 애플리케이션 목록에서 세부정보를 확인하려는 애플리케이션을 클릭합니다.

  3. 세부정보 탭을 클릭하여 애플리케이션의 세부정보를 표시합니다.

gcloud

gcloud apphub applications describe APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

APPLICATION_NAME을 애플리케이션 이름으로 바꿉니다. 이름은 공백이 없는 소문자 영숫자 문자만 포함해야 합니다.

App Hub 애플리케이션 업데이트

애플리케이션을 만든 후 애플리케이션의 속성을 업데이트할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 App Hub 애플리케이션 페이지로 이동합니다.

    애플리케이션으로 이동

  2. 애플리케이션 목록에서 업데이트할 애플리케이션에 대해 수정을 클릭합니다.

  3. 필요에 따라 필드를 수정합니다.

  4. 저장을 클릭합니다.

gcloud

  1. criticality-type, environment-type, 소유자 유형 속성으로 애플리케이션을 업데이트합니다.

    gcloud apphub applications update APPLICATION_NAME \
    --display-name='APPLICATION_DISPLAY_NAME' \
    --criticality-type='CRITICALITY_LEVEL' \
    --environment-type='ENVIRONMENT' \
    --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
    --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
    --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    다음을 바꿉니다.

    • APPLICATION_NAME: 애플리케이션의 이름입니다. 이름은 공백이 없는 소문자 영숫자 문자만 포함해야 합니다.
    • REGION: 애플리케이션의 리전입니다.

    다음 중 하나를 업데이트할 수 있습니다.

    • APPLICATION_DISPLAY_NAME: 애플리케이션의 표시 이름을 나타냅니다.
    • CRITICALITY_LEVEL: 애플리케이션, 서비스, 워크로드가 비즈니스 운영에 얼마나 중요한지를 나타냅니다. 다음 값 중 하나를 제공합니다.
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: 소프트웨어 수명 주기의 단계를 나타냅니다. 다음 값 중 하나를 제공합니다.
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR, DISPLAY-NAME-BUSINESS: 각각 개발자, 운영자, 비즈니스 소유자의 표시 이름입니다.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR, EMAIL-NAME-BUSINESS: 각각 개발자, 운영자, 비즈니스 소유자의 이메일 주소입니다. 이러한 값은 username@yourdomain 형식이어야 합니다(예: 222larabrown@gmail.com).

    예를 들면 다음과 같습니다.

    gcloud apphub applications update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1

서비스 및 워크로드 보기

애플리케이션의 서비스와 워크로드를 보고, 나열하고, 필터링할 수 있습니다.

콘솔

  1. 서비스 및 워크로드를 나열하려면 다음 안내를 따르세요.

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

      서비스 및 워크로드로 이동

    2. 리전 목록에서 서비스 및 워크로드를 보려는 리전을 선택합니다. 예를 들어 us-east1을 선택합니다.
      서비스 및 워크로드 페이지에는 us-east1과 연결된 서비스 프로젝트의 모든 서비스 및 워크로드가 표시됩니다.

  2. 서비스 또는 워크로드를 필터링하려면 다음 안내를 따르세요.

    1. 필터 필드에서 환경과 같은 필터를 선택합니다.
    2. 필터 값을 지정합니다. 예를 들어 프로덕션의 서비스와 워크로드를 보려면 값으로 프로덕션을 선택합니다.
      지정된 필터와 일치하는 서비스 및 워크로드 목록이 표시됩니다.

gcloud

탐색된 서비스 나열

탐색된 서비스는 애플리케이션에 등록할 수 있습니다.

  1. 탐색된 서비스를 나열하려면 다음을 실행하세요.

    gcloud apphub discovered-services list \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    다음과 비슷한 출력이 표시됩니다.

    ID                      SERVICE_REFERENCE                                                                                                                   SERVICE_PROPERTIES
[DISCOVERED_SERVICE_ID] {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}

  2. 선택사항: 검색된 서비스 목록을 필터링합니다. 예를 들어 앱 지원 폴더에서 전달 규칙을 사용하여 탐색된 서비스를 필터링하려면 다음을 실행합니다.

    gcloud apphub discovered-services list \
    --filter='service_reference.uri~"forwardingRules"' \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

등록된 서비스 나열

애플리케이션에서 등록된 App Hub 서비스를 나열하고 필터링합니다.

  1. 애플리케이션에 등록된 서비스를 나열하려면 다음 단계를 따르세요.

    gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    다음과 비슷한 출력이 표시됩니다.

    ID             DISPLAY_NAME            SERVICE_REFERENCE                                                                                                                CREATE_TIME
SERVICE_NAME   mywebserver-service1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule'}   2023-11-01T21:38:08

    등록되었지만 분리된 서비스는 SERVICE_REFERENCE 필드에 빈 값으로 표시됩니다.

  2. 선택사항: 등록된 서비스 목록을 필터링합니다. 예를 들어 environment-type 속성이 PRODUCTION로 설정된 애플리케이션에서 등록된 서비스를 필터링하려면 다음 단계를 따르세요.

    gcloud apphub applications services list \
    --filter='attributes.environment.type=PRODUCTION' \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

탐색된 워크로드 나열

탐색된 워크로드는 애플리케이션에 등록할 수 있습니다.

  1. 탐색된 워크로드를 나열하려면 다음을 실행하세요.

    gcloud apphub discovered-workloads list \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    다음과 비슷한 출력이 표시됩니다. 여기에는 등록되지 않은 MIG가 포함됩니다.

    ID                        WORKLOAD_REFERENCE                                                                                                   WORKLOAD_PROPERTIES
[DISCOVERED_WORKLOAD_ID]  {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}

  2. 선택사항: 검색된 워크로드 목록을 필터링합니다. 예를 들어 앱 지원 폴더에서 컴퓨팅 리소스를 사용하여 검색된 워크로드 목록을 필터링하려면 다음을 실행합니다.

    gcloud apphub discovered-workloads list \
    --filter='workload_reference.uri~"compute"'
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

등록된 워크로드 나열

애플리케이션에서 등록된 App Hub 워크로드를 나열하고 필터링합니다.

  1. 애플리케이션에 등록된 워크로드를 나열하려면 다음 안내를 따르세요.

    gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    다음과 비슷한 출력이 표시됩니다.

    ID               DISPLAY_NAME               WORKLOAD_REFERENCE                                                                                                     CREATE_TIME
WORKLOAD_NAME    mywebserver-deployment1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    2023-10-31T18:34:23

    등록되었지만 분리된 워크로드는 WORKLOAD_REFERENCE 필드에 빈 값으로 표시됩니다. 등록 상태에 대한 자세한 내용은 App Hub의 속성 및 속성을 참고하세요.

  2. 선택사항: 등록된 워크로드 목록을 필터링합니다. 예를 들어 environment-type 속성이 PRODUCTION로 설정된 애플리케이션에서 워크로드를 필터링하려면 다음을 실행합니다.

    gcloud apphub applications workloads list \
    --filter='attributes.environment.type=PRODUCTION' \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

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

애플리케이션에 등록된 서비스 및 워크로드를 업데이트할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 App Hub 애플리케이션 페이지로 이동합니다.

    애플리케이션으로 이동

  2. 애플리케이션 이름을 클릭합니다.
    서비스 및 워크로드 탭에는 서비스 프로젝트에 있는 등록된 서비스 및 워크로드 목록이 표시됩니다.

  3. 업데이트하려는 각 서비스 또는 워크로드에 대해 다음을 수행합니다.

    1. 서비스 및 워크로드 탭에서 업데이트할 서비스 또는 워크로드에 대해 more_vert를 클릭한 다음 서비스 수정 또는 워크로드 수정을 클릭합니다.
    2. 서비스 수정 또는 워크로드 수정 창에서 필요한 대로 필드를 수정하고 저장을 클릭합니다.

gcloud

  1. criticality-type, environment-type, 소유자 유형 속성으로 서비스를 업데이트합니다.

    gcloud apphub applications services update SERVICE_NAME \
    --application=APPLICATION_NAME \
    --display-name='SERVICE_DISPLAY_NAME' \
    --criticality-type='CRITICALITY_LEVEL' \
    --environment-type='ENVIRONMENT' \
    --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
    --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
    --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    SERVICE_NAME을 앱 허브 서비스 이름으로 바꿉니다.

    다음 중 하나를 업데이트할 수 있습니다.

    • SERVICE_DISPLAY_NAME: 서비스의 표시 이름을 나타냅니다.
    • CRITICALITY_LEVEL: 애플리케이션, 서비스, 워크로드가 비즈니스 운영에 얼마나 중요한지를 나타냅니다. 다음 값 중 하나를 제공합니다.
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: 소프트웨어 수명 주기의 단계를 나타냅니다. 다음 값 중 하나를 제공합니다.
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR, DISPLAY-NAME-BUSINESS: 각각 개발자, 운영자, 비즈니스 소유자의 표시 이름입니다.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR, EMAIL-NAME-BUSINESS: 각각 개발자, 운영자, 비즈니스 소유자의 이메일 주소입니다. 이러한 값은 username@yourdomain 형식이어야 합니다(예: 222larabrown@gmail.com).

    예를 들면 다음과 같습니다.

    gcloud apphub applications workloads update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1

  2. criticality-type, environment-type, 소유자 유형 속성으로 워크로드를 업데이트합니다.

    gcloud apphub applications workloads update WORKLOAD_NAME \
    --application=APPLICATION_NAME \
    --display-name='WORKLOAD_DISPLAY_NAME' \
    --criticality-type='CRITICALITY_LEVEL' \
    --environment-type='ENVIRONMENT' \
    --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
    --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
    --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    WORKLOAD_NAME을 앱 허브 워크로드의 이름으로 바꿉니다.

    다음 중 하나를 업데이트할 수 있습니다.

    • WORKLOAD_DISPLAY_NAME: 서비스의 표시 이름을 나타냅니다.
    • CRITICALITY_LEVEL: 애플리케이션, 서비스, 워크로드가 비즈니스 운영에 얼마나 중요한지를 나타냅니다. 다음 값 중 하나를 제공합니다.
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: 소프트웨어 수명 주기의 단계를 나타냅니다. 다음 값 중 하나를 제공합니다.
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR, DISPLAY-NAME-BUSINESS: 각각 개발자, 운영자, 비즈니스 소유자의 표시 이름입니다.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR, EMAIL-NAME-BUSINESS: 각각 개발자, 운영자, 비즈니스 소유자의 이메일 주소입니다. 이러한 값은 username@yourdomain 형식이어야 합니다(예: 222larabrown@gmail.com).

    예를 들면 다음과 같습니다.

    gcloud apphub applications workloads update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1

애플리케이션, 서비스, 워크로드 삭제

기존 애플리케이션을 삭제하여 앱 지원 폴더와 연결된 등록된 리소스를 삭제합니다. 이렇게 하려면 먼저 애플리케이션에 등록된 워크로드 및 서비스를 등록 취소해야 합니다.

콘솔

  1. Google Cloud 콘솔에서 App Hub 애플리케이션 페이지로 이동합니다.

    애플리케이션으로 이동

  2. 애플리케이션 이름을 클릭합니다. 애플리케이션에 등록된 서비스 및 워크로드 목록이 나타납니다.

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

    1. 서비스 및 워크로드 탭의 등록된 서비스 및 워크로드 섹션에서 등록 취소하려는 서비스나 워크로드의 이름을 클릭합니다.
    2. 등록된 서비스 또는 워크로드에 대해 열리는 페이지에서 등록 취소를 클릭하여 서비스 또는 워크로드를 검색된 리소스로 업데이트합니다. 서비스 및 워크로드 탭에서 워크로드가 등록 취소되었음을 알리는 알림이 표시됩니다.
    3. 각 서비스 및 워크로드에 대해 이 안내를 반복합니다.

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

    애플리케이션으로 이동

  5. 애플리케이션 이름을 클릭합니다.

  6. 애플리케이션 세부정보가 있는 페이지에서 삭제를 클릭합니다.

gcloud

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

    gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

  2. 애플리케이션에서 서비스 등록을 취소합니다.

    gcloud apphub applications services delete SERVICE_NAME \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    이제 서비스가 애플리케이션에 등록할 수 있는 탐색된 서비스가 됩니다.

  3. 이전 명령어를 반복하여 애플리케이션에서 등록된 나머지 서비스를 등록 취소합니다.

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

    gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

  5. 애플리케이션에서 워크로드를 등록 취소합니다.

    gcloud apphub applications workloads delete WORKLOAD_NAME \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

    이제 워크로드가 애플리케이션에 등록할 수 있는 탐색된 워크로드가 됩니다.

  6. 이전 명령어를 반복하여 애플리케이션에서 등록된 나머지 워크로드를 삭제합니다.

  7. 애플리케이션을 삭제합니다.

    gcloud apphub applications delete APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

다음 단계