Terraform TelefonicaOpenCloud Provider

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

Terraform-Provider-TelefonicaOpencloud is a Terraform Provider for TelefonicaOpencloud. It is based on Terraform-Provider-OpenStack which is a standard Terraform OpenStack Provider. Terraform-Provider-TelefonicaOpencloud has renamed OpenStack with TelefonicaOpencloud and added some enhancements to interact with the many resources supported by TelefonicaOpencloud.

Enhancements

autoscaling: auto scaling service
ces: cloud eye service
rds: relational database service
elb: elastic load balance service
smn: simple message notification service

Maintainers

This provider plugin is maintained by:

Edward Lee (@freesky-edward)
zengchen (@zengchen1024)
Zhenguo Niu (@niuzhenguo)
huangtianhua (@h00130372)
Chen Ying (@chenyingkof)

Requirements

Terraform 0.10.x
Go 1.8 (to build the provider plugin)

Building The Provider

Clone repository to: $GOPATH/src/github.com/huaweicloud/terraform-provider-telefonicaopencloud

$ mkdir -p $GOPATH/src/github.com/huaweicloud; cd $GOPATH/src/github.com/huaweicloud
$ git clone https://github.com/huaweicloud/terraform-provider-telefonicaopencloud

Enter the provider directory and build the provider

$ cd $GOPATH/src/github.com/huaweicloud/terraform-provider-telefonicaopencloud
$ make build

Exact steps on clean Ubuntu 16.04

# prerequisites are sudo privileges, unzip, make, wget and git.  Use apt install if missing.
$ wget https://storage.googleapis.com/golang/go1.9.1.linux-amd64.tar.gz
$ sudo tar -C /usr/local -xzf go1.9.1.linux-amd64.tar.gz
$ export PATH=$PATH:/usr/local/go/bin # You should put in your .profile or .bashrc
$ go version # to verify it runs and version #
$ go get github.com/huaweicloud/terraform-provider-telefonicaopencloud
$ cd ~/go/src/github.com/huaweicloud/terraform-provider-telefonicaopencloud
$ make build
$ export PATH=$PATH:~/go/bin # You should put in your .profile or .bashrc
$ wget https://releases.hashicorp.com/terraform/0.10.7/terraform_0.10.7_linux_amd64.zip
$ unzip terraform_0.10.7_linux_amd64.zip
$ mv terraform ~/go/bin/
$ terraform version # to verify it runs and version #
$ vi test.tf # paste in Quick Start contents, fix authentication information
$ terraform init
$ terraform plan
$ terraform apply # Should all work if everything is correct.

Quick Start

# Configure the TelefonicaOpenCloud Provider
# This will work with a single defined/default network, otherwise you need to specify network
# to fix errrors about multiple networks found.
provider "telefonicaopencloud" {
  user_name   = "user"
  tenant_name = "tenant"
  domain_name = "domain"
  password    = "pwd"
  # the auth url format follows: https://iam.{region_id}.telefonicaopencloud.com:443/v3
  auth_url    = "https://iam.sa-chile-1.telefonicaopencloud.com:443/v3"
  region      = "sa-chile-1"
}

# Create a web server
resource "telefonicaopencloud_compute_instance_v2" "test-server" {
  name        = "test-server"
  image_name  = "Standard_CentOS_7_latest"
  flavor_name = "s1.medium"
}

Full Example

Please see full example at https://github.com/huaweicloud/terraform-provider-telefonicaopencloud/tree/master/examples, you must fill in the required variables in variables.tf.

Using the provider

Please see the documentation at provider usage.

Or you can browse the documentation within this repo here.

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.8+ is required). You'll 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-telefonicaopencloud
...

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

License

Terraform-Provider-TelefonicaOpencloud is under the Mozilla Public License 2.0. See the LICENSE file for details.

huaweicloud / terraform-provider-telefonicaopencloud

readme