Skip to content

FlexibleEngineCloud/terraform-provider-flexibleengine

Repository files navigation

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.30.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.18+ 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 git@github.com: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_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.

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.

Packages

No packages published

Contributors 104

Languages