앱 지원 폴더용 App Hub 설정

이 문서에서는 앱 지원 폴더를 사용하여 App Hub를 설정하여 Google Cloud에서 App Hub 애플리케이션을 빌드, 운영, 관리하는 방법을 안내합니다. 이 문서는 App Hub를 설정하고 관리하는 사용자를 대상으로 합니다.

호스트 프로젝트에서 App Hub를 설정할 수도 있습니다. 하지만 앱 지원 폴더는 애플리케이션 디자인 센터 및 Gemini Cloud Assist와 같은 기능에 액세스할 수 있으므로 호스트 프로젝트보다 앱 지원 폴더를 사용하여 애플리케이션을 관리하는 것이 좋습니다. 호스트 프로젝트에서 App Hub를 설정하는 방법에 관한 자세한 내용은 호스트 프로젝트에서 App Hub 설정을 참고하세요.

앱 지원 폴더에 App Hub 애플리케이션을 설정한 후 자연어 지원을 사용하여 애플리케이션에 관한 정보를 검색할 수 있습니다. 자세한 내용은 Google Cloud 콘솔에서 Gemini Cloud Assist 사용을 참고하세요.

서비스 및 워크로드

App Hub를 사용하면 앱 지원 폴더의 하위 요소인 Google Cloud 프로젝트의 리소스를 서비스 및 워크로드로 사용할 수 있습니다. 서비스 및 워크로드를 애플리케이션에 등록하면 리소스를 관찰하고 모니터링할 수 있습니다. App Hub는 전역 및 리전별 리소스를 지원합니다. 애플리케이션에 추가할 수 있는 리소스에 관한 자세한 내용은 App Hub 지원 리소스를 참고하세요.

전체 설정 프로세스

다음 목록에는 App Hub를 설정하는 단계가 요약되어 있습니다.

  1. 애플리케이션에 포함할 기존 리소스와 리소스가 속한 프로젝트를 결정합니다. 애플리케이션을 관리하는 방법에 관한 자세한 내용은 애플리케이션 관리를 참고하세요.
  2. 폴더에서 애플리케이션 관리를 사용 설정합니다. 이제 앱 지원 폴더의 모든 하위 프로젝트에서 리소스를 관리할 수 있습니다. 애플리케이션에 필요한 기본 리소스가 포함된 새 프로젝트가 폴더에 추가되면 이러한 프로젝트는 애플리케이션 관리를 위해 자동으로 사용 설정됩니다.
    다음에 유의하세요.
    1. 프로젝트는 앱 지원 폴더와 동일한 조직에 있어야 합니다. 앱 지원 폴더에 프로젝트를 연결한 후 프로젝트를 다른 조직으로 이동하려면 프로젝트를 마이그레이션해야 합니다. 자세한 내용은 조직 리소스 간에 프로젝트 마이그레이션을 참고하세요.
    2. 프로젝트를 앱 지원 폴더에 연결한 후 앱 지원 폴더에 서비스 또는 워크로드를 쿼리하면 앱 지원 폴더에 연결된 모든 프로젝트의 모든 서비스 및 워크로드가 자동으로 반환됩니다.
    3. 앱 사용 설정 폴더를 다른 조직으로 이동하면 등록된 모든 서비스와 워크로드가 분리됩니다.
  3. App Hub 사용자를 App Hub 관리자, App Hub 편집자 또는 App Hub 뷰어로 지정합니다.
  4. 여러 워크로드와 서비스를 구성할 수 있는 애플리케이션을 만듭니다.
    다음에 유의하세요.
    1. 앱 지원 폴더 및 위치에 애플리케이션의 고유한 이름이 있는지 확인하세요.
    2. 프로젝트는 여러 애플리케이션이 있는 앱 지원 폴더에 연결될 수 있지만 개별 리소스는 하나의 애플리케이션에만 등록될 수 있습니다.
    3. 프로젝트가 다른 폴더 또는 조직으로 이동하면 애플리케이션은 앱 지원 폴더에 계속 존재하며 서비스와 워크로드는 분리된 상태로 유지됩니다.
  5. 서비스 및 워크로드를 쿼리하고 애플리케이션에 등록합니다. 애플리케이션을 만든 후 앱 지원 폴더에서 사용 가능한 서비스 및 워크로드를 쿼리할 수 있습니다. 쿼리는 앱 지원 폴더 및 앱 지원 폴더에 연결된 모든 프로젝트에 대해 실행됩니다. 또한 해당 프로젝트의 모든 서비스 및 워크로드가 반환됩니다. 다음에 유의하세요.
    1. 서비스 또는 워크로드는 단일 애플리케이션에만 등록할 수 있습니다.
    2. 특정 리전의 서비스와 워크로드를 동일한 리전의 지역 애플리케이션 또는 글로벌 애플리케이션에 등록해야 합니다. 다음 안내 및 명령어는 모든 리소스가 동일한 리전에 있다고 가정합니다. 지정할 수 있는 리전에 대한 자세한 내용은 위치를 참고하세요.
    3. 등록된 서비스 및 워크로드는 기본 인프라 리소스에 대한 업데이트의 영향을 받지 않습니다. 즉, 서비스 및 워크로드로 작동하는 기본 리소스를 삭제하는 경우 App Hub는 애플리케이션에서 연결된 워크로드 및 서비스를 삭제하지 않습니다. 워크로드 또는 서비스를 별도로 등록 취소해야 합니다.

