Using ClouDNS as a Provider With OpenTofu

  • Monday 21 July 2025

In today’s fast-paced digital landscape, managing DNS infrastructure efficiently is crucial for seamless website performance and reliability. OpenTofu, a powerful Infrastructure as Code (IaC) tool, simplifies DNS management through automation and streamlined configuration. When paired with ClouDNS (a robust DNS hosting service known for its scalability and reliability) you can manage DNS records with precision and ease. This post provides an introduction to integrating ClouDNS as a provider within your OpenTofu configuration, ensuring optimal DNS management for your projects.

Prerequisites

  • An active ClouDNS account
  • OpenTofu installed on your machine
  • API credentials from ClouDNS (API ID and Password)

Obtain ClouDNS API Credentials

  • Log into your ClouDNS Control Panel.
  • Navigate to Account Settings > API.
  • Enable API access if not already done.
  • Note down your API ID and Password securely.

Prepare Your OpenTofu Configuration

  • Create a new OpenTofu configuration file main.tf or modify an existing one.
  • Insert the following provider information, replacing your_api_id and your_api_password with the credentials obtained earlier:
terraform {
  required_providers {
    cloudns = {
      source  = "Cloudns/cloudns"
      version = "~> 1.0"
    }
  }
}

provider "cloudns" {
  auth_id  = "your_api_id"
  auth_password = "your_api_password"
}

Define Your DNS Records

Here’s an example of adding an A record:

resource "cloudns_record" "example_a_record" {
  zone       = "example.com"
  type       = "A"
  name       = "www"
  ttl        = 3600
  value      = "192.0.2.1"
  depends_on = [cloudns_dns_zone.example_com]
}

Initialise and Apply Configuration

Run the following commands in your terminal:

opentofu init
opentofu plan
opentofu apply

Confirm the apply when prompted. OpenTofu will now communicate with ClouDNS to create the specified DNS records.

Conclusion

By integrating ClouDNS with OpenTofu, you gain powerful control over your DNS management through automation and code-driven configurations. This guide has walked you through obtaining API credentials, configuring the provider, defining DNS records, and applying changes efficiently. Whether you’re managing a single domain or orchestrating a complex network of DNS records, this setup enhances scalability, reliability, and operational efficiency. Embrace the power of OpenTofu and ClouDNS to streamline your infrastructure management today.

devops cloudnsiacopentofu