Terraform Official Registry

The Control Plane Terraform modules are now available on the official Terraform Registry.

The Control Plane Terraform modules are now published on the official Terraform Registry, replacing the archived gatling/gatling-enterprise-control-plane-deployment repository.

You can now declare the source directly by registry address, without pointing to a Git repository:

module "control_plane" {
  source  = "gatling/control-plane/aws"
  version = "~> 0.0"
}

module "control_plane" {
  source  = "gatling/control-plane/azure"
  version = "~> 0.0"
}

module "control_plane" {
  source  = "gatling/control-plane/gcp"
  version = "~> 0.0"
}

The ~> 0.0 version constraint follows semantic versioning: minor and patch versions increment freely (e.g. 0.0.1, 0.1.0, 0.5.3), while 1.0.0 is reserved for breaking changes. Run terraform init -upgrade to pick up new compatible versions.

Migrate from the archived repository#

The former pattern used three separate modules (location, private-package, and control-plane) sourced via git URLs.

These now collapse into a single registry module. Move the location and private-package arguments inline into module "control-plane" as the locations list and private-package object.

Replace the old git-sourced modules:

module "location" {
  source = "git::https://github.com/gatling/gatling-enterprise-control-plane-deployment//terraform/<provider>/location"
  # ...
}

module "private-package" {
  source = "git::https://github.com/gatling/gatling-enterprise-control-plane-deployment//terraform/<provider>/private-package"
  # ...
}

module "control-plane" {
  source = "git::https://github.com/gatling/gatling-enterprise-control-plane-deployment//terraform/<provider>/control-plane"
  # ...
}

With the single registry module:

module "control-plane" {
  source  = "gatling/control-plane/<provider>"
  version = "~> 0.0"

  # ... existing configuration
  locations = [
    # previously module location
  ]

  private-package = {
    # previously module private-package
  }
}

Then reinitialize Terraform to download the module from the registry:

terraform init -upgrade

See the full example configurations for all available options:

• AWS: example/main.tf
• Azure: example/main.tf
• GCP: example/main.tf

Edit this page on GitHub