Terraform Open Telekom Cloud Provider
- Website: https://www.terraform.io
- Mailing list: Google Groups
Requirements
Building The Provider
Clone repository to: $GOPATH/src/github.com/opentelekomcloud/terraform-provider-opentelekomcloud
go get github.com/opentelekomcloud/terraform-provider-opentelekomcloud
Enter the provider directory and build the provider
cd $GOPATH/src/github.com/opentelekomcloud/terraform-provider-opentelekomcloud
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.11.1.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.11.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/opentelekomcloud/terraform-provider-opentelekomcloud
cd ~/go/src/github.com/opentelekomcloud/terraform-provider-opentelekomcloud/
make build
export PATH=$PATH:~/go/bin # You should put in your .profile or .bashrc
compatible with terraform 0.12
wget https://releases.hashicorp.com/terraform/0.12.0/terraform_0.12.0_linux_amd64.zip
unzip terraform_0.12.0_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
- AK/SK Configuration
# Configure the OpenTelekomCloud Provider with AK/SK
# This will work with a single defined/default network, otherwise you need to specify network to fix errors about multiple networks found.
provider "opentelekomcloud" {
tenant_name = "tenant name"
access_key = "access key"
secret_key = "secret key"
auth_url = "https://iam.eu-de.otc.t-systems.com/v3"
region = "eu-de"
}
# Create a web server
resource "opentelekomcloud_compute_instance_v2" "test-server" {
name = "test-server"
image_name = "Standard_CentOS_7_latest"
flavor_name = "s1.medium"
}
- Username/Password Configuration
# Configure the OpenTelekomCloud Provider
# This will work with a single defined/default network, otherwise you need to specify network to fix errrors about multiple networks found.
provider "opentelekomcloud" {
user_name = "user"
tenant_name = "tenant"
domain_name = "domain"
password = "pwd"
auth_url = "https://iam.eu-de.otc.t-systems.com/v3"
region = "eu-de"
}
# Create a web server
resource "opentelekomcloud_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/opentelekomcloud/terraform-provider-opentelekomcloud/tree/master/examples, you must fill in the required variables in variables.tf.
Using the provider
Please see the documentation at provider usage.
Developing the Provider
If you wish to work on the provider, you'll first need Go installed on your machine (version 1.11+ 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-opentelekomcloud
...
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