Creating a deployment to IBM Cloud Schematics link

The deploy to IBM Cloud® URL is an efficient way for you to enable users to deploy solutions on IBM Cloud from a public Git repository sample configuration. The URL requires minimal configuration and you can insert it anywhere in your documentation that supports markup. When the user clicks the hyper link, they are taken directly to the Schematics workspace setup page and only need to click the create button for workspace creation in Schematics.

The following steps show how to create a URL to deploy to Terraform >=1.0.0, <2.0 template example in IBM Cloud Schematics.

Create a template example by using Terraform on IBM Cloud provider and publish in the public Git repository. To create example, see Sample template.
Copy the public Git repository URL, for example, https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/app_config_collection.
Use this syntax to auto deploy the Schematics workspace creation in the IBM Cloud.

Syntax
```
https://cloud.ibm.com/schematics/workspaces/create?repository=<template public Git repository example url>&terraform_version=<terraform_v1.x.x>
```
Example
```
https://cloud.ibm.com/schematics/workspaces/create?repository=https://github.com/IBM-Cloud/terraform-provider-ibm/tree/master/examples/ibm-cis&terraform_version=terraform_v1.6
```
The URL contains two parameters, first parameter is provided with the workspace name as ibm-cis and second parameter is provided with the Terraform version as terraform_v1.0. For more information, about the parameters refer to this example, https://cloud.ibm.com/schematics/workspaces/create?repository=https://github.com/IBM-Cloud/terraform-provider-ibm/tree/master/examples/ibm-cis&terraform_version=terraform_v1.6. If you do not provide any parameters or ignore one parameter, the Deploy to IBM Cloud link defaults to the repository's master branch. You can provide the Terraform version parameter that you are using.
You can copy, and paste the example URL in the browser to view the IBM Cloud Schematics workspace console with the create button is displayed.
Cross-check the parameters in the workspace console and click Create button.

Adding an image on deployment to IBM Cloud link

You can add an image on Deploy to IBM Cloud Schematics text by using the following syntax and example.

Syntax

<a href="https://cloud.ibm.com/schematics/workspaces/create?repository=<public Git repository example URL>/<workspace name>&terraform_version=terraform_xx">Deploy to IBM Cloud Schematics <img src=<image location>></a>

Example

<img src="images/autodeploy_button.png" alt="Deploy to IBM Cloud" usemap="#viewgithubimage_map1t">
<map name="viewgithubimage_map1t">
    <area alt="Deploy to IBM Cloud}" title="Deploy to IBM Cloud" href="https://cloud.ibm.com/schematics/workspaces/create?repository=https://github.com/IBM-Cloud/terraform-provider-ibm/tree/master/examples/ibm-cis&terraform_version=terraform_v1.6" target="_blank" coords="3,1,140,20" shape="rect">
</map>

Output

Auto deployment button

To view about the sample Terraform template examples, refer Sample Terraform templates and deploy to IBM Cloud Schematics.