Setting 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 [e-mail]. 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. Complete the Google 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 Google Cloud Marketplace

To create and publish your product in Google Cloud Marketplace, you use either Producer Portal or Partner Portal. Your Partner Engineer helps you determine which portal to use and enables it for you after you complete the Google Cloud Marketplace Project Info Form.

Producer Portal

Preview

This product or feature is covered by the Pre-GA Offerings Terms of the Google Cloud Terms of Service. Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.

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

• Product Details: Add listing and marketing info about your product.
• Open Source Compliance: Ensure that your solution complies with Google's policies for open source software.
• 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 Google 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 Google 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 Google 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 Google Cloud Marketplace—for example, my-organization-public.

   Note: If you don't see the link, or can't access the URL, verify that you have selected the correct project and have the Editor (roles/editor) role for the project. If you still can't access the URL, contact the Cloud Partners team at [e-mail].

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 Google Cloud Marketplace listing.

   Caution: The Product ID and product type cannot be changed after the product is created. You can change your product name before you submit it.

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

Partner Portal

To create your product's Google Cloud Marketplace entry:

1. Open Partner Portal in the Google Cloud Console:

   https://console.cloud.google.com/partner/solutions?project=YOUR_PUBLIC_PROJECT_ID
   

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

   Note: If you don't see the link, or can't access the URL, verify that you have the correct project selected. If you still can't access the URL, contact the Cloud Partners team at [e-mail].

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

3. Name your solution and check the solution ID. The solution ID is used in the URL for your Google Cloud Marketplace listing.

4. Under Solution Type, select VM deployment.

   Caution: The solution ID and solution type cannot be changed after the solution is created. You can change your product name before you submit the solution.

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

Add product details

Your product details include your product listing on Google 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:

Producer Portal

Preview

This product or feature is covered by the Pre-GA Offerings Terms of the Google Cloud Terms of Service. Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.

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 Google 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 Google Cloud Marketplace. You can select up to two Category IDs for a product.
4. Complete the Documentation and Product Metadata sections.

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

Partner Portal

1. Click the Solution ID.

   

2. Complete the Solution Details and Documentation & Support sections. While completing Solution Details, you can add Category IDs. Category IDs allow customers to find your product under select categories or filters as they search Google Cloud Marketplace. You can select up to two Category IDs for a solution.

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 Google 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.

Note: If a password is required to access an admin page or console, the password must be auto-generated.

The document should also outline how the customer:

• Can SSH into the VM instance

• Can access a list of licenses, along with source code, for any open source components on the 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 Google Cloud Marketplace:

• NGINX Getting Started Guide
• DataStax Getting Started Guide.

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.