Getting started

Overview of using OneFuse with HashiCorp Terraform

  2 minute read  

Easily integrate CloudBolt OneFuse with HashiCorp Terraform (compatible with Terraform Open Source, Enterprise, or Cloud) to quickly automate and integrate into your business provisioning lifecycle.

The CloudBolt OneFuse integration platform offers integrations to services like Naming, IPAM, DNS, Microsoft Active Directory, Scripting, Ansible Tower and more.

Upstream providers like Terraform, VMware vRealize Automation, CloudBolt CMP, Ansible, ServiceNow and others are able to consume the same OneFuse integrations combined with organizational business logic for a standardized approach to automation across the enterprise.

Prerequisites

  1. Learn about HashiCorp Terraform.
  2. Download and install HashiCorp Terraform.
  3. Get the OneFuse Provider via the Terraform Registry.
  4. Configure the OneFuse Provider

Configure the OneFuse Provider

Configure the connection to OneFuse with a Terraform Provider for OneFuse.

  • A Terraform Provider is responsible for understanding API interactions and exposing resources.

Have the following in the main.tf file. Update the values as needed.

// Define the OneFuse Terraform Provider source
terraform {
 required_providers {
   onefuse = {
     source  = "CloudBoltSoftware/onefuse"
     version = ">= 1.40.0"
  }
 }
 required_version = ">= 0.13"
}

// Inititalize OneFuse Provider
provider "onefuse" {
 scheme     = var.onefuse_scheme
 address    = var.onefuse_address
 port       = var.onefuse_port
 user       = var.onefuse_user
 password   = var.onefuse_password
 verify_ssl = var.onefuse_verify_ssl
}

By pointing to the source CloudBoltSoftware/onefuse, Terraform will automatically download the OneFuse Terraform Provider based on the required_version specified.

Variable Name Variable Value
onefuse_scheme http or https
onefuse_address FQDN of the OneFuse Instance
onefuse_port OneFuse Port Address, for example 443
onefuse_user OneFuse username with at minimum the Workspace Member role, for example admin
onefuse_password Password for OneFuse user
onefuse_verify_ssl true or false

Resources

Troubleshooting

Refer to Terraform’s Troubleshooting and Debugging guides.

Next steps

Start integrating with OneFuse Modules.