terraform-tool
v1.0.4
Published
NPM package to provision cloud infrastructure as code (IaC) using terraform
Downloads
21
Maintainers
Readme
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
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
Support
LICENSE
This project is licensed under the MIT License - see the LICENSE file for details.