terraform-provider-jdcloud

README

Terraform Provider for JDCloud

Requirements

• Terraform 0.10+
• Go 1.12(to build the provider plugin)

Using the provider

• Prepare a folder for Terraform

mkdir terraform && cd terraform 

• Prepare your jdcloud.tf. This is where Terraform begins

touch jdcloud.tf

• Download Terraform
• Download Terraform-Jdcloud-Plugin
• Launch!

terraform init

Terraform is now start working, it will manage your resources according to your jdcloud.tf We would recommend our users begin with some simple resource, say VPC and ElasticIP

How to write jdcloud.tf ? Check Here

Developing the Provider

Contributions and advices to this plugin is very welcomed. In order to get start with, you need to do the following steps.

1.Prepare Golang Environment

First you will need to have Golang1.12 installed on your machine. Besides, You will need to correctly set up $GOPATH, as well as adding $GOPATH/bin to your $PATH

2.Compile project

After you have modified the code you can compile this plugin by make build. Remember to format your code by using go fmt. If it works fine. Plugin will be in your $GOPATH/bin

$ make build
==> Checking that code complies with gofmt requirements...
go install

$ ls $GOPATH/bin | grep jdcloud
terraform-provider-jdcloud

3.Running Acceptance Test

Acceptance test can be an important part of developing process. Basically, it will first create a resource, validate its attributes and see if it works as expected. Update this resource if applied and eventually delete this resource. Acceptance tests are files in jdcloud with suffix _test.go. You can invoke an acceptance test by

make testacc

Note

• Acceptance creates real resources, it will probably cost some money.
• Process usually takes 20~30 minutes depends on your network condition.

Contact Us

Contact us JDCloud-Team devops@jd.com

License

Mozilla Public License 2.0