📦 Installation
Add the provider requirement to your main.tf configuration:
# main.tf
terraform {
required_providers {
cloudnexus = {
source = "cloudnexus/cloudnexus"
version = "~> 1.2.0"
}
}
}
Initialize your working directory to download the provider:
terraform init
📋 Release Notes (v1.2.0)
This release introduces native Kubernetes cluster management, enhanced storage lifecycle policies, and critical fixes for multi-region networking.
✨ New Features
- Added
cloudnexus_kubernetes_clusterresource - Object storage lifecycle rules & versioning
- Support for custom SSH keys in instance configs
- Native provider authentication via OIDC
🛠 Improvements
- Reduced state refresh time by ~40%
- Improved error messages for network peering
- Added
wait_for_readyflag for load balancers - Optimized plan diff for large-scale deployments
🐛 Bug Fixes
- Fixed race condition on multi-region VPC sync
- Resolved credential rotation timeout issue
- Corrected IPv6 CIDR validation in subnets
⚠️ Breaking Changes
- Renamed
cn_instancetocloudnexus_instance - Deprecated
api_keyin favor ofauth_token
🔗 Compatibility
This provider requires Terraform Core v1.5.0 or higher. It has been tested against the following platforms:
Supported Terraform Core Versions:
v1.5.0, v1.5.1, v1.5.2, v1.5.3, v1.5.4, v1.5.5
v1.6.0, v1.6.1, v1.6.2, v1.6.3, v1.6.4, v1.6.5
v1.7.0, v1.7.1, v1.7.2, v1.7.3, v1.7.4, v1.7.5
Supported OpenTofu Versions:
v1.6.0 - v1.7.0 (Experimental)
🚀 Quick Usage Example
Provision a managed cloud instance with attached networking and storage:
provider "cloudnexus" {
region = "us-east-1"
auth_token = "your-secure-token"
}
resource "cloudnexus_instance" "web_server" {
name = "app-prod-01"
image = "ubuntu-22.04-lts"
instance_type = "cn-standard-2"
network {
vpc_id = cloudnexus_vpc.main.id
subnet_id = cloudnexus_subnet.web.id
}
lifecycle {
ignore_changes = [image]
}
}
⬇️ Downloads & Verification
Download precompiled binaries for your platform. SHA256 checksums are provided for verification.
| Operating System | Architecture | Download | SHA256 |
|---|---|---|---|
| Linux | amd64 | cloudnexus_1.2.0_linux_amd64.zip ↗ | a1f2c3d4e5f6789012345678901234567890abcdef |
| Linux | arm64 | cloudnexus_1.2.0_linux_arm64.zip ↗ | b2e3d4f5a6b7890123456789012345678901bcdef0 |
| macOS | amd64 | cloudnexus_1.2.0_darwin_amd64.zip ↗ | c3f4e5a6b7c8901234567890123456789012cdef01 |
| macOS | arm64 | cloudnexus_1.2.0_darwin_arm64.zip ↗ | d4a5b6c7d8e9012345678901234567890123def012 |
| Windows | amd64 | cloudnexus_1.2.0_windows_amd64.zip ↗ | e5b6c7d8e9f0123456789012345678901234ef0123 |
# Verify checksum (Linux/macOS)
sha256sum -c cloudnexus_1.2.0_SHA256SUMS
# Verify checksum (Windows PowerShell)
Get-FileHash cloudnexus_1.2.0_windows_amd64.zip -Algorithm SHA256
🤝 Support & Contributions
Find an issue? Have a feature request? CloudNexus maintains this provider as open-source.
🐛 Report a Bug: https://github.com/cloudnexus/terraform-provider-cloudnexus/issues
💡 Request Feature: https://github.com/cloudnexus/terraform-provider-cloudnexus/discussions
📖 Contributing: https://github.com/cloudnexus/terraform-provider-cloudnexus/blob/main/CONTRIBUTING.md
💬 Community: https://discord.gg/cloudnexus-dev