terraform-provider-decort

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

Mapping of platform versions with provider versions

DECORT API version	Terraform provider version
3.8.5	3.4.x
3.8.0 - 3.8.4	3.3.1
3.7.x	rc-1.25
3.6.x	rc-1.10
до 3.6.0	terraform-provider-decs

Working modes

The provider support two working modes:

• User mode,
• Administator mode. Use flag DECORT_ADMIN_MODE for swithcing beetwen modes. See user guide at https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki

Features

• Work with Compute instances,
• Work with disks,
• Work with k8s,
• Work with image,
• Work with reource groups,
• Work with VINS,
• Work with pfw,
• Work with accounts,
• Work with snapshots,
• Work with pcidevice.
• Work with sep,
• Work with vgpu,
• Work with bservice,
• Work with extnets,
• Work with locations,
• Work with load balancers.

This provider supports Import operations on pre-existing resources.

See user guide at https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki

Get Started

Two ways for starting:

1. Installing via binary packages
2. Manual installing

Installing via binary packages

1. Download and install terraform: https://learn.hashicorp.com/tutorials/terraform/install-cli?in=terraform/aws-get-started
2. 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
}

3. Execute next command

terraform init

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

Manual installing

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

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

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

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

6. After all, create a file main.tf.
7. 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!

8. Execute command in your terminal

terraform init

9. 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://repository.basistech.ru/BASIS/terraform-provider-decort/wiki
• Samples: see in repository samples

Terraform schemas in:

• See in repository docs

Good work!