Migrating and version controlling

IBM continually updates the Terraform on IBM Cloud provider to give you higher levels of performance and being up-to-date. Some instances aren't able to be upgraded, so they must be closed and you must migrate your resources with the right version.

View the versions that are associated in the Terraform and the IBM Cloud provider plug-in.

Upgrading the Terraform version

You can upgrade your Terraform version from Terraform v0.12 to Terraform v0.13. With the release of Terraform v0.13, the syntax for configuration files have changed.

To upgrade the Terraform template from the old version to the latest version, refer to Upgrading the Terraform template version.

Complete the following steps to upgrade your configuration files:

Follow the instructions to install existing Terraform with the latest version of the Terraform.
Copy your existing Terraform version configuration files into your Terraform working directory.
```
mv <tf_config_file_path> $HOME/terraform
```

Use the Terraform upgrade command to automatically apply the new syntax to your Terraform configuration files.

Syntax

terraform <0.xx>upgrade

Example to upgrade Terraform v0.12 to Terraform v0.13

terraform 0.13upgrade

Example output:

This command rewrites the configuration files in the given directory to
use the new syntax features from Terraform on IBM Cloud v0.12, and identify
any constructs that may need to be adjusted for correct operation with
Terraform on IBM Cloud v0.13.

We recommend to use this command in a clean version control work tree, so that
you can easily see the proposed changes as a diff against the latest commit.
If you have uncommited changes already present, we recommend aborting this
command and dealing with them before running this command again.

Would you like to upgrade the module in the current directory?
    Only 'yes' is accepted to confirm.

    Enter a value: yes

-----------------------------------------------------------------------------

Upgrade complete!

The configuration files were upgraded successfully. Use your version control
system to review the proposed changes, make any necessary adjustments, and
then commit.

Verify versions.tf file is generated as shown in the example.

Example versions.tf

terraform {
    required_providers {
    ibm = {
      # TF-UPGRADE-TODO
      #
      # No source detected for this provider. You must add a source address
      # in the following format:
      #
      # source = "your-registry.example.com/organization/ibm"
      #
      # For more information, see the provider source documentation:
      #
      # https://www.terraform.io/docs/configuration/providers.html#provider-source
    }
    }
    required_version = ">= 0.13"
}

Edit the versions.tf configuration file. Comment out source = "your-registry.example.com/organization/ibm" parameter and provide source value as source = "IBM-Cloud/ibm" as shown in the example. For more information, about the provider registry, see IBM Cloud provider registry.

Example versions.tf

terraform {
    required_providers {
    ibm = {
      # TF-UPGRADE-TODO
      #
      # No source detected for this provider. You must add a source address
      # in the following format:
      #
      source = "IBM-Cloud/ibm"
      #
      # For more information, see the provider source documentation:
      #
      # https://www.terraform.io/docs/configuration/providers.html#provider-source
    }
    }
    required_version = ">= 0.13"
    }

This completes your Terraform version upgrade.

Version control

The versions that are associated with the resources and data sources are:

IBM Cloud Provider plug-in for Terraform. For more information, see Provider version releases.
Terraform. For more information, see Terraform version.

With the release of Terraform version 0.12, the syntax for configuration files changed. If you want to run your infrastructure code by using Terraform version 0.12, you must first refer to refer to Upgrading the Terraform template version.