기본 요건

App Hub를 설정하기 전에 다음 작업을 완료하세요.

  1. 관리 프로젝트의 결제 계정을 활성화하거나 만들기 위해 필요한 IAM 역할이 있는지 확인합니다.
  2. 기존 폴더를 선택하거나 애플리케이션 관리를 사용 설정할 수 있는 새 폴더를 만듭니다. 폴더를 만드는 방법에 관한 자세한 내용은 폴더 만들기를 참고하세요.
  3. App Hub 관리자, App Hub 편집자, App Hub 뷰어와 같이 App Hub의 Identity and Access Management (IAM) 역할을 보유할 개인 사용자를 결정했는지 확인합니다. 역할 및 권한에 관한 자세한 내용은 App Hub 역할 및 권한을 참고하세요.

필요한 역할

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

  • 애플리케이션을 만들고 업데이트하고 서비스와 워크로드를 등록 및 등록 취소하려면 다음 단계를 따르세요.
  • 폴더에서 앱 관리를 사용 설정하려면 다음 단계를 따르세요. 폴더 관리자 (resourcemanager.folderAdmin)
  • 애플리케이션 관리를 지원하는 Google Cloud 서비스에서 애플리케이션, 서비스, 워크로드 및 해당 속성을 조회하려면 다음 단계를 따르세요. App Hub 관리 보기 도구 (roles/apphub.appManagementViewer)
    애플리케이션 데이터를 한곳에서 조회하는 방법에 관한 자세한 내용은 Cloud Hub 개요를 참고하세요.

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

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

애플리케이션 관리 사용 설정

이 섹션에서는 폴더를 선택하고 폴더에서 애플리케이션 관리를 사용 설정합니다. 폴더에 애플리케이션 관리를 구성할 때 사용 설정 프로세스에는 다음 작업이 포함됩니다.

  • 폴더에 새 관리 프로젝트를 만듭니다. 관리 프로젝트는 Google에서 소유하며 이동하거나 삭제할 수 없는 프로젝트입니다. 앱 지원 폴더에는 하나의 관리 프로젝트만 연결할 수 있습니다. 관리 프로젝트는 앱 지원 폴더와 연결된 모든 하위 프로젝트의 할당량과 결제를 관리하는 데 사용됩니다.
  • 애플리케이션 관리를 지원하는 App Hub 및 Gemini Cloud Assist와 같은 서비스에 API를 사용 설정합니다.

  1. Google Cloud 콘솔에서 App Hub 페이지로 이동합니다.

    App Hub로 이동

  2. 다음 시나리오에 따라 단계를 따르세요.

    • 앱이 사용 설정되지 않은 Google Cloud 프로젝트 또는 Google Cloud폴더에 있는 경우 다음 단계를 따르세요.
      1. 폴더 선택을 클릭합니다.
      2. 폴더 선택 대화상자에서 앱 지원 폴더를 선택합니다. 앱 지원 폴더에 관한 정보가 필요한 경우 관리자에게 문의하세요. 앱이 사용 설정되지 않은 폴더를 선택했고 폴더 관리자 (resourcemanager.folderAdmin) IAM 역할이 있는 경우 폴더에서 애플리케이션 관리를 사용 설정합니다. 자세한 내용은 폴더에서 애플리케이션 관리 및 API 사용 설정을 참고하세요.
    • 앱이 사용 설정된 Google Cloud 폴더에 있는 경우 이 페이지에서 App Hub 사용자 지정으로 이동합니다.

    폴더에서 애플리케이션 관리를 사용 설정하면 다음 형식 FOLDER_DISPLAY_NAME-mp의 관리 프로젝트라는 Google 소유 프로젝트가 생성됩니다. 관리 프로젝트는 앱 지원 폴더의 하위 프로젝트를 호스팅하고 교차 프로젝트 기능을 관리하는 데 도움이 됩니다. 이제 이 앱 지원 폴더에서 하위 프로젝트의 App Hub 애플리케이션을 만들 수 있습니다.

  3. 선택사항: 이 관리 프로젝트에서 공유 VPC를 사용 설정합니다. 자세한 내용은 App Hub에서 VPC 서비스 제어 사용을 참고하세요.

  4. 선택사항: 프로젝트를 만들거나 다른 폴더에서 앱 지원 폴더로 프로젝트를 이동할 수 있습니다. 그런 다음 앱 지원 폴더에서 애플리케이션을 만들어 프로젝트의 서비스와 워크로드를 관리할 수 있습니다. 프로젝트 만들기에 관한 자세한 내용은 프로젝트 만들기를 참고하세요. 프로젝트를 이동하는 방법에 관한 자세한 내용은 프로젝트 이동을 참고하세요.

