Home  /  Installation

Appendix: Terraforms

To help you get started, Materialize provides some template Terraforms.

! Important:

These modules are intended for evaluation/demonstration purposes and for serving as a template when building your own production deployment. The modules should not be directly relied upon for production deployments: future releases of the modules will contain breaking changes. Instead, to use as a starting point for your own production deployment, either:

  • Fork the repo and pin to a specific version; or

  • Use the code as a reference when developing your own deployment.

Sample Module Description
terraform-helm-materialize A sample Terraform module for installing the Materialize Helm chart into a Kubernetes cluster.
Materialize on AWS A sample Terraform module for deploying Materialize on AWS Cloud Platform with all required infrastructure components. See Install on AWS for an example usage.
Materialize on Azure A sample Terraform module for deploying Materialize on Azure with all required infrastructure components. See Install on Azure for an example usage.
Materialize on Google Cloud Platform (GCP) A sample Terraform module for deploying Materialize on Google Cloud Platform (GCP) with all required infrastructure components. See Install on GCP for an example usage.

Releases

Materialize on AWS Terraform modules

Terraform version Notable changes
v0.3.1 By default, deploys OpenEBS and NVMe instance storage to enable spill-to-disk.
v0.3.0 By default, deploys the AWS Load Balancer Controller as well as Network Load Balancers (NLBs) for each Materialize instance (i.e., the create_nlb flag defaults to true). The NLBs, by default, are configured to be internal (i.e., the internal_nlb flag defaults to true).
v0.2.7 Initial release of Materialize on AWS.

If upgrading from a deployment that was set up using an earlier version of the Terraform modules, additional considerations may apply when using an updated Terraform modules to your existing deployments.

See also Upgrade Notes for release-specific upgrade notes.

Materialize on Azure Terraform modules

Terraform version Notable changes
v0.2.0

  • The providers must be specified. The examples/simple/main.tf has been updated to reflect this.

  • The network_config is now a required input. Previously, a default value was provided. The examples/simple/main.tf has been updated to reflect this.
v0.1.4 Initial release of Materialize on Azure.

If upgrading from a deployment that was set up using an earlier version of the Terraform modules, additional considerations may apply when using an updated Terraform modules to your existing deployments.

Materialize on GCP Terraform modules

Terraform version Notable changes
v0.2.0

  • The providers must be specified. The examples/simple/main.tf has been updated to reflect this.

  • The network_config is now a required input. Previously, a default value was provided. The examples/simple/main.tf has been updated to reflect this.
v0.1.7 Initial release of Materialize on GCP.

If upgrading from a deployment that was set up using an earlier version of the Terraform modules, additional considerations may apply when using an updated Terraform modules to your existing deployments.

Back to top ↑