terraform-provider-nks

README

NKS Provider for Terraform

NetApp Kubernetes Service (NKS) is a universal control plane for creating and managing Kubernetes clusters.

• Website: https://cloud.netapp.com/kubernetes-service

Requirements

• NKS Account
• Terraform 0.10.x
• Go 1.9 (to build the provider plugin)

Building the Provider

Clone repository to: $GOPATH/src/github.com/NetApp/terraform-provider-nks

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

Enter the provider directory and build the provider.

$ cd $GOPATH/src/github.com/NetApp/terraform-provider-nks
$ make build

Using the Provider

If you're building the provider, follow the instructions to install it as a plugin. After placing the binary into your plugins directory, run terraform init to initialize it.

Examples

The examples cover basic scenarios for using NetApp Kubernetes Services. Each example has a related README with more details on the topic. The following examples are availabe:

• Add a keyset
• Create an AKS cluster
• Create an AWS cluster
• Create an Azure cluster
• Create an EKS cluster
• Create a GCE cluster
• Create a GKE cluster
• Create a cluster and install solutions from the gallery

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.9+ is required). You will also need to correctly setup a GOPATH, as well as adding $GOPATH/bin to your $PATH.

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

$ make build
...
$ $GOPATH/bin/terraform-provider-nks
...

In order to test the provider, you can simply run make test.

$ make test

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

Note: Acceptance tests create real resources and often cost money to run.

$ make testacc

If you need to add a new package in the vendor directory under github.com/NetApp/nks-sdk-go, create a separate PR handling only the update of the vendor for your new requirement. Make sure to pin your dependency to a specific version, and that all versions of github.com/NetApp/nks-sdk-go/* are pinned to the same version.

Terraform Resources

• Website: https://www.terraform.io/
• 
• Mailing list: Google Groups