Terraform Provider for Solace MissionControl ClusterManager

This provider, maintained by GEBIT Solutions GmbH, supports a small part of the Solace missioncontrol API (https://api.solace.cloud/api/v2/missionControl), namely the operations to create and delete PubSub+ Software Event Brokers in the Solace cloud (while the official solace terraform provider allows you to configure them further).

It is available on the Terraform Registry

Using the provider

The provider allows you to create/update/delate Solace cloud API broker instances.

Define the provider with the solace API URL and a valid bearerToken:

provider "gsolaceclustermgr" {
  bearer_token = "<someBearerToken>"
  host = "https://api.solace.cloud"
}

Then create a broker using the gsolaceclustermgr_broker resource

resource "gsolaceclustermgr_broker" "ocs-test" {
  count           = 1
  serviceclass_id = "ENTERPRISE_250_STANDALONE"
  name            = "ocs-prov-testHH"
  datacenter_id   = "aks-germanywestcentral"
  msg_vpn_name    = "ocs-msgvpn-1"
  cluster_name    = "gwc-aks-cluster1"
}

Updating the broker is supported - but only the name attribute may be changed.

The official solace terraform provider covers further manipulation like messageVPN setup.

Development

This provider is based on the HashiCorp Developer Tutorial.

Requirements

• Terraform >= 1.0
• Go 1.22

Building The Provider

1. Clone the repository
2. Enter the repository directory
3. Build the provider using the Go install command:

go install

Adding Dependencies

This provider uses Go modules. Please see the Go documentation for the most up to date information about using Go modules.

go get github.com/author/dependency
go mod tidy

Then commit the changes to go.mod and go.sum.

Provider Implementation

This provider only supports a small part of the missioncontrol API v2. It is curretnly not planned to implement the complete API.

The REST client to access the API is generated using [oapi-codegen] (https://github.com/deepmap/oapi-codegen) . For CI testing the provider without actually calling the productive solace API, a fakeserver is included.

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (see Requirements above).

To compile the provider, run go install. This will build the provider and put the provider binary in the $GOPATH/bin directory.

To generate or update documentation, run go generate.

In order to run the full suite of Acceptance tests, run make testacc.

make testacc

For local manual tests with terraform put this into your %APPDATA%\terraform.rc file:

provider_installation {

  dev_overrides {
	  "gebit.de/tf/gsolaceclustermgr" = "C:/Users/<you>/go/bin"
  }
  direct {}
}

Contributing

Feedback and / or contributions are welcome. Contact [email protected] for details.

License

This project is licensed under the Mozilla Public License, Version 2.0. - See the LICENSE file for details.