카탈로그 관리, 게시, 공유

공간에서 애플리케이션 템플릿 을 만들고 구성요소 템플릿 을 가져오면 다른 공간 구성원이 템플릿에 액세스할 수 있습니다. 이 문서에서는 템플릿을 카탈로그에 게시하고 해당 카탈로그를 적절한 공간과 공유하여 공간 외부에서 템플릿을 공유하는 방법을 설명합니다.

각 공간에는 템플릿을 추가하고 공유를 제어할 수 있는 단일 카탈로그가 포함되어 있습니다. 초기 애플리케이션 관리 경계에서 만든 공간의 카탈로그를 다른 애플리케이션 관리 경계의 공간과 공유할 수 있습니다.

시작하기 전에

카탈로그를 관리하기 전에 다음을 수행하세요.

  • 앱 지원 폴더 또는 관리 프로젝트에 App Design Center 관리자 (roles/designcenter.admin) 역할이 있어야 합니다.

  • App Design Center 초기 설정 을 완료합니다.

  • 초기 공간 외에 공간을 만들려면 공간 관리를 참고하세요.

카탈로그에 애플리케이션 템플릿 게시

다른 공간과 템플릿을 공유하려면 먼저 템플릿을 카탈로그에 게시하세요.

디자인 캔버스

  1. 탐색 메뉴에서 카탈로그 를 클릭합니다.

    카탈로그로 이동

  2. 템플릿 추가 를 클릭합니다.

  3. 기본 카탈로그에 템플릿 추가 영역에서 다음을 수행합니다.

    1. 특정 템플릿을 찾으려면 필터 필드에 템플릿 이름을 입력합니다.
    2. 이 카탈로그에 템플릿을 추가하려면 작업 열에서 카탈로그에 추가 를 클릭합니다.

  4. 완료 를 클릭합니다. 카탈로그에 액세스할 수 있는 공간은 선택한 템플릿에 액세스할 수 있습니다.

  5. 카탈로그를 공유하려면 공간과 카탈로그 공유 를 참고하세요.

gcloud CLI

  1. 템플릿을 추가할 카탈로그의 카탈로그 ID를 확인합니다.

    gcloud design-center spaces catalogs list \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

    다음을 바꿉니다.

    • PROJECT: 관리 프로젝트 ID
    • LOCATION: 카탈로그 리전
    • SPACE: 공간 ID

    자세한 내용은 gcloud design-center spaces catalogs list를 참고하세요.

  2. 카탈로그에 추가할 템플릿의 템플릿 ID를 확인합니다. 예를 들어 다음 명령어는 애플리케이션 템플릿을 나열합니다.

    gcloud design-center spaces application-templates list \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--filter=FILTER

    다음을 바꿉니다.

    • PROJECT: 관리 프로젝트 ID
    • LOCATION: 카탈로그 리전
    • SPACE: 공간 ID
    • FILTER: 검색 결과를 좁히는 데 도움이 되는 필터입니다. 예를 들어 "displayName:my-app-template*"입니다.

    자세한 내용은 gcloud design-center spaces application-templates list를 참고하세요.

  3. 애플리케이션 템플릿을 커밋합니다.

     gcloud design-center spaces application-templates commit TEMPLATE \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE

    다음을 바꿉니다.

    • TEMPLATE: 커밋할 템플릿의 템플릿 ID
    • PROJECT: 관리 프로젝트 ID
    • LOCATION: 애플리케이션 템플릿 리전
    • SPACE: 공간 ID

    자세한 내용은 gcloud design-center spaces application-templates commit을 참고하세요.

  4. 커밋 명령어의 name 출력을 복사합니다. 카탈로그 템플릿 버전을 만들 때 이 이름을 application-template-revision-source 값으로 지정합니다.

  5. 애플리케이션 템플릿이 카탈로그에 아직 없는지 확인합니다.

    gcloud design-center spaces catalogs templates list \