App Hub 사용자 지정

프로젝트 생성자에게는 기본 소유자 역할(roles/owner)이 부여됩니다. 기본적으로 이 IAM 역할에는 대부분의Google Cloud 리소스에 대한 전체 액세스에 필요한 권한이 포함됩니다.

프로젝트 생성자가 아니면 프로젝트에서 적합한 주 구성원에 대해 필수 권한을 부여해야 합니다. 예를 들어 주 구성원은 Google 계정 (최종 사용자)이거나 서비스 계정 (애플리케이션 및 컴퓨팅 워크로드)일 수 있습니다. 튜토리얼을 완료하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

콘솔

  1. Google Cloud 콘솔에서 IAM 페이지로 이동합니다.

    IAM으로 이동

  2. 상단 탐색 메뉴의 프로젝트 선택기에 앱 지원 폴더가 표시되는지 확인합니다. 범위 선택기를 사용하면 작업 중인 조직, 폴더, 프로젝트를 확인할 수 있습니다. 앱 지원 폴더에 있지 않은 경우 다음 단계에 따라 앱 지원 폴더를 선택합니다.

    1. 범위 선택기에서 선택한 옵션을 클릭합니다.
    2. 리소스 선택 대화상자에서 다음 중 하나를 수행합니다.
      • 폴더 목록에서 FOLDER_DISPLAY_NAME 폴더를 선택합니다.
      • FOLDER_DISPLAY_NAME 폴더를 검색한 다음 선택합니다.

  3. IAM 페이지에서 액세스 권한 부여를 클릭합니다. 액세스 권한 부여 창이 열립니다.

  4. 새 주 구성원 필드에 App Hub를 관리할 담당자의 이메일 주소, 즉 앱 지원 폴더의 App Hub 관리자 역할을 입력합니다.

  5. 역할 선택을 클릭하고 필터 필드에 App Hub를 입력합니다.

  6. App Hub 관리자 역할을 선택하고 저장을 클릭합니다.

  7. 이 단계를 반복하여 앱 관리 뷰어 역할을 개인 사용자에게 부여하여 앱 관리를 지원하는Google Cloud 서비스 전반에서 애플리케이션 데이터와 속성을 볼 수 있도록 합니다. 이 역할은 앱 지원 폴더의 모든 프로젝트 및 하위 폴더에 걸쳐 사용자에게 부여됩니다.

  8. 저장을 클릭합니다.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 최신 버전의 Google Cloud CLI가 설치되어 있는지 확인합니다. Cloud Shell에서 다음 명령어를 실행합니다.

    gcloud components update

  3. App Hub를 관리할 개인 사용자에게 앱 지원 폴더의 App Hub 관리자 역할을 부여합니다. 각 관리자에 대해 다음 명령어를 반복합니다. 애플리케이션을 만들려면 App Hub 관리자 역할이 있어야 합니다.

    gcloud projects add-iam-policy-binding MANAGEMENT_PROJECT_ID \
    --member='user:MANAGEMENT_PROJECT_ADMIN' \
    --role='roles/apphub.admin'

    다음을 바꿉니다.

    • MANAGEMENT_PROJECT_ID: google-mpf-FOLDER_ID 형식의 관리 프로젝트 ID입니다. 관리 프로젝트 ID는 Google Cloud 콘솔의 Identity and Access Management (IAM) 및 관리자 설정 페이지에서 확인할 수 있습니다. 관리 프로젝트 ID를 찾을 수 없는 경우 앱이 사용 설정된 폴더에 있지 않을 수 있습니다. 프로젝트 선택기에서 앱 지원 폴더를 선택합니다.
    • MANAGEMENT_PROJECT_ADMIN: 프로젝트에서 App Hub 관리자 역할을 가진 사용자입니다. 이 값은 username@yourdomain 형식입니다(예: robert.smith@example.com).

  4. 앱 관리를 지원하는 Google Cloud 서비스 전반에서 애플리케이션 데이터와 속성을 볼 수 있도록 개인 사용자에게 앱 지원 폴더의 앱 관리 보기 권한을 부여합니다. 이 역할은 앱 지원 폴더의 모든 프로젝트 및 하위 폴더에 걸쳐 사용자에게 부여됩니다.

    gcloud resource-manager folders add-iam-policy-binding FOLDER_ID \
    --member='user:MANAGEMENT_PROJECT_ADMIN' \
    --role='roles/apphub.appManagementViewer'

    FOLDER_ID를 프로젝트의 ID로 바꿉니다. 앱 사용 설정 폴더 ID는 Google Cloud 콘솔의 IAM 및 관리자 설정 페이지에서 확인할 수 있습니다. 폴더가 앱에서 사용 설정되려면 설정 페이지에 관리 프로젝트 ID가 표시되어야 합니다. 관리 프로젝트 ID를 찾을 수 없는 경우 앱이 사용 설정된 폴더에 있지 않을 수 있습니다. 프로젝트 선택기에서 앱 지원 폴더를 선택합니다.

