Skip to content

Latest commit

 

History

History
122 lines (99 loc) · 3.72 KB

README.md

File metadata and controls

122 lines (99 loc) · 3.72 KB
Raw

3DS OUTSCALE Terraform Provider

Project Graduated

Terraform

Requirements

  • Terraform 1.0.x

  • Go 1.13 (to build the provider plugin)

Using the Provider

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

terraform {
  required_providers {
    outscale = {
      source = "outscale-dev/outscale"
      version = "0.7.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-dev/outscale"
      version = "0.7.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/terraform-providers/terraform-provider-outscale

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

Enter the provider directory and build the provider

cd  $GOPATH/src/github.com/terraform-providers/terraform-provider-outscale
go build -o terraform-provider-outscale_v0.7.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-dev/outscale/0.7.0/linux_amd64/.

mkdir -p ~/.terraform.d/plugins/regisutry.terraform.io/outscale-dev/outscale/0.7.0/linux_amd64
mv terraform-provider-outscale_v0.7.0 ~/.terraform.d/plugins/registry.terraform.io/outscale-dev/outscale/0.7.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-dev/outscale/0.7.0/darwin_arm64

mkdir -p ~/.terraform.d/plugins/registry.terraform.io/outscale-dev/outscale/0.7.0/darwin_arm64
mv terraform-provider-outscale_v0.7.0 ~/.terraform.d/plugins/registry.terraform.io/outscale-dev/outscale/0.7.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