Terraform Provider for ArubaCloud

Manage your ArubaCloud infrastructure with Terraform! This provider enables you to create and manage Cloud Servers, VPCs, Kubernetes clusters, DBaaS instances, and more using infrastructure as code.

Features

• Compute: Cloud Servers, SSH keypairs, Elastic IPs
• Storage: Block Storage, Snapshots, Backups
• Networking: VPCs, Subnets, Security Groups, VPN, VPC Peering
• Kubernetes: KaaS (Kubernetes as a Service)
• Database: DBaaS with MySQL/PostgreSQL support
• Container: Container Registry
• Security: Key Management Service (KMS)

Note: This is the initial v0.0.1 release. While all resources are functional and tested with real infrastructure, comprehensive automated testing is ongoing. Please report any issues on GitHub.

Documentation

• Terraform Registry Documentation (after publication)
• Examples - Complete working examples for all resources
• Generated Docs - Detailed documentation for all resources and data sources

Requirements

• Terraform >= 1.0
• Go >= 1.24.x (only needed to build the provider from source)

Installation

Via Terraform Registry (Recommended)

Once published, the provider will be automatically downloaded when you run terraform init:

terraform {
  required_providers {
    arubacloud = {
      source  = "arubacloud/arubacloud"
      version = "~> 0.0.1"
    }
  }
}

provider "arubacloud" {
  api_key    = var.arubacloud_api_key
  api_secret = var.arubacloud_api_secret
}

Quick Start

1. Configure the provider

To use the provider, configure it with your ArubaCloud credentials:

terraform {
  required_providers {
    arubacloud = {
      source  = "arubacloud/arubacloud"
      version = "~> 0.0.1"
    }
  }
}

provider "arubacloud" {
  api_key    = "YOUR_API_KEY"
  api_secret = "YOUR_API_SECRET"
}

You can also use environment variables:

• ARUBACLOUD_API_KEY - Your ArubaCloud API key
• ARUBACLOUD_API_SECRET - Your ArubaCloud API secret

export ARUBACLOUD_API_KEY="your-api-key"
export ARUBACLOUD_API_SECRET="your-api-secret"
terraform plan

2. How to start?

Have a look to examples

3. Apply the configuration

terraform init
terraform plan
terraform apply

Build the provider

Clone repository to your workspace:

git clone https://github.com/arubacloud/terraform-provider-arubacloud.git
cd terraform-provider-arubacloud

Build the provider:

make build

Or run all checks (format, lint, test, build, generate):

make

Develop the provider

• Install Go >= 1.24
• Run make build to build the provider binary
• Run make test to run unit tests
• Run make testacc to run acceptance tests (may create real resources)
• Run make ci-test to run all CI checks locally (build, lint, generate, test)

Testing

The provider includes comprehensive unit and acceptance tests.

Run all CI checks locally (build, lint, generate, test):

make ci-test

This runs the same checks as the CI pipeline:

• Downloads dependencies
• Builds the provider
• Runs linter (auto-installs golangci-lint if needed)
• Generates documentation
• Runs go mod tidy
• Checks for uncommitted changes
• Runs unit tests
• Generates coverage report

Run unit tests (fast, no external dependencies):

make test

Run linter (auto-installs golangci-lint if needed):

make lint

Run acceptance tests (requires TF_ACC=1, may create real resources):

make testacc

Run a specific test:

make testacc-run TEST=TestAccBackupResource

Generate coverage report:

make testcov
# Opens coverage.html in your browser

Format code:

make fmt

Generate documentation:

make generate

For more details, see the Testing Guide.

Local Development

To use a locally built provider, set up a Terraform CLI config file:

export TF_CLI_CONFIG_FILE="terraform.tfrc"

In the config file, override the lookup path for the provider:

provider_installation {
  dev_overrides {
    "arubacloud/arubacloud" = "$PWD"
  }
  direct {}
}

Build the provider:

make build

Run Terraform:

terraform plan

You should see a warning about provider development overrides.