카탈로그 관리

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

각 스페이스에는 템플릿을 추가하고 공유를 제어할 수 있는 단일 카탈로그가 포함되어 있습니다. 초기 앱 지원 폴더에서 만든 공간의 카탈로그를 하위 앱 지원 폴더의 공간에 공유할 수 있습니다.

하위 스페이스를 만드는 단계는 스페이스 만들기를 참고하세요.

시작하기 전에

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

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

다른 공간과 템플릿을 공유하려면 먼저 카탈로그에 템플릿을 게시해야 합니다.

디자인 캔버스

  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. 스페이스 표의 작업 열에서 카탈로그 공유를 클릭합니다.

    사용자는 앱 디자인 센터에서 자신의 공간을 열고 탐색 메뉴에서 공유 템플릿을 클릭하여 공유 카탈로그의 템플릿을 볼 수 있습니다.

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를 참고하세요.

다음 단계