Set up your Google Cloud environment

This page describes the steps to set up your Google Cloud environment for your virtual machine (VM) product, which includes creating a workspace and Google Cloud Marketplace listing for your product.

Set up your workspace

To set up your workspace, you create two Google Cloud projects:

  • A project for development and testing. For the project ID, use the format PARTNER_NAME-dev.
  • A project to create and host your final Compute Engine images. For the project ID, use the format PARTNER_NAME-public. Do not use this public project for anything other than hosting your Compute Engine images.

For steps to create projects, see Creating and managing Google Cloud projects.

After you create the projects, configure the projects and provide details to Google:

  1. For each project, grant the Editor (roles/editor) and Service Management Admin (roles/servicemanagement.admin) roles to cloud-commerce-marketplace-onboarding@twosync-src.google.com. Grant the Config Editor (roles/servicemanagement.configEditor) role to cloud-commerce-producer@system.gserviceaccount.com. For steps to grant access, see Granting,changing and revoking access to resources.

  2. For each project, enable the Compute Engine API to create and run VMs on Google Cloud.

    Enable the API

  3. In the public project only, set a security contact. For more information, see Managing contacts for notifications.

  4. Complete the Cloud Marketplace Project Info Form to provide high-level details about the projects and your product. You only need to complete this form once.

Create your product in Cloud Marketplace

To create and publish your product in Cloud Marketplace, you use Producer Portal. Your Partner Engineer enables it for you after you complete the Cloud Marketplace Project Info Form.

To publish your product in Producer Portal, you submit the following information for review:

  • Product Details: Add listing and marketing info about your product.
  • Pricing: Choose and specify your pricing model to determine how customers will pay you for your product.
  • Deployment Package: Submit details and specifications for the VM image that your customers deploy from Cloud Marketplace.

You can submit these reviews at any time and in any order. Some reviews might take up to two weeks for approval, so we recommend reviewing the requirements and getting started as early as possible.

At this stage, to proceed with the other reviews, you only need to create a Cloud Marketplace entry for your product. You can complete and submit the remaining product details for review at any time.

To create your product's Cloud Marketplace entry:

  1. Open Producer Portal in the Google Cloud console:

    https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
    

    Replace YOUR_PUBLIC_PROJECT_ID with the ID for the public project that you created for Cloud Marketplace—for example, my-organization-public.

  2. At the top of the page, click Add product.

  3. Select Virtual machine.

  4. Under Product name, name your product and check the Product ID. The Product ID is used in the URL for your Cloud Marketplace listing.

  5. Click Create. It might take a few seconds to create your product.

Add product details

Your product details include your product listing on Cloud Marketplace, marketing information, and links to documentation. You can start editing details now and submit for review later.

To provide information for your Product Details review:

  1. In the list of products, click the name of your product.

  2. Under Review: Product Details, click Edit.

  3. In the Product Info tab, complete the details that appear in your product listing on Cloud Marketplace:

    • Enter a name, tagline, image, and overview description for your product.
    • Select Category IDs to allow customers to find your product under product categories or filters as they search Cloud Marketplace. You can select up to two Category IDs for a product.
  4. Complete the Documentation and Product metadata sections. To make it easier for users to find your product in Cloud Marketplace, add search keywords in the Search keywords box. The keywords must meet the following requirements:

    • They must be directly relevant to your product.
    • They must not include brand names or product names licensed by competitors of your product.

It takes approximately 2-5 business days for the Partner Engineering team to review and approve your product details.

Create a Getting Started document

Every product must be accompanied by a Google Cloud-specific Getting Started document that helps your customers with detailed deployment and configuration steps for your product. The documentation must be created and maintained by you on your website. We suggest that you co-brand the page with the Google Cloud logo, available at the Partner Advantage site. (Note that Partner Advantage requires you to register to access the site.)

The document should provide step-by-step guidance for the customer's journey, starting with the product listing page on Cloud Marketplace and extending all the way through to the deployment and post-deployment maintenance of the product. We recommend including screenshots throughout the document, in addition to the text instructions.

The document should provide the customer with guidance on what inputs they must provide for a successful deployment, such as:

  • The recommended machine configuration, disk sizes, zones, and so on

  • If the customer has to open any ports (particularly 80 or 443)

  • Whether the required ports are opened by default, or the customer has to open them during the process of deployment

Add next steps

The document should list any additional commands needed to configure the product.

If your product requires a login, the document should outline if and how the customer will gain access to an admin page or console URL, and how login credentials can be obtained.

The document should also outline how the customer:

  • Can SSH into the VM instance

  • Can check the status or health of the app

For additional guidance, you can refer to these example pages that have been developed for other products in Cloud Marketplace:

Submit your document

After you have finished the draft of your Getting Started document, email the URL of your draft to your assigned Partner Engineer for review and feedback.