Terraform Altinity.Cloud Provider

The official Terraform provider for Altinity.Cloud, enabling you to manage ClickHouse environments and infrastructure as code. This provider supports multiple cloud platforms including AWS, GCP, Azure, Hetzner Cloud, and Kubernetes clusters.

For detailed configuration options, see the Terraform Registry documentation.

If you're looking to set up the necessary infrastructure to connect your environments, see the connect modules:

• AWS: terraform-altinitycloud-connect-aws
• Kubernetes: terraform-altinitycloud-connect

Prerequisites

Before using this provider, ensure you have:

1. Terraform >= 1.0
2. Altinity.Cloud account with Anywhere API access
3. Cloud provider credentials (AWS, GCP, Azure, etc.) for the target environment

Usage

Basic Setup

terraform {
  required_providers {
    altinitycloud = {
      source  = "altinity/altinitycloud"
      version = "~> 0.6.1"
    }
  }
}

provider "altinitycloud" {
  # API token can be set via ALTINITYCLOUD_API_TOKEN environment variable
  api_token = "your-api-token-here"
}

Examples

For comprehensive examples covering all supported cloud platforms and use cases, see the examples directory:

• Resources: AWS, Azure, GCP, Hetzner Cloud, and Kubernetes environments with various configurations
• Data Sources: Environment status monitoring and validation examples
• Advanced Configurations: VPC peering, custom networking, secrets management, and more

Quick example for AWS:

resource "altinitycloud_env_certificate" "example" {
  env_name = "my-clickhouse-env"
}

resource "altinitycloud_env_aws" "example" {
  name           = altinitycloud_env_certificate.example.env_name
  aws_account_id = "123456789012"
  region         = "us-west-2"
  zones          = ["us-west-2a", "us-west-2b"]
  cidr           = "10.67.0.0/21"

  node_groups = [
    {
      node_type         = "m6i.large"
      capacity_per_zone = 5
      reservations      = ["CLICKHOUSE"]
    }
  ]
}

Resources

Resource	Description
altinitycloud_env_certificate	Generate environment certificates for cloud connection
altinitycloud_env_aws	Manage AWS-based ClickHouse environments
altinitycloud_env_azure	Manage Azure-based ClickHouse environments
altinitycloud_env_gcp	Manage GCP-based ClickHouse environments
altinitycloud_env_hcloud	Manage Hetzner Cloud-based ClickHouse environments
altinitycloud_env_k8s	Manage Kubernetes-based ClickHouse environments
altinitycloud_env_secret	Manage environment secrets and configuration

Data Sources

Data Source	Description
altinitycloud_env_aws_status	Monitor AWS environment provisioning status
altinitycloud_env_azure_status	Monitor Azure environment provisioning status
altinitycloud_env_gcp_status	Monitor GCP environment provisioning status
altinitycloud_env_hcloud_status	Monitor Hetzner Cloud environment provisioning status
altinitycloud_env_k8s_status	Monitor Kubernetes environment provisioning status

Troubleshooting

For common issues and solutions (authentication errors, immutable attributes, provisioning errors, MFA timeouts, and environment deletion), see the Troubleshooting section in the provider documentation.

Support

If you need help, reach out to us via Slack:

• Enterprise customers: Use your organization's dedicated Altinity Slack channel.
• Community: Join the AltinityDB workspace and post in the #terraform channel.
• GitHub Issues: Open an issue to report bugs or request features.

Contributing

Contributions are welcome! Please submit a Pull Request or open an issue for major changes. See CONTRIBUTING.md for development guidelines and setup instructions.

License

All code, unless specified otherwise, is licensed under the Apache-2.0 license. Copyright (c) 2023 Altinity, Inc.