Configuring Deployables Using Google Cloud Compute Plugin

This topic covers the Deploy Google Cloud Compute plugin, which supports Deploy Instance Spec, Deploy Template Spec, and DialogFlow Agent Zip Spec deployables.

Prerequisites

• Digital.ai Deploy 10.3 or later releases
• Google Cloud Platform infrastructure

Step 1: Create google.AccountCloud Infrastructure

To create google.AccountCloud in Infrastructure:

1. Log in to Digital.ai Deploy.
2. Click Explorer, hover over Infrastructure, click , and select New > google > AccountCloud to create google.AccountCloud.

3. Enter the details in Project Id, Clent Email, and Private Key fields.

4. Click Save.

note

Make sure to check the connection is successful.

Step 2: Set up google.AccountCloud Enviornment

1. Create environment for google.AccountCloud. See See create an environment to know more information.

2. Select the container from drop down list.

3. Click Save

Step 3: Create and Deploy Application

Create and deploy provisioning package for Instance Spec, Template Spec and DialogFlow Agent ZIP Spec:

Step 3.1: Upload Deployment Artifacts to Google Cloud Storage

note

Ensure that the GCP plugin is installed and synchronized in your environment. For help, refer to Using the Plugins Manager.

1. Click Explorer, hover over Applications, click , and select New > Application.
2. Enter the name of the application in the Name field. For example, GCP-Instance-Deploy.
3. Click Save and close.
4. Click on the Applications dropdown, hover over the newly created application GCP-Instance-Deploy, click , and select New > Deployment Package.
5. Enter the name of the deployment package in the Name field. For example, 1.0.0.
6. Click Save and close.
7. Click on the GCP-Instance-Deploy dropdown, hover over the new package 1.0.0, click , and select
   New > googlecloud > storage.

You will see the following four upload options:

• Archive
• File
• Folder
• Bucket

8. Select one of the upload options depending on the type of artifact you want to upload.

9. Fill in the required fields:

   • For File/Archive Spec:

     • Target File Name (optional): Rename the file upon upload.
     • Target Path in Bucket: Path inside the GCS bucket.
     • Predefined ACL: Optional if Uniform Bucket-Level Access is disabled.

   • For Folder Spec:

     • Target Path in Bucket: Required.
     • Sync Folder: If enabled, syncs only changes (adds/updates).
     • Remove Deleted Files on Sync: If enabled, removes deleted files from the bucket.
     • Target File Name is not applicable for folders.

     

10. Click Save and close after configuring the upload spec.

tip

Use the below examples to verify your initial configuration

• Folder Spec – Sync Behavior
  If Sync Folder is enabled, only new or modified files are uploaded, and deleted files in the source are also removed from the GCS bucket. This helps maintain an exact mirror of your local folder structure.
  

Repeat for each artifact you want to upload to GCS as part of the deployment package.

Step 3.2: Manage Google Cloud Storage Buckets

You can create, update, and delete GCS buckets as part of your deployment lifecycle.

Create a Bucket

1. Navigate to your deployment package as described in the previous steps.

2. Click Menu Button and select New > googlecloud > storage > BucketSpec.

   

3. Configure the required properties:

   • Bucket Name: Enter a globally unique name
   • Region: Select the deployment region
   • Storage Class: Choose from Standard, Nearline, Coldline, or Archive

4. Configure optional properties as needed:

   • Policy: Attach IAM policies
   • Uniform Bucket-Level Access: Enable if required
   • Public Access Prevention: Enable to prevent public access
   • Logging: Enable access logging and specify target bucket
   • Target Bucket: Required when logging is enabled
   • Target Prefix: Optional prefix for log files. Default value /logs
   • Static Website Hosting: Enable for static websites and specify index document
   • Index Document: Required when static hosting is enabled
   • Error Document: Optional custom error page

5. Click Save.

6. Deploy the package to create the bucket.

Update a Bucket

1. Create a new deployment package version.
2. Modify the bucket configuration properties as needed.
3. Deploy the updated package to apply changes to the existing bucket.

Delete a Bucket

1. Empty the bucket first: Remove all objects from the bucket before attempting deletion.
2. Undeploy the deployment package.
3. The empty bucket will be deleted successfully.

warning

• Only empty buckets can be deleted
• If the bucket contains objects, deletion will fail with error:

  NotEmptyException: 409 BucketNotEmpty (bucket_name)

• You must remove all objects from the bucket before attempting deletion
• Bucket deletion is irreversible once the bucket is empty

Step 3.3: Deploy Instance Spec

1. Click Explorer, hover over Applications, Click and select New > Application.
2. Enter the name of the application in the Name field. For example GCP-Instance-Deploy.
3. Click Save and close.
4. Click on Applications drop down, hover over the new application created GCP-Instance-Deploy, Click and select New > Deployment Package.
5. Enter the name of the configuration item in the Name field. For example 1.0.0.
6. Click Save and close.
7. Click on GCP-Instance-Deploy drop down, hover over the new package created 1.0.0. Click and select New > googlecloud > compute > InstanceSpec.

8. Enter the name of the configuration item in the Name field.
9. Provide the following values:
   

• Zone
  
• Machine
  
• Image Project
  
• Image
  
• Wait On Create*
  
• Wait On Destroy*
  

10. Click Save.

note

You can add additional configuration as per your requirement.

11. To add additional configuration, hover over instance-spec, Click and select New > and select the required spec.

12. Start the deployment. For more information, see Start a Deployment.

13. Check the deployment on google cloud.

Step 3.4: Deploy Template Spec

1. Click Explorer, hover over Applications, Click and select New > Application.
2. Enter the name of the application in the Name field. For example GCP-Instance-Deploy.
3. Click Save and close.
4. Click on Applications drop down, hover over the new application created GCP-Instance-Deploy, Click and select New > Deployment Package.
5. Enter the name of the configuration item in the Name field. For example 1.0.0.
6. Click Save and close.
7. Click on GCP-Instance-Deploy drop down, hover over the new package created 1.0.0. Click and select New > googlecloud > compute > TemplateSpec.

8. Enter the name of the configuration item in the Name field.
9. Provide the following values:
   

• Zone
  
• Machine
  
• Image Project
  
• Image
  
• Wait On Create*
  
• Wait On Destroy*
  

10. Click Save.

note

You can add additional configuration as per your requirement.

11. To add additional configuration, hover over instance-spec, Click and select New > and select the required spec.

12. Start the deployment. For more information, see Start a Deployment.

13. Check the deployment on google cloud.

Step 3.5: Deploy DialogFlowAgentZIP Spec

1. Click Explorer, hover over Applications, Click and select New > Application.
2. Enter the name of the application in the Name field. For example GCP-Instance-Deploy.
3. Click Save and close.
4. Click on Applications drop down, hover over the new application created GCP-Instance-Deploy, Click and select New > Deployment Package.
5. Enter the name of the configuration item in the Name field. For example 1.0.0.
6. Click Save and close.
7. Click on GCP-Instance-Deploy drop down, hover over the new package created 1.0.0. Click and select New > googlecloud > dialogflow > AgentZipSpec.

8. Type the name of the configuration in Name field.
9. Browse the file from Choose file field.
10. Type true in Restore Agent field.

11. Click Save and close.

note

The File Uri field updates once you save the configuration.

12. Start the deployment. For more information, see Start a Deployment.

13. Check the output at dialogflow.cloud.google.com for the selected zip file.