terraform-provider-americancloud

README

Terraform Provider for American Cloud

Manage American Cloud infrastructure — VMs, block storage, networking, Kubernetes, and DNS — as code.

Usage

terraform {
  required_providers {
    americancloud = {
      source = "American-Cloud/americancloud"
    }
  }
}

provider "americancloud" {
  # Credentials may be set here or via environment variables:
  #   AMERICANCLOUD_API_CLIENT_ID, AMERICANCLOUD_API_CLIENT_SECRET
}

resource "americancloud_isolated_network" "net" {
  name   = "app-net"
  region = "us-west-0"
}

resource "americancloud_vm" "web" {
  name                = "web-1"
  region              = "us-west-0"
  vm_package          = "standard-custom"
  vcpu                = 1
  memory_mb           = 2048
  root_disk_gb        = 25
  image               = "ubuntu-24.04-050826"
  network             = americancloud_isolated_network.net.id
  subscription_period = "hourly"
}

Create API keys at console.americancloud.com.

Resources

americancloud_vm · americancloud_ssh_key · americancloud_snapshot · americancloud_block_storage · americancloud_kubernetes_cluster · americancloud_isolated_network · americancloud_vpc_network · americancloud_vpc_tier · americancloud_public_ip · americancloud_firewall_rule · americancloud_egress_rule · americancloud_network_acl · americancloud_network_acl_rule · americancloud_port_forwarding_rule · americancloud_load_balancer_rule · americancloud_object_storage_unit · americancloud_dns_zone · americancloud_dns_record.

Data sources: americancloud_region · americancloud_image · americancloud_vm_package.

See examples/ for per-resource configurations, the registry documentation for the full schema, and the Terraform guide for a walkthrough.

Configuration

Provider setting	Environment variable	Purpose
api_client_id	AMERICANCLOUD_API_CLIENT_ID	API client ID
api_client_secret	AMERICANCLOUD_API_CLIENT_SECRET	API client secret (sensitive)
api_url	AMERICANCLOUD_API_URL	API base URL override (optional)

Guides

Narrative walkthroughs on the American Cloud docs site:

• Terraform guide — provider setup, authentication, and managing resources as code
• SDKs & Terraform overview — when to reach for Terraform, an SDK, or the MCP server
• Deploy with AI — let an AI assistant build and ship to American Cloud

Development

go build ./...
go test ./...   # unit + SDK coverage (no credentials needed)
go install .    # then configure dev_overrides — see CONTRIBUTING.md

Contributing

The resource surface tracks the American Cloud Go SDK and API — see CONTRIBUTING.md.

License

Apache-2.0 — see LICENSE and NOTICE.