Mengelola katalog

Saat Anda membuat template aplikasi dan mengimpor template komponen di ruang, template Anda dapat diakses oleh anggota ruang lainnya. Dokumen ini membantu Anda membagikan template di luar ruang dengan memublikasikan template ke katalog, dan membagikan katalog tersebut ke ruang yang sesuai.

Setiap ruang berisi satu katalog tempat Anda dapat menambahkan template dan mengontrol berbagi. Anda dapat membagikan katalog dari ruang yang Anda buat di folder yang mendukung aplikasi awal ke ruang di folder yang mendukung aplikasi turunan.

Untuk mengetahui langkah-langkah pembuatan ruang turunan, lihat Membuat ruang.

Sebelum memulai

Anda harus memiliki peran Application Design Center Admin (roles/designcenter.admin) di folder yang mendukung aplikasi atau project pengelolaan.

Memublikasikan template aplikasi ke katalog

Sebelum Anda dapat membagikan template ke ruang lain, publikasikan template ke katalog Anda.

Kanvas desain

  1. Dari menu navigasi, klik Katalog.

    Buka Katalog

  2. Klik Tambahkan template.

  3. Di area Tambahkan template ke Katalog Default, lakukan hal berikut:

    1. Untuk menemukan template tertentu, ketik nama template di kolom Filter.
    2. Untuk menambahkan template ke katalog ini, di kolom Tindakan, klik Tambahkan ke katalog.
  4. Klik Done. Ruang yang memiliki akses ke katalog memiliki akses ke template yang dipilih.

  5. Untuk membagikan katalog, lihat Membagikan katalog dengan spasi.

gcloud CLI

  1. Identifikasi ID katalog untuk katalog tempat Anda ingin menambahkan template.

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

    Ganti kode berikut:

    • PROJECT: Project ID pengelolaan Anda.
    • LOCATION: Region katalog.
    • SPACE: ID ruang Anda.

    Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces catalogs list.

  2. Identifikasi ID template untuk template yang ingin Anda tambahkan ke katalog. Misalnya, perintah berikut mencantumkan template aplikasi.

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

    Ganti kode berikut:

    • PROJECT: Project ID pengelolaan Anda.
    • LOCATION: Region katalog.
    • SPACE: ID ruang Anda.
    • FILTER: Filter untuk membantu Anda mempersempit hasil penelusuran. Misalnya, "displayName:my-app-template*"

    Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces application-templates list.

  3. Lakukan penerapan template aplikasi.

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

    Ganti kode berikut:

    • TEMPLATE: ID template untuk template yang akan di-commit.
    • PROJECT: Project ID pengelolaan Anda.
    • LOCATION: Region template aplikasi.
    • SPACE: ID ruang Anda.

    Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces application-templates commit.

  4. Salin output name dari perintah commit. Anda akan menentukan nama ini sebagai nilai application-template-revision-source saat membuat revisi template katalog.

  5. Pastikan template aplikasi belum ada di katalog.

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

    Ganti kode berikut:

    • CATALOG: ID katalog Anda. Contoh, default-catalog.
    • PROJECT: Project ID pengelolaan Anda.
    • LOCATION: Region katalog.
    • SPACE: ID ruang Anda.

    Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces catalogs templates list.

  6. Jika template aplikasi tidak ada dalam katalog, buat template katalog.

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

    Ganti kode berikut:

    • CATALOG_TEMPLATE: ID template katalog untuk template katalog yang ingin Anda buat.
    • PROJECT: Project ID pengelolaan Anda.
    • LOCATION: Region katalog.
    • SPACE: ID ruang Anda.
    • CATALOG: ID katalog Anda.
    • TEMPLATE_CATEGORY: Kategori template. Contoh, application-template.

    Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces catalogs templates create.

  7. Buat revisi template katalog. Tindakan ini akan membuat revisi pertama, yang digunakan developer sebagai sumber untuk aplikasi.

    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
    

    Ganti kode berikut:

    • REVISION: ID revisi untuk revisi yang ingin Anda buat. Contoh, r1.
    • PROJECT: Project ID pengelolaan Anda.
    • LOCATION: Region katalog.
    • SPACE: ID ruang Anda.
    • CATALOG: ID katalog Anda.
    • CATALOG_TEMPLATE: ID template.
    • APPLICATION_TEMPLATE_REVISION_SOURCE: Sumber revisi template aplikasi. Anda menyalin nilai ini saat melakukan commit template aplikasi. Contoh, projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1.

    Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces catalogs templates revisions create.

Membagikan template yang direvisi

Jika Anda membuat perubahan pada template, perubahan tersebut tidak akan otomatis dipublikasikan ke katalog. Untuk membagikan revisi terbaru, publikasikan template ke katalog lagi.

