Stay organized with collectionsSave and categorize content based on your preferences.
Create and verify a template
This quickstart helps you create and deploy a three-tier web application
template that includes frontend, backend, and database components. The following
image shows the design canvas, which includes the application components and
connections.
You design the template by doing one of the following:
Add and connect components on the design canvas in Application Design Center.
Use natural language prompts in Gemini Cloud Assist.
After you complete the design, verify the template by deploying a test
application in App Design Center.
To follow step-by-step guidance for this task directly in the
Google Cloud console, clickGuide me:
ClickCreate Templateand enter the following details:
In theTemplate IDfield, enterquickstart-three-tier-web-app.
In theTemplate Namefield, enterQuickstart three-tier web app.
In theDescriptionfield, enterA template to generate a three-tier web application.
ClickCreate template.
The template is created and the design canvas is displayed.
In theComponentsarea, click the following components to add them to
the design canvas:
Cloud Run(add two components)
Cloud SQL (PostgreSQL)
To create connections between components, do the following:
From the blue dot at the bottom ofcloud-run-1,
drag to the blue dot at the top ofcloud-run-2.
From the blue dot at the bottom ofcloud-run-2,
drag to the blue dot at the top ofsql-postgresql-1.
Your template contains three components. The canvas displays between
components to represent connections.
Gemini Cloud Assist
In the Google Cloud console toolbar, clicksparkOpen or close Gemini Cloud Assist chat.
TheCloud Assistpanel opens.
In Gemini Cloud Assist chat, enter the following prompt:
I want to create a three-tier web application.
Gemini Cloud Assist generates a basic design for a
three-tier web application.
To remove the load balancers and Secret Manager components, enter
the following prompt:
I don't need load balancers or Secret Manager.
Gemini Cloud Assist updates the design to remove the
components.
Review the updated design that includes the following components:
Cloud Run (two components)
Cloud SQL for PostgreSQL
ClickEdit app design.
TheCreate a new templatepage is displayed.
Enter the following template details:
In theTemplate IDfield, enterquickstart-three-tier-web-app.
In theTemplate Namefield, enterQuickstart three-tier web app.
In theDescriptionfield, enterA template to generate a three-tier web application.
ClickCreate template.
The system creates a new template and displays the design canvas.
Create an application draft
From the design canvas, clickConfigure an app.
ClickCreate new applicationand do the following:
In theNamefield, enterquickstart-three-tier-test.
In theDisplay Namefield, enterQuickstart three-tier test.
From theRegionlist, selectus-central1 (Iowa).
From theEnvironmentlist, selectTest.
From theCriticalitylist, selectLow.
In theScopearea, from theApplication scopelist, selectRegional.
ClickCreate Application.
The system creates the application draft.
Configure components
In the design canvas, clickcloud-run-1and do the following in theConfigurationarea:
From theProject IDlist, select the descendant project you created
inBefore you begin.
In theService Namefield, enterfrontend-service.
ClickSave.
In the design canvas, clickcloud-run-2and do the following in theConfigurationarea:
From theProject IDlist, select the descendant project you created
inBefore you begin.
In theService Namefield, enterbackend-service.
ClickSave.
In the design canvas, clicksql-postgresql-1and do the following in theConfigurationarea:
From theProject IDlist, select the descendant project you created
inBefore you begin.
In theNamefield, enterdatabase-postgresql.
From theDatabase Versionlist, selectPOSTGRES_15.
From theZonedrop-down list, selectus-central1-a.
ClickSave.
The canvas displays a green check mark in each component to convey that you
have specified the required parameters. You can now deploy the application
draft to theTestenvironment for verification.
Deploy the application
ClickDeploy.
In theSelect a service accountarea, do the following:
ClickCreate a new service account.
ClickProceed.
ClickDeploy.
After a few minutes, the system deploys the application and creates resources
in your project. The system displays the following details:
A link to App Hub, where you can view deployed resource details,
including links to monitoring dashboards.
Links to Cloud Build logs, which you can use to troubleshoot deployment
errors.
Outputs like service URIs are displayed, which you can use to interact with
deployed resources.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["Create and verify a template\n|\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\nThis quickstart helps you create and deploy a three-tier web application template that includes frontend, backend, and database components.\n\n\u003cbr /\u003e\n\nYou design the template by doing one of the following:\n\n- Add and connect components on the design canvas in Application Design Center.\n- Use natural language prompts in Gemini Cloud Assist.\n\nAfter you complete the design, verify the template by deploying a test\napplication in App Design Center.\n\nBefore you begin\n\n1. [Set up App Design Center](/application-design-center/docs/setup).\n\n2. [Create a descendant project](/resource-manager/docs/creating-managing-projects)\n in your app-enabled folder.\n\n You'll deploy Google Cloud resources to this\n project when you deploy your application.\n3. [Make sure that billing is enabled](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project) for your\n descendant project.\n\n4. Make sure that you grant your user account the following roles:\n\n 1. [Application Design Center Admin](/application-design-center/docs/access-control#role-descriptions) (`roles/designcenter.admin`) or\n [Application Design Center User](/application-design-center/docs/access-control#role-descriptions) (`roles/designcenter.user`) on the\n management project. These roles let you create a template.\n\n 2. [Application Admin](/application-design-center/docs/access-control#role-descriptions)\n (`roles/designcenter.applicationAdmin`) or [Application Editor](/application-design-center/docs/access-control#role-descriptions) (`roles/designcenter.applicationEditor`)\n on the management project. These roles let you deploy an application.\n\n 3. [Project IAM Admin](/resource-manager/docs/access-control-proj#resourcemanager.projectIamAdmin) (`roles/resourcemanager.projectIamAdmin`) on the descendant\n project. This role lets you create a service account during deployment.\n\n5. To use Gemini Cloud Assist to create your design, see [Set up Gemini Cloud Assist](/gemini/docs/cloud-assist/set-up-gemini).\n\nCreate a new template and add details\n\nUse the App Design Center design canvas or\nGemini Cloud Assist to design your template. \n\nDesign canvas\n\n1. In the Google Cloud console, go to the **Templates** page.\n\n [Go to Templates](https://console.cloud.google.com/products/design-center/templates)\n2. Click **Create template** and enter the following details:\n\n 1. In the **Template ID** field, enter `quickstart-three-tier-web-app`.\n\n 2. In the **Template name** field, enter `Quickstart three tier web app` .\n\n 3. In the **Description** field, enter `A template to generate a three tier web application`.\n\n 4. Click **Create template**.\n\n The template is created and the design canvas is displayed.\n3. In the **Components** area, click the following components to add them to\n the design canvas:\n\n - **Cloud Run** (add two components)\n - **Cloud SQL (PostgreSQL)**\n4. To create connections between components, do the following:\n\n 1. From the blue dot at the bottom of **cloud-run-1** ,\n drag to the blue dot at the top of **cloud-run-2**.\n\n 2. From the blue dot at the bottom of **cloud-run-2** ,\n drag to the blue dot at the top of **sql-postgresql-1**.\n\n Your template contains three components. Lines are displayed between\n components to represent connections.\n\nGemini Cloud Assist\n\n1. In the Google Cloud console toolbar, click\n spark **Open or close Gemini Cloud Assist chat**.\n\n The **Cloud Assist** panel opens.\n2. In Gemini Cloud Assist chat, enter the following prompt:\n\n I want to create a three-tier web application.\n\n Gemini Cloud Assist generates a basic design for a\n three-tier web application.\n3. To remove the load balancers and Secret Manager components, enter\n the following prompt:\n\n I don't need load balancers or Secret Manager.\n\n Gemini Cloud Assist updates the design to remove the\n components.\n4. Review the updated design that includes the following components:\n\n - Cloud Run (two components)\n - Cloud SQL for PostgreSQL\n5. Click **Edit app design**.\n\n The **Create a new template** page is displayed.\n6. Enter the following template details:\n\n 1. In the **Template name** field, enter `quickstart-three-tier-web-app`.\n\n 2. In the **Display name** field, enter `Quickstart three tier web app` .\n\n 3. In the **Description** field, enter `A template to generate a three tier web application`.\n\n 4. Click **Create template**.\n\n A new template is created and the design canvas is displayed.\n\nCreate an application draft\n\n1. From the design canvas, click **Configure an app**.\n\n2. Click **Create new application** and do the following:\n\n 1. In the **Name** field, enter `quickstart-three-tier-test`.\n\n 2. In the **Display name** field, enter `Quickstart three tier test`.\n\n 3. From the **Region** list, select `us-central1 (Iowa)`.\n\n 4. From the **Environment** list, select `TEST`.\n\n 5. From the **Criticality** list, select `LOW`.\n\n 6. In the **Scope** area, from the **Application scope** list, select\n `REGIONAL`.\n\n3. Click **Create application**.\n\nAn application draft is created.\n\nConfigure components\n\n1. In the design canvas, click **cloud-run-1** and do the following in the\n **Configuration** area:\n\n 1. From the **Project ID** list, select the descendant project you created in\n [Before you begin](#before-you-begin).\n\n 2. In the **Service name** field, enter `frontend-service`.\n\n 3. Click **Save**.\n\n2. In the design canvas, click **cloud-run-2** and do the following in the\n **Configuration** area:\n\n 1. From the **Project ID** list, select the descendant project you created in\n [Before you begin](#before-you-begin).\n\n 2. In the **Service name** field, enter `backend-service`.\n\n 3. Click **Save**.\n\n3. In the design canvas, click **sql-postgresql-1** and do the following in the\n **Configuration** area:\n\n 1. From the **Project ID** list, select the descendant project you created in\n [Before you begin](#before-you-begin).\n\n 2. In the **Name** field, enter `database-postgresql`.\n\n 3. From the **Database version** list, select `POSTGRES_15`.\n\n 4. From the **Zone** drop-down list, select `us-central1-a`.\n\n 5. Click **Save**.\n\nGreen check marks are displayed in each component to convey that you have\nspecified the required parameters. The application draft is ready to be deployed\nto the TEST environment for verification.\n\nDeploy the application\n\n1. Click **Deploy**.\n\n2. In the **Select a service account** area, do the following:\n\n 1. Click **Create a new service account**.\n\n 2. Click **Proceed**.\n\n3. Click **Deploy**.\n\n The application is deployed after a few minutes and resources are created in\n your project. The following details are displayed:\n - A link to App Hub, where you can view deployed resource details, including links to monitoring dashboards.\n - Links to Cloud Build logs, which you can use to troubleshoot deployment errors.\n - Outputs like service URIs are displayed, which you can use to interact with deployed resources.\n4. To build on this quickstart, see [Update an application template and redeploy](/application-design-center/docs/quickstart-update-template).\n\nClean up\n\n\nTo avoid incurring charges to your Google Cloud account for\nthe resources used on this page, follow these steps.\n\nDelete the deployed application\n\n1. From the navigation menu, click **Applications**.\n\n [Go to Applications](https://console.cloud.google.com/products/design-center/applications)\n2. From the table, click **Quickstart three tier web app**.\n\n3. Click more_vert\n **Actions** and select **Delete Application**.\n\n4. In the **Delete** field, enter `Quickstart three tier web app`.\n\n5. Click **Delete**.\n\nThe application is deleted, including the following:\n\n- The application details are removed from App Design Center.\n- The underlying App Hub application is deleted.\n- The underlying resources are deleted.\n\nOptional: Delete the project\n\nTo delete the descendant project you created in\n[Before you begin](#before-you-begin), do the following:\n| **Caution:** If you delete a project, all resources in the project are permanently deleted.\n\n1. In the Google Cloud console, go to the **Manage resources** page.\n\n [Go to Manage resources](https://console.cloud.google.com/iam-admin/projects)\n2. In the project list, select the project that you want to delete, and then click **Delete**.\n3. At the prompt, type the project ID, and then click **Shut down**.\n\nWhat's next\n\n- [Update an application template and redeploy](/application-design-center/docs/quickstart-update-template)\n- [Application Design Center overview](/application-design-center/docs/overview)\n- [Design and deploy an application with Gemini assistance](/gemini/docs/cloud-assist/design-application).\n- [Build on Google authored templates](/application-design-center/docs/build-on-google-templates)\n- [Design application templates](/application-design-center/docs/design-application-templates)"]]