Skip to content

Latest commit

 

History

History
137 lines (110 loc) · 4.44 KB

README.md

File metadata and controls

137 lines (110 loc) · 4.44 KB
Raw

3DS OUTSCALE Terraform Provider

Project Graduated

Terraform

Requirements

  • Terraform 1.0.x

  • Go 1.13 (to build the provider plugin)

Breaking change

Warning

We have a broken change on our api when creating access_key without expiration date for all version less then v0.9.0. (GH-issues)

We recommende to upgrade on the latest (v0.11.0)

Using the Provider

Warning

Our provider terraform has been moved from outscale-dev to outscale organisation on terraform registry

The next releases will be only publish under outscale organization on terraform registry

Add the following lines in the Terraform configuration to permit to get the provider from the Terrafom registry:

terraform {
  required_providers {
    outscale = {
      source = "outscale/outscale"
      version = "0.11.0"
    }
  }
}

provider "outscale" {
  # Configuration options
}

Configuring the proxy, if any

on Linux/macOS

export HTTPS_PROXY=http://192.168.1.24:3128

on Windows

set HTTPS_PROXY=http://192.168.1.24:3128

x509 client authentication, if any

Add the following lines in the Terraform configuration to define certificate location:

terraform {
  required_version = ">= 0.13"
  required_providers {
    outscale = {
      source = "outscale/outscale"
      version = "0.11.0"
    }
  }
}

provider "outscale" {
  access_key_id = var.access_key_id
  secret_key_id = var.secret_key_id
  region = var.region
  x509_cert_path = "/myrepository/certificate/client_ca.crt"
  x509_key_path = "/myrepository/certificate/client_ca.key"
}

or set the following environment variables:

export OUTSCALE_X509CERT=/myrepository/certificate/client_ca.crt
export OUTSCALE_X509KEY=/myrepository/certificate/client_ca.key

Building The Provider

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

mkdir -p $GOPATH/src/github.com/terraform-providers
cd  $GOPATH/src/github.com/terraform-providers
git clone --branch v0.11.0 https://github.com/outscale/terraform-provider-outscale

Enter the provider directory and build the provider

cd  $GOPATH/src/github.com/outscale/terraform-provider-outscale
go build -o terraform-provider-outscale_v0.11.0

Using the provider

On Linux

  1. Download and install Terraform

  2. Move the plugin to the repository ~/.terraform.d/plugins/registry.terraform.io/outscale/outscale/0.11.0/linux_amd64/.

mkdir -p ~/.terraform.d/plugins/registry.terraform.io/outscale/outscale/0.11.0/linux_amd64
mv terraform-provider-outscale_v0.11.0 ~/.terraform.d/plugins/registry.terraform.io/outscale/outscale/0.11.0/linux_amd64

  1. Execute `terraform init

  2. Execute terraform plan

On macOS

  1. Download and install Terraform

  2. Move the plugin to the repository ~/.terraform.d/plugins/registry.terraform.io/outscale/outscale/0.11.0/darwin_arm64

mkdir -p ~/.terraform.d/plugins/registry.terraform.io/outscale/outscale/0.11.0/darwin_arm64
mv terraform-provider-outscale_v0.11.0 ~/.terraform.d/plugins/registry.terraform.io/outscale/outscale/0.11.0/darwin_arm64

  1. Execute terraform init

  2. Execute terraform plan

Issues and contributions

Check CONTRIBUTING.md for more details.

Building the documentation

Requirements:

  • make
  • python3
  • python-venv
make doc