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

Console

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

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

      IAM으로 이동

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

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

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

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

gcloud

1. App Hub를 관리할 개인 사용자에게 역할을 부여하려면 필요에 따라 IAM 역할을 바꿔서 다음 명령어를 반복합니다.

   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 형식입니다(예: [email protected]).

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 이름으로 바꿉니다.

Console

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

   설정으로 이동

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

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

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

5. 닫기를 클릭합니다.

gcloud

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

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

Console

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

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

   애플리케이션으로 이동

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

4. 애플리케이션 만들기 페이지의 애플리케이션 리전 및 이름 선택 창에서 리전 목록으로 us- west1을 선택합니다.

5. 애플리케이션 이름 필드에 tutorial-application을 입력합니다.

6. 표시 이름, sample-application을 입력하고 계속을 클릭합니다.

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

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

9. 계속을 클릭합니다.

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

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

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

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

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

gcloud

1. 생성한 호스트 프로젝트를 선택합니다.

   gcloud config set project HOST_PROJECT_ID

2. us-west1 리전에 tutorial-application이라는 새 애플리케이션을 만들고 표시 이름을 Tutorial로 지정합니다.

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

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

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

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

   ID: tutorial-application
   DISPLAY_NAME: Tutorial
   CREATE_TIME: 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 형식이어야 합니다(예: [email protected]).

   참고:

   • 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'
   

Console

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

   애플리케이션으로 이동

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

3. 서비스 등록:

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

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

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

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

   1. 서비스 또는 워크로드 등록 창의 서비스 또는 워크로드 선택 섹션에서 워크로드 이름인 l7-xlb-backend-service를 선택하고 계속을 클릭합니다.
   2. 속성 추가 창에서 속성 이름인 sample-workload를 입력합니다.
   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 편집자 역할이 있는 사용자로 바꿉니다. 이 값은 username@yourdomain 형식입니다(예: [email protected]).

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

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

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

   ID: 71dd6fa4-5644-43ee-918f-c5fda03ffe24
   SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}
   SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   
   ID: fe831ba4-ec16-4eb8-9ea4-b394fd30f561
   SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}
   SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   
   ID: 637a3216-c6cc-410e-8bf9-83b7ef66a62f
   SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}
   SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   

   출력에서 다음 단계에 사용할 서비스 ID(예: 71dd6fa4-5644-43ee-918f-c5fda03ffe24)를 복사합니다.

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

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

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

   gcloud apphub applications services create sample-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: sample-service-backend
   DISPLAY_NAME: service-backend
   SERVICE_REFERENCE:  {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}
   CREATE_TIME: 2024-02-13T00:31:45
   
   ID: sample-service-forwarding-rule
   DISPLAY_NAME: service-forwarding-rule
   SERVICE_REFERENCE:  {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}
   CREATE_TIME: 2024-02-13T00:31:45
   
   ID: sample-service-url-map
   DISPLAY_NAME: url-map
   SERVICE_REFERENCE:  {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}
   CREATE_TIME: 2024-02-13T00:31:45
   

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

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

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

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

   ID: c9c08669-0fd2-4f7c-b2b1-2cf3c57662c2
   WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}
   WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1', 'zone': 'us-west1-a'}
   

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

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

   gcloud apphub applications workloads create sample-workload \
       --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: sample-workload
   DISPLAY_NAME: workload-instance-group
   WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}
   CREATE_TIME: 2024-02-13T00:31:45
   

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