Overview
The extracted distribution archive includes aterraform/ directory with modules and a README.md that describes required variables, outputs, and how they connect to Kubernetes, S3, IAM, networking, and DNS. Start there for authoritative, version-specific guidance; this page only orients you.
What to read first
From the root of your extracted tarball:- Open
terraform/README.md— it includes AWS sections for creating VPC networking and an EKS cluster. - Align Terraform outputs with your
values.yaml(for exampleclusterName,region,gazetteBucket,druidBucket, and any IAM role ARN used for bucket access). - If you use Terraform-created load-balancer or web-identity resources, make sure the ingress manifests and service-account role configuration match the Terraform outputs before installing Arize AX.
Relationship to installation
The sample modules can create a reference VPC, private/public subnets, NAT and route tables, private VPC endpoints, EKS, node groups, S3 buckets, IAM roles and policies, encryption settings, and load-balancer support. Treat the network layout as a starting point unless your organization’s cloud networking team has approved it: for production, plan to integrate with your existing VPC, CIDRs, NAT/firewall design, endpoint policy, and security requirements. Terraform typically provisions:- VPC networking, subnets, route tables, security groups, NAT, and private VPC endpoints
- EKS cluster and node groups with labels aligned to Arize AX requirements
- S3 buckets and access policies for Gazette and ArizeDB data
- IAM roles, OIDC/web-identity configuration, and policy attachments for bucket and load-balancer access
- Optional supporting resources such as encryption configuration and AWS load-balancer-controller roles
kubectl to the new cluster and continue with Install Arize AX on AWS (quick start).
Ingress alignment
If Terraform creates AWS load-balancer-controller roles or related networking, align those outputs with the ingress approach you use for Arize AX. See Ingress on AWS and the endpoint examples included underexamples/endpoints/ in the distribution archive.
Source in repository
The same Terraform sources are developed in the Arize AX distribution repository; the tarball is the supported artifact for customers. Use theREADME.md inside your release for the exact version you are deploying.