Menghapus template dari katalog

Jika Anda tidak ingin lagi membagikan template tertentu ke ruang, hapus template tersebut dari katalog.

Kanvas desain

  1. Dari menu navigasi, klik Katalog.

    Buka Katalog

  2. Untuk mengelola template dalam katalog ini, klik Templates in catalog.

  3. Untuk menghapus template, klik Tindakan, lalu pilih Hapus dari katalog.

    1. Di kolom, masukkan nama template.
    2. Klik Hapus.

gcloud CLI

Menghapus template dari katalog Anda.

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

Ganti kode berikut:

  • CATALOG_TEMPLATE: ID template katalog untuk template yang ingin Anda hapus dari katalog.
  • CATALOG: ID katalog Anda.
  • PROJECT: Project ID pengelolaan Anda.
  • LOCATION: Region katalog.
  • SPACE: ID ruang Anda.

Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces catalogs templates delete.

Membagikan katalog ke ruang

Anda dapat membagikan katalog dari ruang awal ke ruang turunan. Misalnya, Anda dapat membuat katalog template aplikasi yang relevan dengan seluruh organisasi Anda dan membagikannya ke semua ruang.

Untuk mengetahui langkah-langkah pembuatan ruang turunan, lihat Membuat ruang.

Untuk membagikan katalog Anda ke ruang, lakukan hal berikut:

Kanvas desain

  1. Dari menu navigasi, klik Katalog.

    Buka Katalog

  2. Klik Bagikan katalog.

  3. Di kolom Filter, masukkan nama ruang tempat Anda ingin membagikan katalog.

  4. Di tabel Ruang, di kolom Tindakan, klik Bagikan katalog.

    Pengguna dapat melihat template dari katalog bersama dengan membuka ruang mereka di Pusat Desain Aplikasi dan mengklik Template bersama dari menu navigasi.

gcloud CLI

Membagikan katalog ke ruang.

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

Ganti kode berikut:

  • SHARE: ID berbagi untuk berbagi yang ingin Anda hapus.
  • PROJECT: Project ID pengelolaan Anda.
  • SPACE: ID ruang Anda.
  • LOCATION: Region katalog.
  • CATALOG: ID katalog untuk katalog yang Anda bagikan.
  • DESTINATION_SPACE: Nama ruang yang sepenuhnya memenuhi syarat untuk ruang yang Anda bagikan. Contoh, projects/my-project/locations/us-central1/spaces/my-space.

Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces catalogs shares create.

Berhenti membagikan katalog ke ruang

Jika Anda tidak ingin lagi membagikan katalog ke ruang, hentikan berbagi katalog dengan melakukan hal berikut:

Kanvas desain

  1. Dari menu navigasi, klik Katalog.

    Buka Katalog

  2. Klik Ruang yang dibagikan dengan.

  3. Untuk berhenti membagikan katalog ini ke ruang, klik

    Tindakan, lalu pilih Berhenti berbagi.

    1. Di kolom, masukkan nama ruang.
    2. Klik Berhenti berbagi.

gcloud CLI

Berhenti membagikan katalog dengan ruang.

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

Ganti kode berikut:

  • SHARE: ID berbagi untuk berbagi yang ingin Anda hapus.
  • PROJECT: Project ID pengelolaan Anda.
  • LOCATION: Region katalog.
  • SPACE: ID ruang Anda.
  • CATALOG: ID katalog untuk katalog yang Anda bagikan.

Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces catalogs shares delete.

Mengedit metadata katalog

Untuk mengelola katalog, Anda dapat memberinya nama dan deskripsi yang deskriptif dengan melakukan hal berikut:

Kanvas desain

  1. Dari menu navigasi, klik Katalog.

    Buka Katalog

  2. Periksa detail katalog.

  3. Untuk mengubah Nama tampilan, lakukan hal berikut:

    1. Klik Edit Nama tampilan.
    2. Di kolom Nama tampilan, masukkan nama baru.
    3. Klik Simpan.
  4. Untuk mengubah Deskripsi, lakukan hal berikut:

    1. Klik Edit Deskripsi.
    2. Di kolom Deskripsi, masukkan deskripsi baru.
    3. Klik Simpan.

gcloud CLI

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

Ganti kode berikut:

  • CATALOG: ID katalog Anda.
  • PROJECT: Project ID pengelolaan Anda.
  • LOCATION: Region katalog.
  • SPACE: ID ruang Anda.
  • DESCRIPTION: Deskripsi katalog.
  • DISPLAY_NAME: Nama tampilan katalog.

Untuk mengetahui informasi selengkapnya, lihat gcloud design-center spaces catalogs update.

Langkah berikutnya