App Hub를 설정하면 애플리케이션의 관리 경계가 생성됩니다. 이 경계는 설정 모델에 따라 관리 프로젝트 또는 애플리케이션 관리를 위해 구성한 호스트 및 서비스 프로젝트의 모음입니다. 서비스 및 워크로드는 이 관리 경계 내에서 애플리케이션으로 등록됩니다.
구성 드리프트를 방지하고 명확한 신뢰할 수 있는 소스를 유지하려면 원래 정의된 환경에서 애플리케이션 리소스를 관리하는 것이 좋습니다.
App Design Center 템플릿에서 배포된 애플리케이션의 경우: App Design Center를 사용하여 애플리케이션을 관리하고 업데이트합니다. 애플리케이션 디자인을 변경하려면 템플릿을 수정하고, 애플리케이션 및 구성요소 세부정보와 같은 설정을 업데이트하려면 애플리케이션 수정사항을 만드세요.
App Hub에 리소스를 등록하여 생성된 애플리케이션의 경우: App Hub 내에서 애플리케이션, 서비스, 워크로드를 직접 관리합니다.
이 페이지에서는 App Hub 내에서 직접 검색되거나 등록된 서비스 및 워크로드를 애플리케이션으로 관리하는 방법을 설명합니다. Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 이러한 작업을 실행할 수 있습니다. 템플릿에서 배포된 애플리케이션의 경우 App Design Center 문서를 참고하세요.
시작하기 전에
App Hub에서 서비스와 워크로드를 보고, 업데이트하고, 등록 해제하려면 다음 단계를 완료하세요.
- 지원되는 설정 모델 중 하나를 사용하여 앱 허브를 설정합니다.
- 지원되는 리소스를 애플리케이션에 등록
필요한 역할
App Hub에서 서비스와 워크로드를 관리하는 데 필요한 권한을 얻으려면 관리자에게 설정 모델 (관리 프로젝트 또는 호스트 및 서비스 프로젝트)의 애플리케이션 관리 경계에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
서비스 및 워크로드 업데이트 및 등록 해제:
App Hub 편집자 (
roles/apphub.editor
) -
서비스 및 워크로드 보기:
App Hub 뷰어 (
roles/apphub.viewer
)
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
App Hub 역할에 대한 자세한 내용은 App Hub IAM 역할 및 권한을 참고하세요.
서비스 및 워크로드 보기
App Hub 관리 경계 내에서 검색되고 등록된 모든 서비스와 워크로드를 보려면 다음 단계를 따르세요.
콘솔
Google Cloud 콘솔의 시작하기 페이지에서 프로젝트 선택기를 사용하여 관리 프로젝트 또는 호스트 프로젝트를 선택합니다.
App Hub 서비스 및 워크로드 페이지로 이동합니다.
이 페이지에는 검색되고 등록된 모든 서비스와 워크로드 목록이 표시됩니다.
필터 필드를 사용하여 환경 또는 등록 상태와 같은 속성으로 결과를 좁힙니다.
gcloud
관리 프로젝트 또는 호스트 프로젝트의 프로젝트 ID를 찾습니다.
탐색된 리소스 나열
검색된 리소스를 애플리케이션에 등록할 수 있습니다. 검색된 리소스를 나열하려면 다음 단계를 따르세요.
탐색된 서비스 나열:
gcloud apphub discovered-services list \ --project=PROJECT_ID \ --location=LOCATION
다음을 바꿉니다.
PROJECT_ID
: 호스트 프로젝트 또는 관리 프로젝트의 ID입니다.LOCATION
: 리소스를 검색할 위치입니다. 전역 리소스에는global
을 사용하고 리전 리소스에는us-east1
과 같은 특정 리전을 사용합니다.
탐색된 워크로드를 나열합니다.
gcloud apphub discovered-workloads list \ --project=PROJECT_ID \ --location=LOCATION
등록된 리소스 나열
등록된 리소스는 애플리케이션의 일부입니다. 다음 단계에 따라 특정 애플리케이션의 등록된 리소스를 나열합니다. --filter
플래그를 사용하여 속성을 기반으로 목록을 필터링할 수 있습니다.
애플리케이션에 등록된 서비스를 나열합니다.
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
를 사용합니다.
애플리케이션에 등록된 워크로드를 나열합니다.
gcloud apphub applications workloads list \ --application=APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION \ --filter=FILTER_EXPRESSION
서비스 및 워크로드 속성 업데이트
다음 단계에 따라 애플리케이션에 등록된 서비스 및 워크로드의 사용자 정의 속성을 수정하세요.
콘솔
Google Cloud 콘솔의 시작하기 페이지에서 프로젝트 선택기를 사용하여 관리 프로젝트 또는 호스트 프로젝트를 선택합니다.
App Hub 애플리케이션 페이지로 이동합니다.
페이지에 애플리케이션 목록이 표시됩니다.
서비스 또는 워크로드 속성을 업데이트할 애플리케이션의 이름을 클릭합니다.
서비스 및 워크로드 탭에서 업데이트하려는 서비스 또는 워크로드의 이름을 찾습니다.
more_vert 더보기를 클릭한 다음 서비스 수정 또는 워크로드 수정을 클릭합니다.
열린 창에서 필요에 따라 필드를 수정하고 저장을 클릭합니다.
gcloud
관리 프로젝트 또는 호스트 프로젝트의 프로젝트 ID를 찾습니다.
서비스 또는 워크로드 속성을 업데이트합니다.
서비스 속성을 업데이트합니다.
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
: 비즈니스 소유자의 표시 이름과 이메일 주소입니다.
- 필수:
서비스 및 워크로드 등록 취소
서비스 또는 워크로드를 등록 취소하면 애플리케이션에서 삭제됩니다. 기본 리소스는 삭제되지 않으며 다시 검색된 리소스가 되어 다른 애플리케이션에 등록할 수 있습니다.
서비스와 워크로드를 등록 취소하려면 다음 단계를 따르세요.
콘솔
Google Cloud 콘솔의 시작하기 페이지에서 프로젝트 선택기를 사용하여 관리 프로젝트 또는 호스트 프로젝트를 선택합니다.
App Hub 애플리케이션 페이지로 이동합니다.
페이지에 애플리케이션 목록이 표시됩니다.
서비스 또는 워크로드의 등록을 취소할 애플리케이션의 이름을 클릭합니다.
서비스 및 워크로드 탭에서 등록 취소하려는 서비스 또는 워크로드의 이름을 클릭합니다.
리소스의 세부정보 페이지에서 등록 취소를 클릭합니다.
gcloud
관리 프로젝트 또는 호스트 프로젝트의 프로젝트 ID를 찾습니다.
서비스 또는 워크로드를 등록 취소합니다.
서비스를 등록 취소합니다.
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
을 등록 해제하려는 워크로드의 이름으로 바꿉니다.
모든 서비스와 워크로드를 등록 취소한 후 애플리케이션을 삭제할 수 있습니다.