CiscoDevNet / terraform-provider-intersight

Cisco Intersight Terraform
Mozilla Public License 2.0
19 stars 27 forks source link

Terraform provider for Cisco Intersight

Requirements

Using the Provider

The Intersight Terraform provider can be downloaded from the release section of this repository. The providers are available for Darwin, FreeBSD(386, amd64, arm, arm64), Linux(386, amd64, arm, arm64) and Windows(386 and amd64) systems. Documentation of the provider resources, data sources and configuration options can be found here. For a detailed explanation on usage of Intersight Terraform Provider, please read the user guide. Refer to examples for terraform configuration files of server configuration, deployment and OS installation.

Developing the Provider

Clone repository to: $GOPATH/src/github.com/CiscoDevNet/

$ mkdir -p $GOPATH/src/github.com/CiscoDevNet/; cd $GOPATH/src/github.com/CiscoDevNet/
$ git clone git@github.com:CiscoDevNet/terraform-provider-intersight.git
$ cd terraform-provider-intersight

To compile the provider, run make. This will build the providers for Linux, Darwin and Windows 64-bit architecture in the .build. To use locally build providers, run the following commands in the directory where the configurations file reside.

mkdir -p terraform.d/plugins/registry.terraform.io/ciscodevnet/intersight/<PROVIDER_VERSION>/<OS_ARCH>
cp $GOPATH/src/github.com/CiscoDevNet/terraform-provider-intersight/.build/<OS_ARCH>/terraform-provider-intersight_v<PROVIDER_VERSION>

PROVIDER_VERSION should be the same version as mentioned in the makefile of the provider repository. OS_ARCH can be one of linux_amd64, darwin_amd64 and windows.

Frequency of update

The provider is updated with each production push on Intersight, i.e., every Friday. Exceptions are made for high priority bug fixes.

Contribution

The community can contribute to expanding the example base for the provider. This includes HCL configurations for resources and data sources. A large part of the provider is generated using a custom generator. Hence, pull requests only on the examples directory are welcome at this time. For all other change requests, raise an issue.

Community

We are on Slack - slack requires registration, but the terraform-provider-intersight team is open invitation to anyone to register here