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 using the SEMP API).

It is available on the Terraform Registry

Using the provider

See docs/index.md for details.

Note that this provider uses the missioncontrol_api v2 (as of 2025-01-27). The actual missioncontrol cloud service implmentation does NOT fully respect this api (as of 2025-03-24). Hence we cannot define specific compatibility requirements. Please test carefully (and repeatedly) before using in production environments.

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/gsolaceclustermgr" = "C:/Users/<you>/go/bin"
  }
  direct {}
}

Tips:

• if you set FAKE_SERVER_DEBUG=1 the fakeserver will be started with the debug option during acc tests
• if you set FAKE_SERVER_EXT=1 the acc test will expect a running fakeserver and skips start, so you can run the fakeserver (with -debug) in a separate window for easier checking logs

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.