CloudShare supports using custom Terraform scripts to enable tight functional integration with external clouds.

A Terraform script defines each end-user environment upon spinup, providing a way to configure all of the desired cloud services.

For example, when integrating the Google Cloud Platform (GCP) you can create instances of GCP VMs or Cloud SQL, define a Kubernetes container, and more.

When you use a Terraform script, it is read dynamically whenever the associated environment's snapshot is used. This means that any changes made to the script will be reflected each time the snapshot is used.

Viewing the Creation Scripts List

From the External Resources menu, click Creation Scripts. The Creation Scripts page opens showing all creation scripts currently defined for the account:

Viewing and Editing Details for a Selected Script

From the Name column on the Creation Scripts page, click the name of the script you want to view or edit. The Creation Script editor page opens for the selected Terraform script:

The left column of the editor page provides high-level Script Details for the selected script. The right column of the editor page displays the Script Content. To edit details or change the script, click on the Edit icon located at the top of the desired column.

If you make any changes to the script, click Validate Script at the bottom of the editor to perform basic syntax validation. Should the validation fail, the editor will provide some information about the failure.

When you are finished editing, click Submit to update the selected script for the account.

Copying a Selected Script

You can make a identical copy of a specific script and use that as a starting point for a new script.

Open the script you want to copy in the Creation Scripts editor page and from the top menu click Copy Script. A pop-up dialog will be displayed. After you confirm the copy request, a duplicate script with the word 'Copy' appended to its name will be created and displayed in the Creation Scripts list. You can then open and edit the new copy as needed.

Alternatively, you can click the Copy icon located at the top of the Script Content column to copy the script to your local clipboard.

Deleting a Selected Script

To delete a specific script, open it in the Creation Scripts editor page and click Delete Script. Upon your confirmation, the selected script will be deleted.

Working with Azure Resource Groups in a Script

When you assign a reference to your resource group name in a script that is intended for Microsoft Azure, you must use the CloudShare data.azurerm_resource_group.main.name variable in order for the script to execute properly:

If you do not use this variable in your assignment, CloudShare will be unable to access the Azure resource group when the external cloud is created, resulting in a script execution error.

An Azure script can only make reference and use a single resource group in a given environment.

Working with Kubernetes

CloudShare fully supports working with Kubernetes frameworks.

When you create a Kubernetes cluster on the Google Cloud Platform (GCP), be aware that certain cluster configurations will limit CloudShare's ability to suspend that cluster in your environment, leaving the resource active. For example, if your Google Kubernetes configuration causes the error shown below, it does not allow fewer than 3 nodes to be available for use at any time:

Using such a minimum configuration requirement prevents CloudShare from suspending the node cluster together with the rest of its environment (either manually or via the auto-suspend feature).

To remedy this, ensure that the number of available Kubernetes nodes can be reduced to 0 on GCP. Doing so will enable CloudShare to suspend the cluster in the related environment.

For more information, refer to Google Kubernetes documentation at: Cluster Administration Overview.

Working with AWS

CloudShare supports the following Amazon Elastic Compute Cloud (EC2) scripting options:

CloudShare also supports use of your own AWS account when creating external resources. For additional information, contact CloudShare support.

Using Metadata Variables

To make it easier to pass runtime information in your scripts, CloudShare supports use of the following special metadata variables:

To include these variables in your script, declare and use them as needed:

For additional information about using metadata variables in scripts, contact CloudShare support.