Manage application instances

Stay organized with collections Save and categorize content based on your preferences.

Create an application instance when you want to customize and deploy from an application template. For example, you might create an instance that you plan to deploy for testing purposes. You might create another instance for production use.

When you create an application instance, you specify information the helps you categorize based on the application's intended usage. This information helps you filter and find application instances when you're looking for a specific instance.

Before you begin

You must have one of the following roles:

• Application Design Center Admin (roles/designcenter.admin)
• Application Admin (roles/designcenter.applicationadmin)
• Application Editor(roles/designcenter.applicationeditor)

Create an application instance

Create an application instance from a template by specifying application details and optionally overriding component configurations.

1. From the navigation menu, click Templates.

   Go to Templates

2. Click the Template ID that you want to use.

3. From the design canvas, click Configure an app. Then click Create new application.

4. In the Application name area, do the following to name and describe your application:

   1. In the Name field, enter a unique identifier in this space. For example, use a unique name and environment combination like web-app-staging. This is a required field.

      You can use up to 63 characters, including lowercase letters, numbers, and hyphens. The name must start with a lowercase letter and can't end with a hyphen. Names can't be changed.

   2. In the Display name field, enter a name to display in the Google Cloud console.

   3. In the Description field, enter the purpose of this application instance

5. To specify a deployment project for components that don't already have a Project ID value, from the Deployment Project list, select a project with the following qualifications:

   • The project must be a descendant of the selected app-enabled folder.
   • The project must not be a management project.

   If the template creator specified a Project ID for a component, that project is used as the deployment project.

6. From the Region list, select the region where you plan to deploy the application instance. This is a required field.

7. From the Application scope list, specify one of the following:

   • REGIONAL: All application resources are in a single region.

   • GLOBAL: The application contains a global resource, or resources are in multiple regions.

   This is a required field. For more information, see Compare global and regional applications.

8. From the Environment list, select the environment where you want to deploy this instance. For example, you might want to verify that your deployment works as expected in TEST.

9. From the Criticality list, select the degree of impact on your business. For example, LOW or HIGH.

10. To specify owners, in the Owners area, click Add owner and enter a Display name and email for the following:

    • In the Business owners area, enter an owner who is responsible for quality and user expectations.

    • In the Developer owners area, enter an owner who is responsible for development and coding.

    • In the Operator owners area, enter an owner who is responsible for operating the application.

11. Click Create Application. The application details are displayed.

12. To modify a component in the application, click the component in the design canvas and modify its parameters. For links to configuration documentation for each component, see Supported resources.

Create an application revision

Create an application revision to modify details or components. If you modify application components outside of App Design Center, those changes are not retained when you redeploy.

To create an application revision:

1. From the navigation menu, click Applications.

   Go to Applications

2. From the table, click the Application name that you want to revise.

3. To modify application details, do the following:

   1. Click Edit and modify the details.
   2. Click Save to save your changes.

4. To modify a component in this application, do the following:

   1. Click the component in the design canvas and edit the details in the Configuration area.

   2. Click Save to save your changes.

5. For deployment steps, see Deploy from the Google Cloud console.

Delete an application

If you no longer need an application, you can delete it. For example, you might deploy an application to verify your template in the TEST environment, and then delete the application.

You can delete the following applications:

• An application that has not been deployed. On the Applications page, the Status is listed as Draft.
• An application that was deployed to the TEST, DEVELOPMENT, or STAGING Environment.

When you delete an application, the following occurs:

• The application details are removed from Application Design Center.
• The underlying App Hub application is deleted.
• If you deployed, resources are deleted.

To delete an application:

1. From the navigation menu, click Applications.

   Go to Applications

2. From the table, click the Application name.

3. Click more_vert Actions and select Delete Application.

4. In the Delete field, enter the application name.

5. Click Delete.

What's next

Deploy your application using one of the following:

• Deploy from the Google Cloud console
• Download and deploy