3.4 KiB

Raw Blame History

terraform-provider-decort

Terraform provider for Digital Energy Cloud Orchestration Technology (DECORT) platform

NOTE: provider rc-1.25 is designed for DECORT API 3.7.x. For older API versions please use:

DECORT API 3.6.x versions - provider version rc-1.10
DECORT API versions prior to 3.6.0 - Terraform DECS provider (https://github.com/rudecs/terraform-provider-decs)

Features

Work with Compute instances,
Work with disks,
Work with k8s,
Work with virtual network segments,
Work with image,
Work with reource groups,
Work with VINS,
Work with pfw,
Work with accounts.

This provider supports Import operations on pre-existing resources.

See user guide at https://github.com/rudecs/terraform-provider-decort/wiki

Get Started

Two ways for starting:

Installing via binary packages
Manual installing

Installing via binary packages

Download and install terraform: https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started
Create a file main.tf and add to it next section.

provider "decort" {
  authenticator = "oauth2"
  #controller_url = <DECORT_CONTROLLER_URL>
  controller_url = "https://ds1.digitalenergy.online"
  #oauth2_url = <DECORT_SSO_URL>
  oauth2_url           = "https://sso.digitalenergy.online"
  allow_unverified_ssl = true
}

Execute next command

terraform init

The Provider will automatically install on your computer from the terrafrom registry.

Manual installing

Download and install Go Programming Language: https://go.dev/dl/
Download and install terraform: https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started
Clone provider's repo:

git clone https://github.com/rudecs/terraform-provider-decort.git

Change directory to clone provider's and execute next command

go build -o terraform-provider-decort

If you have experience with makefile, you can change Makefile's paramters and execute next command

make build

Now move compilled file to:
Linux:

~/.terraform.d/plugins/${host_name}/${namespace}/${type}/${version}/${target}

Windows:

%APPDATA%\terraform.d\plugins\${host_name}/${namespace}/${type}/${version}/${target}

NOTE: for Windows OS %APP_DATA% is a cataloge, where will place terraform files. Example:

host_name - digitalenergy.online
namespace - decort
type - decort
version - 1.2
target - windows_amd64

After all, create a file main.tf.
Add to the file next code section

terraform {
  required_providers {
    decort = {
      version = "1.2"
      source  = "digitalenergy.online/decort/decort"
    }
  }
}

version- field for provider's version Required String Note: Versions in code section and in a repository must be equal!

source - path to repository with provider's version

${host_name}/${namespace}/${type}

NOTE: all paramters must be equal to the repository path!

Execute command in your terminal

terraform init

If everything all right - you got green message in your terminal!

More details about the provider's building process: https://learn.hashicorp.com/tutorials/terraform/provider-use?in=terraform/providers

Examples and Samples

Examples: https://github.com/rudecs/terraform-provider-decort/wiki
Samples: in repository samples

Good work!

3.4 KiB Raw Blame History