Console
    Start free

    Manage, publish, and share catalogs

    When you create application templates and import component templates in a space, your templates can be accessed by other space members. This document helps you share templates outside of your space by publishing templates to a catalog, and sharing that catalog with appropriate spaces.

    Each space contains a single catalog where you can add templates and control sharing. You can share a catalog from the space that you created in your initial application management boundary to spaces in other application management boundaries.

    Before you begin

    To perform the tasks in this document, ask your administrator to grant you the necessary roles on the app-enabled folder or management project, as listed in the following table:

    Task Required roles
    Publish application templates to a space catalog Application Design Center Admin ( roles/designcenter.admin )
    Share a catalog with destination spaces Application Design Center Admin ( roles/designcenter.admin )

    For more information about roles, see Access control with IAM .

    Do the following before you manage catalogs:

    Publish an application template to a catalog

    Before you can share a template with other spaces, publish the template to your catalog.

    Design canvas

    1. From the navigation menu, click Catalogs.

      Go to Catalogs

    2. Click Add templates.

    3. In the Add templates to Default Catalogarea, do the following:

      1. To find a specific template, type the template name in the Filterfield.
      2. To add a template to this catalog, in the Actionscolumn, click Add to catalog.

    4. Click Done. The spaces that have access to the catalog have access to the selected templates.

    5. To share the catalog, see Share a catalog with a space .

    gcloud CLI

    1. Identify the catalog ID for the catalog where you want to add your template.

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

      Replace the following:

      • PROJECT : Your management project ID.
      • LOCATION : The catalog region.
      • SPACE : Your space ID.

      For more information, see gcloud design-center spaces catalogs list .

    2. Identify the template ID for the template that you want to add to your catalog. For example, the following command lists application templates.

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

      Replace the following:

      • PROJECT : Your management project ID.
      • LOCATION : The catalog region.
      • SPACE : Your space ID.
      • FILTER : A filter to help you narrow the search results. For example, "displayName:my-app-template*"

      For more information, see gcloud design-center spaces application-templates list .

    3. Commit the application template.

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

      Replace the following:

      • TEMPLATE : The template ID for the template to commit.
      • PROJECT : Your management project ID.
      • LOCATION : The application template region.
      • SPACE : Your space ID.

      For more information, see gcloud design-center spaces application-templates commit .

    4. Copy the name output from the commit command. You'll specify this name as the application-template-revision-source value when you create your catalog template revision.

    5. Make sure that the application template is not already in the catalog.

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

      Replace the following:

      • CATALOG : Your catalog ID. For example, default-catalog .
      • PROJECT : Your management project ID.
      • LOCATION : The catalog region.
      • SPACE : Your space ID.

      For more information, see gcloud design-center spaces catalogs templates list .

    6. If the application template isn't in the catalog, create the catalog template.

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

      Replace the following:

      • CATALOG_TEMPLATE : The catalog template ID for the catalog template that you want to create.
      • PROJECT : Your management project ID.
      • LOCATION : The catalog region.
      • SPACE : Your space ID.
      • CATALOG : Your catalog ID.
      • TEMPLATE_CATEGORY : The template category. For example, application-template .

      For more information, see gcloud design-center spaces catalogs templates create .

    7. Create a catalog template revision. This creates the first revision, which developers use as a source for an application.

       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

      Replace the following:

      • REVISION : The revision ID for the revision that you want to create. For example, r1 .
      • PROJECT : Your management project ID.
      • LOCATION : The catalog region.
      • SPACE : Your space ID.
      • CATALOG : Your catalog ID.
      • CATALOG_TEMPLATE : The template ID.
      • APPLICATION_TEMPLATE_REVISION_SOURCE : The application template revision source. You copied this value when you committed your application template. For example, projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1 .

      For more information, see gcloud design-center spaces catalogs templates revisions create .

    If you make changes to a template, those changes are not automatically published to the catalog. To share the latest revision, publish the template to the catalog again.

    Remove templates from a catalog

    If you no longer want to share a specific template with a space, remove it from the catalog.

    Design canvas

    1. From the navigation menu, click Catalogs.

      Go to Catalogs

    2. To manage the templates in this catalog, click Templates in catalog.

    3. To remove a template, click Actionsand select Remove from catalog.

      1. In the field, enter the name of the template.
      2. Click Remove.

    gcloud CLI

    Remove a template from your catalog.

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

    Replace the following:

    • CATALOG_TEMPLATE : The catalog template ID for the template that you want to remove from the catalog.
    • CATALOG : Your catalog ID.
    • PROJECT : Your management project ID.
    • LOCATION : The catalog region.
    • SPACE : Your space ID.

    For more information, see gcloud design-center spaces catalogs templates delete .

    You can only share a catalog with a destination space that is in the same region as the source space, but located in a different application management boundary .

    To share your catalog with a space, do the following:

    Design canvas

    1. From the navigation menu, click Catalogs.

      Go to Catalogs

    2. Click Share catalog.

    3. From the Share withfield, select whether the destination space is in one of the following:

      • Folder: a folder-level application management boundary.
      • Project: a project-level application management boundary.

    4. In the Project/Folder IDfield, enter the project or folder ID for the application management boundary where the destination space resides.

      The space in the same region as your origination space automatically populates in the Space namefield.

    5. Click Share.

      Developers can view the templates from a shared catalog by opening their space in App Design Center and clicking Shared templatesfrom the navigation menu.

    gcloud CLI

    Share a catalog with a space.

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

    Replace the following:

    • SHARE : The share ID for the share that you want to delete.
    • PROJECT : Your management project ID.
    • SPACE : Your space ID.
    • LOCATION : The catalog region.
    • CATALOG : The catalog ID for the catalog that you're sharing.
    • DESTINATION_SPACE : The fully qualified space name for the space that you're sharing to. For example, projects/my-project/locations/us-central1/spaces/my-space .

    For more information, see gcloud design-center spaces catalogs shares create .

    Stop sharing a catalog with a space

    If you no longer want to share a catalog with a space, stop sharing the catalog by doing the following:

    Design canvas

    1. From the navigation menu, click Catalogs.

      Go to Catalogs

    2. Click Spaces shared with.

    3. To stop sharing this catalog with a space, click

      Actionsand select Stop sharing.

      1. In the field, enter the space name.
      2. Click Stop sharing.

    gcloud CLI

    Stop sharing a catalog with a space.

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

    Replace the following:

    • SHARE : The share ID for the share that you want to delete.
    • PROJECT : Your management project ID.
    • LOCATION : The catalog region.
    • SPACE : Your space ID.
    • CATALOG : The catalog ID for the catalog that you're sharing.

    For more information, see gcloud design-center spaces catalogs shares delete .

    Edit catalog metadata

    To manage your catalog, you can give it a descriptive name and description by doing the following:

    Design canvas

    1. From the navigation menu, click Catalogs.

      Go to Catalogs

    2. Examine the catalog details.

    3. To modify the Display name, do the following:

      1. Click Edit Display name.
      2. In the Display namefield, enter the new name.
      3. Click Save.

    4. To modify the Description, do the following:

      1. Click Edit Description.
      2. In the Descriptionfield, enter the new description.
      3. Click Save.

    gcloud CLI

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

    Replace the following:

    • CATALOG : Your catalog ID.
    • PROJECT : Your management project ID.
    • LOCATION : The catalog region.
    • SPACE : Your space ID.
    • DESCRIPTION : The catalog description.
    • DISPLAY_NAME : The catalog display name.

    For more information, see gcloud design-center spaces catalogs update .

    What's next
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: