Skip to content

Latest commit

 

History

History
158 lines (123 loc) · 4.85 KB

README.md

File metadata and controls

158 lines (123 loc) · 4.85 KB
Raw

Terraform FlexibleEngine Provider

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.

  1. Add FlexibleEngineCloud/flexibleengine to your required_providers.

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

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

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

  3. 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"
}

  4. 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.13+ is required). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin to your $PATH.

Building the Provider

  1. 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 [email protected]:FlexibleEngineCloud/terraform-provider-flexibleengine.git

  2. 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

  3. 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_PROJECT_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"

Full Example

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

License

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