Terraform FlexibleEngine Provider

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

Quick Start

When using the FlexibleEngineCloud Provider with Terraform 0.13 and later, the recommended approach is to declare Provider versions in the root module Terraform configuration, using a required_providers block as per the following example. For previous versions, please continue to pin the version within the provider block.

Add FlexibleEngineCloud/flexibleengine to your required_providers.

# provider.tf
terraform {
  required_version = ">= 0.13"

  required_providers {
    flexibleengine = {
      source = "FlexibleEngineCloud/flexibleengine"
      version = ">= 1.30.0"
    }
  }
}

Run terraform init -upgrade to download/upgrade the provider.

Add the provider and Authenticate.

AK/SK Authenticate

# provider.tf

# Configure the FlexibleEngine Provider with AK/SK
provider "flexibleengine" {
  access_key  = "access key"
  secret_key  = "secret key"
  domain_name = "domain name"
  region      = "eu-west-0"
}

Username/Password Authenticate

# provider.tf

# Configure the FlexibleEngine Provider with Username/Password 
provider "flexibleengine" {
  user_name   = "user name"
  password    = "password"
  domain_name = "domain name"
  region      = "eu-west-0"
}

Create your first resource.

# main.tf

# Create an Elastic Cloud Server resource
resource "flexibleengine_compute_instance_v2" "test-server" {
  name        = "test-server"
  image_name  = "OBS Ubuntu 18.04"
  flavor_name = "t2.micro"
  key_pair    = "kp_ecs"
  security_groups = ["default"]
  network {
    uuid = "55534eaa-533a-419d-9b40-ec427ea7195a"
  }
}

Developing the Provider

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

Building the Provider

Clone repository to $GOPATH/src/github.com/FlexibleEngineCloud/terraform-provider-flexibleengine with go get or git clone.

go get github.com/FlexibleEngineCloud/terraform-provider-flexibleengine

cd $GOPATH/src/github.com/FlexibleEngineCloud/terraform-provider-flexibleengine
git clone git@github.com:FlexibleEngineCloud/terraform-provider-flexibleengine.git

Enter the provider directory and build the provider, run make build. This will build the provider and put the provider binary in the $GOPATH/bin directory.
```
cd $GOPATH/src/github.com/FlexibleEngineCloud/terraform-provider-flexibleengine
make build
```
In order to test the provider, you can simply run make test.
```
make test
```

Acceptance Testing

Before making a Pull Request or a release, the resources and data sources shoule be tested with acceptance tests.

The following environment variables are required before running the acceptance testing:

export OS_ACCESS_KEY=xxx
export OS_SECRET_KEY=xxx
export OS_REGION_NAME=xxx
export OS_IMAGE_ID=xxx
export OS_FLAVOR_ID=xxx
export OS_NETWORK_ID=xxx

Then we can run the acceptance tests with make testacc.

make testacc TEST='./flexibleengine' TESTARGS='-run TestAccXXXX'

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

Debugging Providers

Add the TF_LOG and TF_LOG_PATH environment variables to the system, and then you can view detailed logs. For example, in a Linux operating system, run the following commands:

export TF_LOG=TRACE
export TF_LOG_PATH="./terraform.log"

License

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