애플리케이션 만들기

아직 애플리케이션이 없는 경우 서비스 및 워크로드를 위한 컨테이너가 될 애플리케이션을 만듭니다. 앱 지원 폴더의 서비스 및 워크로드 범위에 따라 전역 또는 리전 애플리케이션을 만듭니다.

  • 전역 애플리케이션을 사용하면 리전 및 전역 Google Cloud 리소스에서 검색된 서비스와 워크로드를 등록할 수 있습니다.
  • 리전 애플리케이션을 사용하면 리전별 Google Cloud 리소스에서 검색된 서비스와 워크로드를 등록할 수 있습니다.

애플리케이션을 만든 후에는 애플리케이션 범위를 변경할 수 없습니다. 전역 및 리전 애플리케이션에 대한 자세한 내용은 전역 및 리전 App Hub 애플리케이션을 참고하세요.

콘솔

  1. 앱이 사용 설정된 폴더에 있는지 확인합니다.

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

    애플리케이션으로 이동

  3. 애플리케이션 만들기를 클릭합니다.

  4. 애플리케이션 만들기 페이지의 애플리케이션 리전 및 이름 선택 창에서 애플리케이션에 등록하려는 서비스 및 워크로드의 범위에 따라 다음 중 하나를 수행합니다.

    • 전역 위치에서 서비스와 워크로드를 등록할 수 있는 애플리케이션을 만들려면 전역을 선택합니다.

    • 단일 위치에서 서비스와 워크로드를 등록할 수 있는 애플리케이션을 만들려면 다음 단계를 따르세요.

      1. 리전을 선택합니다.
      2. 리전을 선택합니다.

  5. 애플리케이션 이름을 입력하고 계속을 클릭합니다.

  6. 선택사항: 속성 추가 섹션에서 표시 이름을 입력합니다.

  7. 선택사항: 중요도 목록에서 애플리케이션의 중요도를 표시하려면 다음 중 하나를 선택합니다.

    • 미션 크리티컬
    • 높음
    • 중간
    • 낮음

  8. 선택사항: 환경 목록에서 소프트웨어 수명 주기 단계를 표시하려면 다음 중 하나를 선택합니다.

    • 프로덕션
    • 스테이징
    • 개발
    • 테스트

  9. 선택사항: 개발자 소유자, 운영자 소유자, 비즈니스 소유자의 필요에 따라 세부정보를 추가합니다. 표시 이름을 추가하는 경우 소유자의 이메일 주소를 입력해야 합니다.

    1. 소유자의 표시 이름을 입력합니다.
    2. 소유자의 이메일 주소를 입력합니다. 이 값은 username@yourdomain 형식이어야 합니다(예: 222larabrown@gmail.com).

  10. 각 개발자, 운영자, 비즈니스 소유자에 대해 이 단계를 반복합니다.

  11. 만들기를 클릭합니다.

gcloud

  1. APPLICATION_NAME이라는 새 애플리케이션을 만들고 표시 이름인 APPLICATION_DISPLAY_NAME을 지정합니다.

    gcloud apphub applications create APPLICATION_NAME \
    --display-name='APPLICATION_DISPLAY_NAME' \
    --scope-type=SCOPE_TYPE \
    --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: 애플리케이션의 이름입니다. 이름은 공백이 없는 소문자 영숫자 문자만 포함해야 합니다.
    • APPLICATION_DISPLAY_NAME: 애플리케이션의 표시 이름입니다.
    • SCOPE_TYPE: 애플리케이션에 등록할 수 있는 서비스 및 워크로드를 정의하는 애플리케이션 범위입니다. 다음 중 한 가지 값을 사용합니다.
      • REGIONAL
      • GLOBAL
    • 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).
    • MANAGEMENT_PROJECT_ID: google-mpf-FOLDER_ID 형식의 관리 프로젝트 ID입니다.
    • REGION: 애플리케이션의 리전입니다. --scope-type에 따라 값을 us-east1 또는 global로 지정합니다.

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

    gcloud apphub applications create my-application \
    --display-name='application-display-name' \
    --scope-type=REGIONAL \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=host-project \
    --location=us-east1

  2. 앱 지원 폴더에 애플리케이션을 나열합니다.

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

    출력은 다음과 비슷합니다.

    ID                DISPLAY_NAME              CREATE_TIME
APPLICATION_NAME  APPLICATION_DISPLAY_NAME  2023-10-31T18:33:48

서비스 및 워크로드 등록

인프라 서비스 및 워크로드를 애플리케이션에 등록하면 서비스 및 워크로드는 App Hub 리소스로 등록됩니다. 전역 애플리케이션을 사용하여 전역 리소스 또는 여러 리전에 분산된 리소스를 등록합니다. 리전 애플리케이션을 사용하여 애플리케이션과 동일한 리전의 리소스를 등록합니다.

콘솔

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

    애플리케이션으로 이동

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

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

    1. 서비스 및 워크로드 탭에서 서비스/워크로드 등록을 클릭합니다.
    2. 서비스 또는 워크로드 등록 페이지의 리소스 선택 창에서 찾아보기를 클릭하여 서비스 또는 워크로드를 리소스로 선택합니다.
    3. 리소스 선택 창에서 서비스 또는 워크로드를 선택하고 선택을 클릭합니다.
    4. 리소스 선택 창에서 서비스 또는 워크로드의 이름을 입력하고 계속을 클릭합니다.
    5. 필요한 경우 속성 추가 창의 다음 필드에 서비스 또는 워크로드에 대한 세부정보를 추가합니다. 자세한 내용은 이 문서에서 애플리케이션 만들기를 참고하세요. 중요도 및 환경 필드의 값은 애플리케이션을 만들 때 설정한 값과 다를 수 있습니다.
    6. 계속을 클릭합니다.
    7. 선택적으로 소유자 추가 섹션에서 다음 필드에 서비스 또는 워크로드 소유자에 대한 세부정보를 추가합니다. 자세한 내용은 이 문서에서 애플리케이션 만들기를 참고하세요.
    8. 등록을 클릭합니다.

서비스 및 워크로드 탭에 등록된 서비스 또는 워크로드가 표시됩니다. 등록 상태에 대한 자세한 내용은 App Hub의 속성 및 속성을 참고하세요.

gcloud

  1. 앱이 사용 설정된 폴더에서 탐색된 서비스를 나열합니다. 다음 명령어에서 선택적으로 filter 플래그를 지정하여 애플리케이션에 등록할 수 있는 지정된 프로젝트의 서비스를 반환합니다.

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

    FILTER_RESOURCES을 다음과 같은 필터로 바꿉니다.

    • service_properties.gcp_project=projects/PROJECT_ID
    • service_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules" 출력은 다음과 비슷합니다.
    ID                           SERVICE_REFERENCE                                                                                                                    SERVICE_PROPERTIES
