애플리케이션 설정 모델을 선택할 때 관리 프로젝트에서 App Hub 애플리케이션의 애플리케이션 관리 경계를 정의합니다. 그런 다음 이 경계 내의 애플리케이션에 서비스와 워크로드를 등록할 수 있습니다. 애플리케이션 관리 관행을 도입하기 위한 권장 사용 사례는 애플리케이션 수명 주기 관리 준비를 참고하세요.
구성 드리프트를 방지하고 명확한 신뢰할 수 있는 소스를 유지하려면 원래 정의된 환경에서 애플리케이션 구성요소를 관리하는 것이 좋습니다.
App Design Center 템플릿에서 배포된 애플리케이션의 경우: App Design Center를 사용하여 애플리케이션을 관리하고 업데이트합니다. 애플리케이션 디자인을 변경하려면 템플릿을 수정하고, 애플리케이션 및 구성요소 세부정보와 같은 설정을 업데이트하려면 애플리케이션 수정사항을 만드세요.
App Hub에서 기존 리소스를 등록하여 생성된 애플리케이션의 경우: App Hub 내에서 직접 애플리케이션, 서비스, 워크로드를 관리합니다.
이 페이지에서는 앱 허브 내에 직접 등록된 애플리케이션을 관리하는 방법을 설명합니다.Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 이러한 작업을 수행할 수 있습니다. 템플릿에서 배포된 애플리케이션의 경우 App Design Center 문서를 참고하세요.
시작하기 전에
이 문서에서는 지원되는 리소스가 등록된 애플리케이션이 있다고 가정합니다.
필요한 역할
App Hub에서 애플리케이션을 관리하는 데 필요한 권한을 얻으려면 관리자에게 애플리케이션 관리 경계를 정의하는 관리 프로젝트에 대해 다음 IAM 역할을 부여해 달라고 요청하세요.
-
애플리케이션 업데이트 및 삭제:
App Hub 편집자 (
roles/apphub.editor) -
애플리케이션 보기:
App Hub 뷰어 (
roles/apphub.viewer)
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
App Hub 역할에 대한 자세한 내용은 App Hub IAM 역할 및 권한을 참고하세요.
애플리케이션 나열
다음 단계에 따라 애플리케이션 관리 경계 내의 모든 애플리케이션을 나열하고 필터링합니다.
콘솔
Google Cloud 콘솔에서 프로젝트 선택 도구를 사용하여 관리 프로젝트를 선택합니다.
App Hub에서 애플리케이션 페이지로 이동합니다.
페이지에 애플리케이션 목록이 표시됩니다.
목록을 필터링하려면 필터 필드를 사용하세요. 중요도 또는 환경과 같은 속성으로 필터링할 수 있습니다.
gcloud
관리 프로젝트의 프로젝트 ID를 찾습니다.
다음 옵션 중 하나를 사용하여 애플리케이션 목록을 표시합니다.
모든 애플리케이션을 나열합니다.
gcloud apphub applications list \ --project=PROJECT_ID \ --location=LOCATION다음을 바꿉니다.
PROJECT_ID: 관리 프로젝트의 ID입니다.LOCATION: 애플리케이션의 위치입니다. 전역 애플리케이션의 경우global를 사용하고 리전 애플리케이션의 경우 특정 리전(예:us-east1)을 사용합니다.
--filter플래그를 사용하여 속성을 기반으로 애플리케이션 목록을 필터링합니다.gcloud apphub applications list \ --project=PROJECT_ID \ --location=LOCATION \ --filter=FILTER_EXPRESSION \다음을 바꿉니다.
PROJECT_ID: 관리 프로젝트의 ID입니다.LOCATION: 애플리케이션의 위치입니다. 전역 애플리케이션의 경우global를 사용하고 리전 애플리케이션의 경우 특정 리전(예:us-east1)을 사용합니다.FILTER_EXPRESSION: 속성을 지정하는 필터 표현식입니다. 예를 들어PRODUCTION환경 유형이 있는 모든 애플리케이션을 나열하려면attributes.environment.type=PRODUCTION을 사용합니다.
애플리케이션 세부정보 보기
속성 및 메타데이터를 비롯한 특정 애플리케이션의 세부정보를 보려면 다음 단계를 따르세요.
콘솔
Google Cloud 콘솔에서 프로젝트 선택 도구를 사용하여 관리 프로젝트를 선택합니다.
App Hub에서 애플리케이션 페이지로 이동합니다.
페이지에 애플리케이션 목록이 표시됩니다.
확인하려는 애플리케이션의 이름을 클릭합니다.
애플리케이션의 세부정보 탭이 표시됩니다.
gcloud
관리 프로젝트의 프로젝트 ID를 찾습니다.
애플리케이션을 설명합니다.
gcloud apphub applications describe APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION다음을 바꿉니다.
APPLICATION_NAME: 애플리케이션의 이름입니다. 애플리케이션을 만들 때 이 값을 지정합니다.PROJECT_ID: 관리 프로젝트의 ID입니다.LOCATION: 애플리케이션의 위치입니다. 전역 애플리케이션의 경우global를 사용하고 리전 애플리케이션의 경우 특정 리전(예:us-east1)을 사용합니다.
애플리케이션 속성 업데이트
애플리케이션이 생성된 후 속성을 수정하려면 다음 단계를 따르세요.
콘솔
Google Cloud 콘솔에서 프로젝트 선택 도구를 사용하여 관리 프로젝트를 선택합니다.
App Hub에서 애플리케이션 페이지로 이동합니다.
페이지에 애플리케이션 목록이 표시됩니다.
업데이트하려는 애플리케이션의 수정을 클릭합니다.
애플리케이션 수정 창에서 필요에 따라 필드를 수정합니다.
저장을 클릭합니다.
gcloud
관리 프로젝트의 프로젝트 ID를 찾습니다.
애플리케이션 속성을 업데이트합니다.
display-name,criticality-type,environment-type, 소유자와 같은 변경 가능한 속성을 업데이트할 수 있습니다.gcloud apphub applications update 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다음을 바꿉니다.
- 필수:
APPLICATION_NAME: 애플리케이션의 이름입니다. 애플리케이션을 만들 때 이 값을 지정합니다. - 필수:
PROJECT_ID: 관리 프로젝트의 ID입니다. - 필수:
LOCATION: 애플리케이션의 위치입니다. 전역 애플리케이션의 경우global를 사용하고 리전 애플리케이션의 경우 특정 리전(예:us-east1)을 사용합니다. - 선택사항:
DISPLAY_NAME: 애플리케이션의 표시 이름입니다. 선택사항:
CRITICALITY_LEVEL: 애플리케이션의 중요도 수준입니다. 다음 중 한 가지 값을 사용합니다.MISSION_CRITICALHIGHMEDIUMLOW
선택사항:
ENVIRONMENT: 소프트웨어 수명 주기의 단계입니다. 다음 중 한 가지 값을 사용합니다.PRODUCTIONSTAGINGDEVELOPMENTTEST
선택사항:
DEV_NAME및DEV_EMAIL: 개발자 소유자의 표시 이름과 이메일 주소입니다.선택사항:
OPERATOR_NAME및OPERATOR_EMAIL: 작업자 소유자의 표시 이름과 이메일 주소입니다.선택사항:
BUSINESS_NAME및BUSINESS_EMAIL: 비즈니스 소유자의 표시 이름과 이메일 주소입니다.
- 필수:
Terraform
Terraform으로 애플리케이션 속성을 업데이트하려면 구성 파일의 google_apphub_application 리소스 블록 내에서 인수를 수정합니다. 변경사항을 적용하면 Terraform에서 새 구성과 일치하도록 애플리케이션을 업데이트합니다.
다음 예시에서는 us-central1의 리전 애플리케이션의 심각도 및 환경 속성을 업데이트합니다.
resource "google_apphub_application" "example" {
project = "my-project-id"
location = "us-central1"
application_id = "my-application"
display_name = "My Application"
description = "This application represents our platform."
attributes {
criticality {
type = "HIGH" # Updated criticality
}
environment {
type = "PRODUCTION"
}
# ... other attributes
}
}
애플리케이션 삭제
애플리케이션을 삭제하려면 먼저 모든 서비스와 워크로드를 등록 취소해야 합니다. 그런 다음 다음 단계에 따라 애플리케이션을 삭제합니다.
콘솔
Google Cloud 콘솔에서 프로젝트 선택 도구를 사용하여 관리 프로젝트를 선택합니다.
App Hub에서 애플리케이션 페이지로 이동합니다.
페이지에 애플리케이션 목록이 표시됩니다.
삭제하려는 애플리케이션의 이름을 클릭합니다.
서비스 및 워크로드 탭으로 이동하여 모든 애플리케이션 구성요소를 등록 취소했는지 확인합니다. 자세한 내용은 서비스 및 워크로드 등록 해제를 참고하세요.
모든 서비스와 워크로드가 등록 해제되면 애플리케이션 세부정보로 돌아가 삭제를 클릭합니다.
gcloud
관리 프로젝트의 프로젝트 ID를 찾습니다.
모든 애플리케이션 구성요소를 등록 해제했는지 확인합니다. 자세한 내용은 서비스 및 워크로드 등록 해제를 참고하세요.
등록된 구성요소가 없는 애플리케이션은 삭제합니다.
gcloud apphub applications delete APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION다음을 바꿉니다.
APPLICATION_NAME: 애플리케이션의 이름입니다. 애플리케이션을 만들 때 이 값을 지정합니다.PROJECT_ID: 관리 프로젝트의 ID입니다.LOCATION: 애플리케이션의 위치입니다. 전역 애플리케이션의 경우global를 사용하고 리전 애플리케이션의 경우 특정 리전(예:us-east1)을 사용합니다.
Terraform
Terraform으로 관리되는 애플리케이션을 삭제하려면 다음 옵션을 사용하세요.
- 구성에서 리소스 삭제: Terraform 파일에서
google_apphub_application리소스 블록을 삭제한 후terraform apply를 실행합니다. Terraform은 리소스가 더 이상 구성에 없음을 인식하고 프로젝트에서 삭제합니다. - 모든 리소스 종료:
terraform destroy명령어를 실행하여 애플리케이션을 비롯한 Terraform 구성에서 관리하는 모든 리소스를 종료합니다.