Terraform Action

Creating an Action Using Action Type: Terraform

Overview

This document provides step-by-step instructions for creating and configuring an action using the Terraform action type in Callgoose SQIBS automation platform. The Terraform action type allows users to execute Terraform operations for infrastructure automation workflows. Below are the configuration options and their descriptions:

Steps to Add a Terraform Action

1. Navigate to Add Action

• Access the automation section in the Callgoose SQIBS automation platform.
• Go to Automation, and you can see Action.
• Click on Action and then click on Add Actions to create a new action.

1. Select Action Type

• Choose Terraform as the action type from the list of available options.

1. Copy from Existing Actions

• Copy From:
• Click on Copy From to copy an existing action.
• You can copy actions from:
• Callgoose Actions: Predefined task-based scripts and programs available free of charge.
• Team Actions: Actions shared within your team.
• Global Actions: Actions available globally across the platform.
• Callgoose Actions provide several task-based scripts and programs that you can use and modify according to your requirements.

1. Fill in the Details

• Name*:
• Provide a descriptive name for the action.
• Example: Deploy Infrastructure.
• Description*:
• Add a detailed description of what the action does.
• Example: This action executes a Terraform plan to deploy infrastructure.
• Version:
• Select the required Terraform version.
• Example: Terraform 1.8.2.
• Success Response*:
• Define the expected output when the operation runs successfully. The success response is similar to the exit status in Linux.
• Example: 0 exit status indicates the script or command executed successfully.

1. Configure "Keep .terraform Folder" Option

• Choose whether to keep the .terraform folder after execution:
• Yes: Retains the folder.
• No: Deletes the folder after execution.

1. Choose Terraform Operation

• Apply:
• Init Options:
• Specify initialization options, such as --backend-config options. Refer to the tooltip for more information.
• Operation Options:
• Specify options for the apply operation, such as --var-file="variables.tfvars". Refer to the tooltip for more information.
• Terraform File:
• Upload the Terraform file to be executed.
• Add Commands:
• Add commands to be executed after the apply operation.
• You can add multiple commands by clicking the + symbol.
• Destroy:
• Init Options:
• Specify initialization options, such as --backend-config options. Refer to the tooltip for more information.
• Operation Options:
• Specify options for the destroy operation, such as --var-file="variables.tfvars". Refer to the tooltip for more information.
• Terraform File:
• Upload the Terraform file to be executed.
• Add Commands:
• Add commands to be executed after the destroy operation.
• You can add multiple commands by clicking the + symbol.
• Command:
• Init Options:
• Specify initialization options, such as --backend-config options. Refer to the tooltip for more information.
• Add Commands:
• Add Terraform ad-hoc commands to be executed.
• You can add multiple commands by clicking the + symbol.

1. Configure Arguments

• Have Argument:
• Choose whether the action requires arguments.
• Yes: Enables input fields to define arguments for the Terraform operation.
• No: Indicates that no arguments are required.

1. Set Expected Run Time

• Expected Run Time (in Minutes)*:
• Specify the estimated time for the execution.
• Example: 15 (indicating 15 minutes).

1. Upload Multiple Files

• If you have multiple files to upload:
• First, create the action.
• Then, open that action.
• Click on Show Details.
• Click on Edit, and you will be able to see the Other Files option.
• Upload the additional files as required by your Terraform setup.
• Click on Save after uploading the files if necessary.

Additional Notes

• Fields marked with an asterisk (*) are mandatory.
• Ensure the Terraform files and commands are tested locally before configuring the action to avoid runtime errors.
• Use descriptive names and success responses to make it easier for team members to understand the action.
• The "Expected Run Time" should be realistic to help with workflow monitoring and optimization.

Example Configuration

Name: Deploy Infrastructure

Description: This action executes a Terraform plan to deploy infrastructure.

Version: Terraform 1.8.2

Success Response: 0 (indicating the operation executed successfully).

Operation: Apply

Terraform File: Upload a file named main.tf.

Add Commands: Add post-operation commands such as terraform output.

Keep .terraform Folder: No

Have Argument: Yes

Expected Run Time (in Minutes): 15

Conclusion

By following these steps, you can effectively configure and execute a Terraform action in Callgoose SQIBS automation platform. This capability enhances the automation of infrastructure management tasks and simplifies workflow management.