Private Catalog quickstart

Introduction

With Private Catalog, cloud admins can make their solutions discoverable to their internal enterprise users. Cloud admins can manage their solutions and ensure their users are always launching the latest versions.

What you learn

  • How to access and use Private Catalog as a cloud admin
  • How to access and use Private Catalog as a user

Before you begin

  • You must have a Google Cloud organization and access to the organization.
  • You must have the administrator role for your Google Cloud organization.
  • You must have the Catalog admin role for Private Catalog. For more information, see Access control.

Before you begin

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. In the Cloud Console, on the project selector page, select or create a Cloud project.

    Go to the project selector page

  3. Make sure that billing is enabled for your Google Cloud project. Learn how to confirm billing is enabled for your project.

  4. Enable the Deployment Manager and Compute Engine APIs.

    Enable the APIs

Create a catalog

  1. Go to the Cloud Console Private Catalog page.
    Go to the Private Catalog page
  2. Click Manage Solutions.
  3. Click Create Catalog.
  4. Enter a name for the catalog and a description.
  5. Click Create.

The following screenshot illustrates creating catalog:

Create a catalog

Now you're in your new catalog, and you can begin to add solutions. A solution can be based on a Cloud Deployment Manager template, or it can be a reference link (URL). In this step, you add a link-based solution.

  1. Click Add Link Solution.
  2. Enter a name for your solution, a description, and a tagline. The tagline is the short description shown on the tile in the end-user Private Catalog view.
  3. Optionally, upload an icon for the solution.
  4. Optionally enter a support link and contact information for the creator.
  5. Optionally, add a link to the documentation for the solution.
  6. Click Add.

The following screenshot illustrates adding a link-based solution:

Form to create a link-based solution

Share your catalog

End users can only see catalogs that are shared to the organization, folder, or project that the end user has access to.

  1. Return to the list of catalogs by clicking the Back arrow.

    List of Private Catalog solutions
  2. From the list of catalogs, select the checkbox next to the catalog that you want to share.

  3. Click the more options (ellipsis) button.

  4. Click Share Catalog.

    Share a catalog button
  5. From the dropdown menu, select a folder, organization, or project that you want to share the catalog with, and then click Select.

If you're sharing a catalog with a new project, the end user is prompted to enable the Cloud Deployment Manager API and the Private Catalog API when launching a solution.

View the catalog

As a user, you can view solutions from catalogs that have been shared with you.

Users see a union of solutions from all the catalogs they have access to in their Google Cloud hierarchy.

  1. Go to the Cloud Console Private Catalog page.
    Go to the Private Catalog page

Solutions that have been shared with your organization appear in the main panel.

  1. In Private Catalog, choose a project, and click a solution.

  2. Click Go to link.

    This takes you to a link outside of the Google domain where you can download a solution.

Clean up

To avoid unnecessary Google Cloud charges, use the Cloud Console to delete your project if you no longer need it.

What's next