Skip to content

A simple Terraform provider to interact with EfficientIP's SOLIDServer

License

Notifications You must be signed in to change notification settings

alexissavin/terraform-provider-solidserver

Repository files navigation

License Go Report Card


IMPORTANT

The official repository for this project is now managed by EfficientIP-Labs and available here


EfficientIP SOLIDserver Provider

This provider allows to easily interact with EfficientIP's SOLIDserver REST API. It allows to manage supported resources through CRUD operations for efficient DDI orchestration.

This provider is compatible with EfficientIP SOLIDserver version 6.0.2 and higher.

Build

Download the latest revision of the master branch then use the go compiler to generate the binary.

cd "${GOPATH}"
go get github.com/EfficientIP-Labs/terraform-provider-solidserver
cd ./src/github.com/EfficientIP-Labs/terraform-provider-solidserver
go get
go build -o terraform-provider-solidserver_vX.Y.Z

Install

If using terraform 0.13 or higher, you can leverage the terraform registry to install the provider see here.

Download the appropriate build for your system from the release page or build the master branch of this repository.

Linux

Move the binary file terraform-provider-solidserver_vX.Y.Z into the following directory: $HOME/.terraform.d/plugins/.

Windows

Move the binary file terraform-provider-solidserver_vX.Y.Z into the following directory: %APPDATA%\terraform.d\plugins\windows_amd64\.

Debug

You can enable debug mode by exporting TF_LOG environment variable setting its value to DEBUG.

For further details have a look to the terraform documentation

Acceptance Tests

In order to perform the acceptance tests of the solidserver module, first set in your environment the variables required for the connection (SOLIDServer_HOST, SOLIDServer_USERNAME and SOLIDServer_PASSWORD). In addition you could disable the TLS certificate validation by setting the SOLIDServer_SSLVERIFY to false.

TF_ACC=1 go test solidserver -v -count=1 -tags "all"

Using the SOLIDserver provider

SOLIDServer provider supports the following arguments:

  • username - (Required) Username used to establish the connection. Can be stored in SOLIDServer_USERNAME environment variable.
  • password - (Required) Password associated with the username. Can be stored in SOLIDServer_PASSWORD environment variable.
  • host - (Required) IP Address of the SOLIDServer REST API endpoint. Can be stored in SOLIDServer_HOST environment variable.
  • sslverify - (Optional) Enable/Disable ssl certificate check. Can be stored in SOLIDServer_SSLVERIFY environment variable.
  • additional_trust_certs_file - (Optional) Path to a file containing concatenated PEM-formatted certificates that will be trusted in addition to system defaults.
  • solidserverversion - (Optional) The version of the SOLIDserver to interact with. This field is only for API users not able to retrieve this information dynamically.
provider "solidserver" {
    username = "username"
    password = "password"
    host  = "192.168.0.1"
    sslverify = "false"
}

Available Resources

SOLIDServer provider allows to manage several resources listed below:

Available Data-Sources

SOLIDServer provider allows to retrieve information from several resources listed below:

About

A simple Terraform provider to interact with EfficientIP's SOLIDServer

Resources

License

Stars

Watchers

Forks

Packages

No packages published