terraform-provider-opentelekomcloud

command module
v1.25.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 8, 2021 License: MPL-2.0 Imports: 5 Imported by: 0

README

Terraform Open Telekom Cloud Provider

Documentation | Gitter chat | Mailing list

alt text

Quick Start

When using the OpenTelekomCloud 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 opentelekomcloud/opentelekomcloud to your required_providers.

    # provider.tf
    terraform {
      required_providers {
        opentelekomcloud = {
          source = "opentelekomcloud/opentelekomcloud"
          version = ">= 1.23.2"
        }
      }
    }
    
  2. Run terraform init -upgrade to download the provider.

  3. Add the provider and supply your tenant_name and domain_name for minimum configuration.

    # provider.tf
    provider "opentelekomcloud" {
      # OpenTelekomCloud Provider Documentation:
      # https://registry.terraform.io/providers/opentelekomcloud/opentelekomcloud/latest/docs
      # domain_name = "..."
      # tenant_name = "..."
      # auth_url    = "https://iam.eu-de.otc.t-systems.com/v3"
      # user_name   = "..."
      # password    = "..."
    }
    
  4. Authenticate either by providing user_name and password in the previous file or setting them as environment variables.

    # Linux
    OS_USERNAME="<your_username>"
    OS_PASSWORD="<your_password"
    # Windows
    $env:OS_USERNAME="<your_username>"
    $env:OS_PASSWORD="<your_password"
    
  5. Create your first resource.

    # main.tf
    
    # Create an Elastic Cloud Server resource
    resource "opentelekomcloud_compute_instance_v2" "test-server" {
      name        = "test-server"
      image_name  = "Standard_CentOS_8_latest"
      flavor_name = "s3.medium.1"
      key_pair        = "kp_ecs"
      security_groups = ["default"]
      network {
        name = "network_ecs"
      }
    }
    
Full Examples

Don't forget to fill in the required variables.

Developing the Provider

Requirements
  • Terraform 0.13+
  • Go 1.15 (to build the provider plugin)
Building The Provider

Clone repository to: $GOPATH/src/github.com/opentelekomcloud/terraform-provider-opentelekomcloud

$ export GO111MODULE=on
$ go get github.com/opentelekomcloud/terraform-provider-opentelekomcloud

Enter the provider directory and build the provider

$ cd $GOPATH/src/github.com/opentelekomcloud/terraform-provider-opentelekomcloud
$ make build

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.15+ is required).

To compile the provider, run make build. This will build the provider and put the provider binary in the current directory.

make build
...
$GOPATH/bin/terraform-provider-opentelekomcloud
...

In order to test the provider, you can simply run make test.

$ make test

In order to run the full suite of Acceptance tests, run make testacc.

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

$ make testacc

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
services/bms
This set of code handles all functions required to configure addresses on an opentelekomcloud_compute_bms_server_v2 datasource.
This set of code handles all functions required to configure addresses on an opentelekomcloud_compute_bms_server_v2 datasource.
services/deh
This set of code handles all functions required to configure networking on an opentelekomcloud_compute_instance_v2 resource.
This set of code handles all functions required to configure networking on an opentelekomcloud_compute_instance_v2 resource.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL