단일 프로젝트를 사용하여 App Hub 애플리케이션 만들기

Console

튜토리얼을 완료하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 필수 IAM 역할을 부여해 달라고 요청하세요.

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

   IAM으로 이동

2. person_add액세스 권한 부여를 클릭합니다. 액세스 권한 부여 창이 열립니다.

3. 새 주 구성원 필드에 호스트 프로젝트의 App Hub 관리자 역할인 App Hub를 관리할 개인 사용자의 이메일 주소를 입력합니다.

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

5. App Hub 관리자 역할을 선택합니다.

6. 다른 역할 추가를 클릭하고 역할 선택 목록에서 모니터링 뷰어를 선택합니다.

7. 저장을 클릭합니다.

gcloud

1. App Hub를 사용할 개인 사용자에게 역할을 부여하려면 필요에 따라 IAM 역할을 바꿔서 다음 명령어를 반복합니다. 자세한 내용은 App Hub 역할 및 권한을 참조하세요.

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

   HOST_PROJECT_ADMIN을 호스트 프로젝트에서 App Hub 관리자 역할이 있는 사용자로 바꿉니다. 이 값은 username@yourdomain 형식입니다(예: 222larabrown@gmail.com).

2. 서비스 프로젝트의 App Hub 관리자 역할을 App Hub를 관리하는 개인 사용자에게 부여합니다. 서비스 프로젝트를 호스트 프로젝트에 추가하려면 App Hub 관리자 역할이 있어야 합니다. 서비스 프로젝트마다 이 역할을 가진 사람이 한 명 이상 있어야 합니다. 이 예시에서 호스트 프로젝트는 서비스 프로젝트 역할을 합니다.

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

   SERVICE_PROJECT_ID을 HOST_PROJECT_ID 이름으로 바꿉니다.

3. App Hub를 관리하는 개인 사용자에게 호스트 프로젝트의 모니터링 뷰어 역할을 부여합니다. 측정항목을 보려면 호스트 프로젝트에 모니터링 뷰어 역할이 있어야 합니다.

   gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \
      --member='user:HOST_PROJECT_ADMIN' \
      --role='roles/monitoring.viewer'

콘솔

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

   설정으로 이동

2. 설정 페이지에서 프로젝트 연결을 클릭합니다.

3. 열리는 창에서 프로젝트를 검색하거나 표시된 목록에서 App Hub 서비스 프로젝트의 체크박스를 선택합니다.

4. 선택을 클릭합니다. 연결된 서비스 프로젝트 테이블에는 선택한 호스트 프로젝트가 서비스 프로젝트로 표시됩니다.

5. 닫기를 클릭합니다.

gcloud

호스트 프로젝트를 App Hub 호스트 프로젝트에 서비스 프로젝트로 추가합니다.

gcloud apphub service-projects add HOST_PROJECT_ID \
  --project=HOST_PROJECT_ID

콘솔

1. App Hub 호스트 프로젝트에 있는지 확인합니다.

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

   애플리케이션으로 이동

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

4. 애플리케이션 만들기 페이지의 애플리케이션 리전 및 이름 선택 창에서 리전을 선택합니다.

5. 리전 목록에서 us-west1을 선택합니다.

6. 애플리케이션 이름 필드에 tutorial-application을 입력합니다. 이 이름은 고유 식별자이며 애플리케이션을 만든 후에는 변경할 수 없습니다.

7. 표시 이름, Tutorial을 입력하고 계속을 클릭합니다. 업데이트할 수 있는 사용자 친화적인 이름입니다. 자세한 내용은 기존 애플리케이션 업데이트를 참고하세요.

8. 속성 추가 창의 중요도 목록에서 높음을 선택합니다. 중요도는 애플리케이션, 서비스, 워크로드가 비즈니스 운영에 얼마나 중요한지를 나타냅니다.

9. 환경 필드에서 소프트웨어 수명 주기 단계를 표시하려면 프로덕션을 선택합니다.

10. 계속을 클릭합니다.

11. 소유자 추가 창에서 개발자 소유자, 운영자 소유자 및 비즈니스 소유자에 대해 다음 세부 정보를 추가합니다. 표시 이름을 추가하는 경우 소유자의 이메일 주소를 입력해야 합니다.

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

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

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

새 애플리케이션이 생성되고 애플리케이션 페이지에 표시됩니다.

gcloud

1. 만든 App Hub 호스트 프로젝트를 선택합니다.

   gcloud config set project HOST_PROJECT_ID

2. us-west1 리전에 tutorial-application이라는 새 애플리케이션을 만들고 표시 이름을 Tutorial로 지정합니다. 이 애플리케이션 이름(tutorial-application)은 고유 식별자이며 애플리케이션을 만든 후에는 변경할 수 없습니다. 표시 이름Tutorial 은 업데이트할 수 있는 사용자 친화적인 이름입니다. 자세한 내용은 기존 애플리케이션 업데이트를 참고하세요.

   gcloud apphub applications create tutorial-application \
       --display-name='Tutorial' \
       --scope-type=REGIONAL \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

3. App Hub 호스트 프로젝트의 애플리케이션을 나열합니다.

   gcloud apphub applications list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

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

   ID                    DISPLAY_NAME  CREATE_TIME
   tutorial-application  Tutorial      2023-10-31T18:33:48
   

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

   gcloud apphub applications update tutorial-application \
     --criticality-type='HIGH' \
     --environment-type='PRODUCTION' \
     --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=HOST_PROJECT_ID \
     --location=us-west1
   

   다음을 바꿉니다.

   • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR, DISPLAY-NAME-BUSINESS: 각각 개발자, 운영자, 비즈니스 소유자의 표시 이름입니다.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR, EMAIL-NAME-BUSINESS: 각각 개발자, 운영자, 비즈니스 소유자의 이메일 주소입니다. 이러한 값은 username@yourdomain 형식이어야 합니다(예: 222larabrown@gmail.com).

   참고:

   • criticality-type: 애플리케이션, 서비스, 워크로드가 비즈니스 운영에 얼마나 중요한지를 나타냅니다.
   • environment-type: 소프트웨어 수명 주기의 단계를 나타냅니다.

5. 생성한 애플리케이션의 세부정보를 가져옵니다.

   gcloud apphub applications describe tutorial-application \
     --project=HOST_PROJECT_ID \
     --location=us-west1
   

   이 명령어는 다음과 비슷한 YAML 형식의 정보를 반환합니다.

   attributes:
   businessOwners:
   – displayName: [DISPLAY-NAME-BUSINESS]
     email: [EMAIL-BUSINESS]
   criticality:
     type: HIGH
   developerOwners:
   – displayName: [DISPLAY-NAME-DEVELOPER]
     email: [EMAIL-DEVELOPER]
   environment:
     type: PRODUCTION
   operatorOwners:
   – displayName: [DISPLAY-NAME-OPERATOR]
     email: [EMAIL-OPERATOR]
   createTime: '2023-10-31T18:33:48.199394108Z'
   displayName: Tutorial
   name: projects/HOST_PROJECT_ID/locations/us-west1/applications/tutorial-application
   scope:
     type: REGIONAL
   state: ACTIVE
   uid: 9d991a9d-5d8a-4c0d-b5fd-85e39fb58c73
   updateTime: '2023-10-31T18:33:48.343303819Z'
   

콘솔

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

   애플리케이션으로 이동

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

3. 서비스를 등록합니다.

   1. 서비스 및 워크로드 탭에서 서비스/워크로드 등록을 클릭합니다.
   2. 서비스 또는 워크로드 등록 페이지의 리소스 선택 창에서 찾아보기를 클릭하여 서비스 또는 워크로드를 리소스로 선택합니다.
   3. 리소스 선택 창에서 서비스의 이름인 l7-xlb-backend-service를 선택하고 선택을 클릭합니다.
   4. 리소스 선택 창에서 리소스의 이름인 tutorial-service-backend를 입력합니다.
   5. 표시 이름, Backend service을 입력하고 계속을 클릭합니다.
   6. 속성 추가 창의 중요도 목록에서 애플리케이션의 중요도를 나타내려면 높음을 선택합니다.
   7. 환경 필드에서 소프트웨어 수명 주기 단계를 표시하려면 프로덕션을 선택합니다.
   8. 계속을 클릭합니다.
   9. 소유자 추가 창에서 개발자 소유자, 운영자 소유자, 비즈니스 소유자의 필요에 따라 세부정보를 추가합니다. 표시 이름을 추가하는 경우 소유자의 이메일 주소를 입력해야 합니다.
      1. 소유자의 표시 이름을 입력합니다.
      2. 소유자의 이메일 주소를 입력합니다. 이 값은 username@yourdomain 형식이어야 합니다(예: 222larabrown@gmail.com).
   10. 각 개발자, 운영자, 비즈니스 소유자에 대해 이 단계를 반복합니다.
   11. 등록을 클릭합니다.

   서비스 및 워크로드 탭의 등록된 서비스 및 워크로드 섹션에서 새 서비스가 추가된 것을 확인할 수 있습니다.

4. 이전 단계를 반복하여 다른 서비스를 각각 tutorial-service-forwarding-rule 및 tutorial-service-url-map으로 등록합니다.

5. 다음 예외를 제외하고 이전 단계를 반복해 서비스를 등록하여 워크로드를 등록합니다.

   1. 서비스 또는 워크로드 등록 창의 서비스 또는 워크로드 선택 섹션에서 워크로드 이름인 l7-xlb-backend-service를 선택하고 계속을 클릭합니다.
   2. 리소스 선택 창에서 리소스의 이름인 tutorial-workload-mig를 입력합니다.
   3. 표시 이름을 Workload instance group으로 입력하고 계속을 클릭합니다. 서비스 및 워크로드 탭의 등록된 서비스 및 워크로드 섹션에서 새 워크로드가 추가된 것을 확인할 수 있습니다.

gcloud

1. App Hub 편집자 권한이 있는 개인을 추가합니다.

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
     --member='user:APP_HUB_EDITOR' \
     --role='roles/apphub.editor'
   

   APP_HUB_EDITOR를 App Hub 호스트 프로젝트에서 App Hub 편집자 역할이 있는 사용자로 바꿉니다. 이 값은 username@yourdomain 형식입니다(예: 222larabrown@gmail.com).

2. App Hub 호스트 프로젝트에서 탐색된 모든 서비스를 나열합니다. 이 명령어는 애플리케이션에 등록할 수 있는 서비스를 반환합니다.

   gcloud apphub discovered-services list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

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

   ID                             SERVICE_REFERENCE                                                                                                              SERVICE_PROPERTIES
   BACKEND_SERVICE_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   FORWARDING_RULE_SERVICE_ID" {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   URL_MAP_SERVICE_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}             {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   

   출력에서 다음 단계에 사용할 서비스 ID(예: BACKEND_SERVICE_SP2_ID)를 복사합니다.

3. 이전 단계의 서비스를 애플리케이션에 등록합니다. 이전 단계의 출력 필드에서 서비스 ID를 복사합니다.

   gcloud apphub applications services create tutorial-service-backend \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/BACKEND_SERVICE_ID' \
       --display-name='Backend service' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   gcloud apphub applications services create tutorial-service-forwarding-rule \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/FORWARDING_RULE_SERVICE_ID' \
       --display-name='Forwarding rule' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   gcloud apphub applications services create tutorial-service-url-map \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/URL_MAP_SERVICE_ID' \
       --display-name='URL map' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   다음을 바꿉니다.

   • BACKEND_SERVICE_ID: 등록하려는 백엔드 서비스의 서비스 ID
   • FORWARDING_RULE_SERVICE_ID: 등록하려는 전달 규칙의 서비스 ID
   • URL_MAP_SERVICE_ID: 등록하려는 URL 맵의 서비스 ID

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

   gcloud apphub applications services list \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

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

   ID                               DISPLAY_NAME      SERVICE_REFERENCE                                                                                                              CREATE_TIME
   tutorial-service-backend         Backend service   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}  2024-02-13T00:31:45
   tutorial-service-forwarding-rule Forwarding rule   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}  2024-02-13T00:31:45
   tutorial-service-url-map         URL map           {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}             2024-02-13T00:31:45
   

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

5. App Hub 호스트 프로젝트에서 탐색된 모든 워크로드를 나열합니다. 이 명령어는 애플리케이션에 등록할 수 있는 워크로드를 반환합니다.

   gcloud apphub discovered-workloads list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

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

   ID                            WORKLOAD_REFERENCE                                                                                                            WORKLOAD_PROPERTIES
   INSTANCE_GROUP_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1', 'zone': 'us-west1-a'}
   

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

6. 이전 단계의 워크로드를 애플리케이션에 tutorial-workload-mig를 등록합니다. 이전 단계의 출력 필드에서 워크로드 ID를 복사합니다.

   gcloud apphub applications workloads create tutorial-workload-mig \
       --discovered-workload='projects/HOST_PROJECT_ID/locations/us-west1/discoveredWorkloads/WORKLOAD_ID' \
       --display-name='Workload instance group' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   WORKLOAD_ID를 등록하려는 워크로드의 ID로 바꿉니다.

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

   gcloud apphub applications workloads list \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

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

   ID                        DISPLAY_NAME              WORKLOAD_REFERENCE                                                                                                            CREATE_TIME
   tutorial-workload-mig     Workload instance group   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}  2024-02-13T00:31:45
   

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