Control-M for Terraform

Terraform is an open-source Infrastructure as Code (IaC) tool that enables you to create, configure, test, and manage your infrastructure on multiple platforms in a declarative way, using configuration files that describe the desired state of your infrastructure.

Control-M for Terraform enables you to do the following:

• Connect to the Terraform Cloud with OAuth 2.0 authentication.

• Trigger a Terraform workspace and pass variables.

• Create a Terraform workspace and create a variable on a workspace

• Manage Terraform credentials in a secure connection profile.

• Connect to any Terraform endpoint.

• Introduce all Control-M capabilities to Control-M for Terraform, including advanced scheduling criteria, complex dependencies, Resource Pools, Lock Resources, and variables.

• Integrate Terraform jobs with other Control-M jobs into a single scheduling environment.

• Monitor the Terraform workspace run status.

• Attach an SLA job to the entire Terraform service.

Control-M for Terraform Compatibility

The following table lists the prerequisites that are required to use the Terraform plug-in, each with its minimum required version.

Component	Version
Control-M/EM	9.0.21.100
Control-M/Agent	9.0.21.100
Control-M Application Integrator	9.0.21.100
Control-M Automation API	9.0.21.100

Control-M for Terraform is supported on Control-M Web and Control-M Automation API, but not on the Control-M client.

To download the required installation files for each prerequisite, see Obtaining Control-M Installation Files.

Setting up Control-M for Terraform

This procedure describes how to deploy the Terraform plug-in, create a connection profile, and define a Terraform job in Control-M Web and Automation API.

Before You Begin

• Verify that Automation API is installed, as described in Automation API Installation.

• Ensure that the Apply Method in the general settings in Terraform is set to Auto apply.

Begin

1. Create a temporary directory to save the downloaded files.

2. Download the Terraform plug-in from the Control-M for Terraform download page in the EPD site.

3. Install the Terraform plug-in with the Automation API Provision service:

   1. Log in to the Control-M/EM Server machine as an Administrator and store the downloaded zip file in the one of the following locations:

      • Linux: $HOME/ctm_em/AUTO_DEPLOY

      • Windows: <EM_HOME>\AUTO_DEPLOY

   2. Log in to the Control-M/Agent machine and run the provision image command, as follows:

      • Linux: ctm provision image Terraform_plugin.Linux

      • Windows: ctm provision image Terraform_plugin.Windows

4. Create a Terraform connection profile in Control-M Web or Automation API, as follows:

   • Web: Create a Centralized Connection Profile with Terraform Connection Profile Parameters

   • Automation API: ConnectionProfile:Terraform

5. Define a Terraform job in Control-M Web or Automation API, as follows:

   • Web: Create a Job with Terraform Job parameters

   • Automation API: Job:Terraform

Change Log

The following table provides details about changes that were introduced in new versions of this plug-in:

Plug-in Version	Details
1.0.01	Changed the field name from Variables to Parameters
1.0.00	Initial version