--catalog=CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

    다음을 바꿉니다.

    • CATALOG: 카탈로그 ID 예를 들어 default-catalog입니다.
    • PROJECT: 관리 프로젝트 ID
    • LOCATION: 카탈로그 리전
    • SPACE: 공간 ID

    자세한 내용은 gcloud design-center spaces catalogs templates list를 참고하세요.

  6. 애플리케이션 템플릿이 카탈로그에 없으면 카탈로그 템플릿을 만듭니다.

    gcloud design-center spaces catalogs templates create CATALOG_TEMPLATE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG \
--template-category=TEMPLATE_CATEGORY

    다음을 바꿉니다.

    • CATALOG_TEMPLATE: 만들려는 카탈로그 템플릿의 카탈로그 템플릿 ID
    • PROJECT: 관리 프로젝트 ID
    • LOCATION: 카탈로그 리전
    • SPACE: 공간 ID
    • CATALOG: 카탈로그 ID
    • TEMPLATE_CATEGORY: 템플릿 카테고리 예를 들어 application-template입니다.

    자세한 내용은 gcloud design-center spaces catalogs templates create를 참고하세요.

  7. 카탈로그 템플릿 버전을 만듭니다. 이렇게 하면 개발자가 애플리케이션의 소스로 사용하는 첫 번째 버전이 생성됩니다.

    gcloud design-center spaces catalogs templates revisions create REVISION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG \
--template=CATALOG_TEMPLATE \
--application-template-revision-source=APPLICATION_TEMPLATE_REVISION_SOURCE

    다음을 바꿉니다.

    • REVISION: 만들려는 버전의 버전 ID 예를 들어 r1입니다.
    • PROJECT: 관리 프로젝트 ID
    • LOCATION: 카탈로그 리전
    • SPACE: 공간 ID
    • CATALOG: 카탈로그 ID
    • CATALOG_TEMPLATE: 템플릿 ID
    • APPLICATION_TEMPLATE_REVISION_SOURCE: 애플리케이션 템플릿 버전 소스 애플리케이션 템플릿을 커밋할 때 이 값을 복사했습니다. 예를 들어 projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1입니다.

    자세한 내용은 gcloud design-center spaces catalogs templates revisions create를 참고하세요.

수정된 템플릿 공유

템플릿을 변경해도 변경사항이 카탈로그에 자동으로 게시되지 않습니다. 최신 버전을 공유하려면 템플릿을 카탈로그에 다시 게시하세요.

카탈로그에서 템플릿 삭제

더 이상 특정 템플릿을 공간과 공유하지 않으려면 카탈로그에서 삭제하세요.

디자인 캔버스

  1. 탐색 메뉴에서 카탈로그 를 클릭합니다.

    카탈로그로 이동

  2. 이 카탈로그의 템플릿을 관리하려면 카탈로그의 템플릿 을 클릭합니다.

  3. 템플릿을 삭제하려면 작업을 클릭하고 카탈로그에서 삭제를 선택합니다.

    1. 필드에 템플릿 이름을 입력합니다.
    2. 삭제 를 클릭합니다.

gcloud CLI

카탈로그에서 템플릿을 삭제합니다.

gcloud design-center spaces catalogs templates delete CATALOG_TEMPLATE \
--catalog=CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

다음을 바꿉니다.

  • CATALOG_TEMPLATE: 카탈로그에서 삭제할 템플릿의 카탈로그 템플릿 ID
  • CATALOG: 카탈로그 ID
  • PROJECT: 관리 프로젝트 ID
  • LOCATION: 카탈로그 리전
  • SPACE: 공간 ID

자세한 내용은 gcloud design-center spaces catalogs templates delete를 참고하세요.

공간과 카탈로그 공유

소스 공간과 동일한 리전에 있지만 다른 애플리케이션 관리 경계에 있는 대상 공간과만 카탈로그를 공유할 수 있습니다.

공간과 카탈로그를 공유하려면 다음 단계를 따르세요.

