terraform-tool

A node package that helps the developer to provision a cloud Infrastructure-as-Code using Terraform from your application.

Table of Contents

• Installation
• Usage
• Scripts
• Configuration
• Contributing
• License

Installation

You can install this package using npm or yarn.

npm

npm i terraform-tool

yarn

yarn add terraform-tool

Usage

Here is a simple example to get you started:

import { Terraform } from 'terraform-tool';

const config = 'terraform configuration folder name' 

/*  terraform/main.tf
I have a terraform folder inside my project root directory and inside it main.tf file resides
You need to pass only the folder name or path only not the file name. 
As my file path is 'terraform/main.tf', I only pass 'terraform' in Terraform() function below
*/

const tf = new Terraform('terraform');

tf.init()
  .then(() => tf.plan())
  .then(output => console.log('Plan:', output))
  .then(() => tf.apply())
  .then(output => console.log('Apply:', output))
  .catch(error => console.error('Error:', error));
// Apply complete! Resources: 1 added, 0 changed, 0 destroyed.

tf.destroy();

Functions

| Function | Description | Output | |---------|---------| ---------| | init() | The init function initializes a Terraform working directory. This command is used to set up the backend configuration, download provider plugins, and prepare the working directory for other Terraform operations. | A Promise that resolves to a string containing the standard output of the terraform init command. | | plan()| The plan function creates an execution plan, showing what actions Terraform will take to achieve the desired state of the infrastructure. This command is useful for reviewing proposed changes before applying them. | A Promise that resolves to a string containing the standard output of the terraform plan command. | | apply() | The apply function executes the actions proposed in a Terraform plan, applying changes to achieve the desired state of the infrastructure. The autoApprove parameter, when set to true, automatically approves the changes without prompting for confirmation. | A Promise that resolves to a string containing the standard output of the terraform apply command. | | destroy() | The destroy function removes all infrastructure managed by the Terraform configuration, effectively tearing down the environment. The autoApprove parameter, when set to true, automatically approves the destruction without prompting for confirmation. | A Promise that resolves to a string containing the standard output of the terraform destroy command. |

Scripts

Build

To compile the TypeScript files to JavaScript, run:

npm run build

Test

To run tests, use:

npm run test

Configuration

TypeScript Configuration

This package uses a tsconfig.json file for TypeScript configuration. Here is an example:

{
  "compilerOptions": {
    "target": "ES6",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "outDir": "./dist"
  },
}

Contributing

• Muhammad Usman

Support

LICENSE

This project is licensed under the MIT License - see the LICENSE file for details.