[DISCOVERED_SERVICE_ID]    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/forwarding-rule'}     {'gcpProject': 'projects/PROJECT_1', 'location': 'REGION'}

    다음 단계에서 사용할 출력에서 서비스 ID DISCOVERED_SERVICE_ID를 복사합니다.

  2. 프로젝트의 전달 규칙 forwarding-rule-name를 애플리케이션에 서비스로 등록합니다.

    gcloud apphub applications services create SERVICE_NAME \
    --discovered-service='projects/MANAGEMENT_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE' \
    --display-name='SERVICE_DISPLAY_NAME' \
    --application=APPLICATION_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: 서비스를 등록할 이름입니다.
    • DISCOVERED_SERVICE_ID: 이전 단계 출력의 서비스 ID입니다.
    • SERVICE_DISPLAY_NAME: 애플리케이션의 표시 이름입니다.

    참고:

    • criticality-type 및 environment-type: (선택사항) 지정된 값 중 하나를 제공해야 하지만 이 값은 애플리케이션을 만들 때 설정한 값과 다를 수 있습니다. 자세한 내용은 이 문서에서 애플리케이션 만들기를 참고하세요.
    • developer-owners,operator-owners, business-owners: (선택사항) 자세한 내용은 이 문서에서 애플리케이션 만들기를 참고하세요.

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

    gcloud apphub applications services create my-service \
    --display-name='mywebserver-service' \
    --application=my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --folder=folder-ID \
    --location=us-east1

  3. 앱 지원 폴더에서 발견된 워크로드를 나열합니다. 다음 명령어에서 선택적으로 filter 플래그를 지정하여 애플리케이션에 등록할 수 있는 지정된 프로젝트의 워크로드를 반환합니다.

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

    FILTER_RESOURCES을 workload_properties.gcp_project=projects/PROJECT_ID과 같은 필터로 바꿉니다.

    등록되지 않은 MIG가 포함된 다음과 유사한 출력이 표시됩니다.

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

    다음 단계에서 사용할 출력에서 워크로드 ID를 복사합니다.

  4. 프로젝트의 MIG mig-name를 애플리케이션에 워크로드로 등록합니다.

    gcloud apphub applications workloads create WORKLOAD_NAME \
    --discovered-workload='projects/MANAGEMENT_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID' \
    --display-name=WORKLOAD_DISPLAY_NAME' \
    --application=APPLICATION_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: 워크로드를 등록할 이름입니다.
    • DISCOVERED_WORKLOAD_ID: 이전 단계의 출력의 워크로드 ID입니다.
    • WORKLOAD_DISPLAY_NAME: 애플리케이션의 표시 이름입니다.

    참고:

    • criticality-type 및 environment-type: (선택사항) 지정된 값 중 하나를 제공해야 하지만 이 값은 애플리케이션을 만들 때 설정한 값과 다를 수 있습니다. 자세한 내용은 이 문서에서 애플리케이션 만들기를 참고하세요.
    • developer-owners,operator-owners, business-owners: (선택사항) 자세한 내용은 이 문서에서 애플리케이션 만들기를 참고하세요.

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

    gcloud apphub applications workloads create my-workload \
    --display-name='mywebserver-deployment1' \
    --application=my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --folder=folder-ID \
    --location=us-east1

App Hub 설정 절차가 완료되었습니다.

프로젝트 추가 또는 삭제

프로젝트 연결을 수정하여 다양한 인프라 리소스를 애플리케이션으로 그룹화하게 할 수 있습니다.

콘솔

앱 지원 폴더에 프로젝트 추가

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Click Create project.

  3. Name your project. Make a note of your generated project ID.

  4. Edit the other fields as needed.

  5. Click Create.

앱 지원 폴더에서 프로젝트 삭제

  1. In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

gcloud

앱 지원 폴더에 프로젝트 추가

gcloud projects create PROJECT_ID \
    --folder FOLDER_ID

앱 지원 폴더에서 프로젝트 삭제

    Delete a Google Cloud project:

    gcloud projects delete PROJECT_ID

다음 단계