Managing Terraform Versions
The Managed services component supports multiple Terraform engine versions that are offered when deploying the templates. The following Terraform engine versions are shipped with the platform:
IBM Cloud Pak for Multicloud Management version | Supported Terraform versions | Terraform default version |
---|---|---|
2.3.x | 0.11.11, 0.12.21, 0.13.6, 0.14.4 | 0.12.21 |
2.3.x FixPack1 | 0.11.15, 0.12.31, 0.13.7, 0.14.11 | 0.12.31 |
2.3.x FixPack2 | 0.11.15, 0.12.31, 0.13.7, 0.14.11, 1.0.1 | 0.12.31 |
Terraform engine versions are shipped with the platform but you can add your own versions. Terraform default version can be changed using these instructions.
The list displays the Version, the type of version and the status. The versions that are shipped with the Managed services are listed as System
and the user created versions are listed as User
.
Only an Administrator or Cluster Administrator can create/delete/edit Terraform versions.
The Terraform versions are not namespace specific.
Managing Terraform Versions:
- Create a version
- Search for a version
- Rename a version
- Disable a version
- Enable a version
- Set a default version
- Delete a version
Create a version
Before creating a Terraform version in Managed services, follow these steps to get the Terraform version:
- Download and extract the Terraform binary of the version you want.
- Rename the Terraform binary to include the version. For example, for Terraform version 0.12.16 rename
terraform
toterraform_0.12.16
. - Archive the file.
To create a new version, follow these steps:
- In the navigation bar, click Manage > Terraform versions.
- Click Create version.
- Enter the version name in the Terraform version name text box.
- Click Upload and select your terraform archive.
- Check Set as default if this version should be considered in case template metadata does not specify a version.
- Click Create. The new version is added to the version list.
Search for a version
In Terraform versions page, you can use the following methods to search for versions:
- You can enter text in the search text to filter the version list.
- You can click the Version header to sort the versions.
- The pagination options allows you to limit the number of records displayed at a time.
Rename a version
To rename an existing version, follow these steps:
- In the navigation bar, click Manage > Terraform versions.
- From the overflow menu of a version, click Rename.
- Modify the existing version name.
- Click Rename.
Disable a version
To disable a version, follow these steps:
-
In the navigation bar, click Manage > Terraform versions.
-
From the overflow menu of a version, click Disable. The default version can not be disabled.
-
Click Disable.
Note: This disabled version can not be used in the future template deployments.
Enable a version
To enable a version, follow these steps:
-
In the navigation bar, click Manage > Terraform versions.
-
From the overflow menu of a version, click Enable.
-
Click Enable.
Set a default version
To set a default version, follow these steps:
-
In the navigation bar, click Manage > Terraform versions.
-
From the overflow menu of a version, click Set as default.
-
Click Set as default to confirm that you want to set this version as default.
Note: This default version is used as a primary selection while deploying the template.
Delete a version
Only the user defined Terraform versions can be deleted. Also if the version is set as default, the delete option is disabled. If you still want to delete this version, select other version as a default version.
To delete a version, follow these steps:
-
In the navigation bar, click Manage > Terraform versions.
-
From the overflow menu of a version, click Delete. A confirmation window is opened.
-
Type Delete to confirm that you want to delete the version.
-
Click Delete.
Note: The deleted version can not be used in the future template deployments.