terraform-provider-outscale

3DS OUTSCALE Terraform Provider

🌐 Links

• Terraform website: https://www.terraform.io
• Gitter chat
• Mailing list

📄 Table of Contents

• Requirements
• Migration to v1
• Breaking Changes
• Using the Provider
  • With Terraform
  • With OpenTofu
• Provider Configuration
  • Basic Configuration
  • Migration from Deprecated Attributes
• Proxy Configuration
• x509 Authentication
• Building the Provider
• Using the Built Provider
• Contributing
• Building the Documentation

✅ Requirements

• Terraform 1.10.x or latest
• Go 1.24.2 (to build the provider)

🚀 Migration to v1

⚠️ Warning: Always backup your state file before migrating!

See MIGRATION GUIDE for full instructions.

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

provider "outscale" {
  # Configuration
}

terraform init -upgrade

sed -i 's/outscale_volumes_link/outscale_volume_link/g' terraform.tfstate
# + Other sed commands

sed -i='' 's/outscale_volumes_link/outscale_volume_link/g' terraform.tfstate
# + Other sed commands

terraform refresh

💥 Breaking Changes

⚠️ Important: There is a breaking change when creating an access_key without expiration date in versions < v0.9.0. See Issue #342.

🚀 Using the Provider

With Terraform

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

provider "outscale" {
  # Configuration options
}

terraform init
terraform plan

With OpenTofu

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

provider "outscale" {
  # Configuration options
}

tofu init
tofu plan

👉 See OpenTofu migration guide.

⚙️ Provider Configuration

Starting from version 1.4.0, the provider supports per-service configuration using api and oks blocks. This allows you to specify different endpoints, regions, and authentication settings for the Outscale API and OKS API independently.

Basic Configuration

provider "outscale" {
  access_key_id = "your-access-key"
  secret_key_id = "your-secret-key"
  
  api {
    endpoint       = "https://api.eu-west-2.outscale.com"
    region         = "eu-west-2"
    x509_cert_path = "/path/to/cert.pem"
    x509_key_path  = "/path/to/key.pem"
    insecure       = false
  }
  
  oks {
    endpoint = "https://api.eu-west-2.oks.outscale.com/api/v2"
    region   = "eu-west-2"
  }
}

Migration from Deprecated Attributes

⚠️ Deprecation: The following top-level attributes are deprecated and will be removed in the next major version. Please migrate to the new per-service configuration blocks.

🌍 Proxy Configuration

Linux/macOS

export HTTPS_PROXY=http://192.168.1.24:3128

Windows

set HTTPS_PROXY=http://192.168.1.24:3128

🔐 x509 Authentication

⚠️ Deprecation: Top-level x509_cert_path and x509_key_path attributes are deprecated. Use the api block configuration instead.

provider "outscale" {
  api {
    x509_cert_path = "/myrepository/certificate/client_ca.crt"
    x509_key_path  = "/myrepository/certificate/client_ca.key"
  }
}

Or set environment variables:

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

🛠 Building the Provider

Clone and build:

git clone --branch v1.5.0 https://github.com/outscale/terraform-provider-outscale
cd terraform-provider-outscale
go build -o terraform-provider-outscale_v1.5.0

📦 Using the Built Provider

After building the provider manually, install it locally depending on your platform and tooling:

For Terraform

mkdir -p terraform.d/plugins/registry.terraform.io/outscale/outscale/1.5.0/linux_amd64
mv terraform-provider-outscale_v1.5.0 terraform.d/plugins/registry.terraform.io/outscale/outscale/1.5.0/linux_amd64/

terraform init

terraform plan

mkdir -p terraform.d/plugins/registry.terraform.io/outscale/outscale/1.5.0/darwin_arm64
mv terraform-provider-outscale_v1.5.0 terraform.d/plugins/registry.terraform.io/outscale/outscale/1.5.0/darwin_arm64/

terraform init

terraform plan

For OpenTofu

mkdir -p terraform.d/plugins/registry.opentofu.org/outscale/outscale/1.5.0/linux_amd64
mv terraform-provider-outscale_v1.5.0 terraform.d/plugins/registry.opentofu.org/outscale/outscale/1.5.0/linux_amd64/

tofu init

tofu plan

mkdir -p terraform.d/plugins/registry.opentofu.org/outscale/outscale/1.5.0/darwin_arm64
mv terraform-provider-outscale_v1.5.0 terraform.d/plugins/registry.opentofu.org/outscale/outscale/1.5.0/darwin_arm64/

tofu init

tofu plan

🤝 Contributing

See CONTRIBUTING.md.

📝 Building the Documentation

Requirements:

• make
• python3
• python-venv

make doc