디자인 캔버스

  1. 탐색 메뉴에서 카탈로그 를 클릭합니다.

    카탈로그로 이동

  2. 카탈로그 공유 를 클릭합니다.

  3. 공유 대상 필드에서 대상 공간이 다음 중 하나에 있는지 선택합니다.

    • 폴더: 폴더 수준 애플리케이션 관리 경계
    • 프로젝트: 프로젝트 수준 애플리케이션 관리 경계

  4. 프로젝트/폴더 ID 필드에 대상 공간이 있는 애플리케이션 관리 경계의 프로젝트 또는 폴더 ID를 입력합니다.

    시작 공간과 동일한 리전의 공간이 공간 이름 필드에 자동으로 채워집니다.

  5. 공유 를 클릭합니다.

    개발자는 App Design Center에서 공간을 열고 탐색 메뉴에서 공유 템플릿 을 클릭하여 공유 카탈로그의 템플릿을 볼 수 있습니다.

gcloud CLI

공간과 카탈로그를 공유합니다.

gcloud design-center spaces catalogs shares create SHARE \
--project=PROJECT \
--space=SPACE \
--location=LOCATION \
--catalog=CATALOG \
--destination-space=DESTINATION_SPACE

다음을 바꿉니다.

  • SHARE: 삭제할 공유의 공유 ID
  • PROJECT: 관리 프로젝트 ID
  • SPACE: 공간 ID
  • LOCATION: 카탈로그 리전
  • CATALOG: 공유 중인 카탈로그의 카탈로그 ID
  • DESTINATION_SPACE: 공유 중인 공간의 정규화된 공간 이름 예를 들어 projects/my-project/locations/us-central1/spaces/my-space입니다.

자세한 내용은 gcloud design-center spaces catalogs shares create를 참고하세요.

공간과 카탈로그 공유 중지

더 이상 공간과 카탈로그를 공유하지 않으려면 다음 단계를 따라 카탈로그 공유를 중지하세요.

디자인 캔버스

  1. 탐색 메뉴에서 카탈로그 를 클릭합니다.

    카탈로그로 이동

  2. 공유된 공간 을 클릭합니다.

  3. 공간과 이 카탈로그의 공유를 중지하려면

    작업 을 클릭하고 공유 중지 를 선택합니다.

    1. 필드에 공간 이름을 입력합니다.
    2. 공유 중지 를 클릭합니다.

gcloud CLI

공간과 카탈로그 공유를 중지합니다.

gcloud design-center spaces catalogs shares delete SHARE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG

다음을 바꿉니다.

  • SHARE: 삭제할 공유의 공유 ID
  • PROJECT: 관리 프로젝트 ID
  • LOCATION: 카탈로그 리전
  • SPACE: 공간 ID
  • CATALOG: 공유 중인 카탈로그의 카탈로그 ID

자세한 내용은 gcloud design-center spaces catalogs shares delete를 참고하세요.

카탈로그 메타데이터 수정

카탈로그를 관리하려면 다음 단계를 따라 카탈로그에 설명 이름과 설명을 지정하세요.

디자인 캔버스

  1. 탐색 메뉴에서 카탈로그 를 클릭합니다.

    카탈로그로 이동

  2. 카탈로그 세부정보를 살펴봅니다.

  3. 표시 이름을 수정하려면 다음 단계를 따르세요.

    1. 표시 이름 수정을 클릭합니다.
    2. 표시 이름 필드에 새 이름을 입력합니다.
    3. 저장 을 클릭합니다.

  4. 설명을 수정하려면 다음 단계를 따르세요.

    1. 설명 수정 을 클릭합니다.
    2. 설명 필드에 새 설명을 입력합니다.
    3. 저장 을 클릭합니다.

gcloud CLI 

gcloud design-center spaces catalogs update CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--description=DESCRIPTION \
--display-name=DISPLAY_NAME

다음을 바꿉니다.

  • CATALOG: 카탈로그 ID
  • PROJECT: 관리 프로젝트 ID
  • LOCATION: 카탈로그 리전
  • SPACE: 공간 ID
  • DESCRIPTION: 카탈로그 설명
  • DISPLAY_NAME: 카탈로그 표시 이름

자세한 내용은 gcloud design-center spaces catalogs update를 참고하세요.

다음 단계

  • 애플리케이션 템플릿을 디자인하여 자체 구성을 정의합니다.
  • 애플리케이션을 관리하여 리소스를 업데이트, 확장, 삭제하는 방법을 알아봅니다.
  • 구성요소를 가져와 템플릿 디자인에서 자체 Terraform 모듈을 사용합니다.