README
¶
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
- 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.
Migration Steps
Step 1: Upgrade provider version
terraform {
required_providers {
outscale = {
source = "outscale/outscale"
version = "1.3.1"
}
}
}
provider "outscale" {
# Configuration
}
terraform init -upgrade
Step 2: Clean up state & configuration
Linux
sed -i 's/outscale_volumes_link/outscale_volume_link/g' terraform.tfstate
# + Other sed commands
macOS
sed -i='' 's/outscale_volumes_link/outscale_volume_link/g' terraform.tfstate
# + Other sed commands
Step 3: Refresh
terraform refresh
💥 Breaking Changes
⚠️ Important: There is a breaking change when creating an
access_keywithout expiration date in versions< v0.9.0. See Issue #342.
🚀 Using the Provider
With Terraform
terraform {
required_providers {
outscale = {
source = "outscale/outscale"
version = "1.3.1"
}
}
}
provider "outscale" {
# Configuration options
}
terraform init
terraform plan
With OpenTofu
terraform {
required_providers {
outscale = {
source = "outscale/outscale"
version = "1.3.1"
}
}
}
provider "outscale" {
# Configuration options
}
tofu init
tofu plan
👉 See OpenTofu migration guide.
🌍 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
Add to your provider config:
provider "outscale" {
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.3.1 https://github.com/outscale/terraform-provider-outscale
cd terraform-provider-outscale
go build -o terraform-provider-outscale_v1.3.1
📦 Using the Built Provider
After building the provider manually, install it locally depending on your platform and tooling:
For Terraform
On Linux
1. Download and install [Terraform](https://www.terraform.io/downloads.html).- Move the plugin to the repository:
mkdir -p terraform.d/plugins/registry.terraform.io/outscale/outscale/1.3.1/linux_amd64
mv terraform-provider-outscale_v1.3.1 terraform.d/plugins/registry.terraform.io/outscale/outscale/1.3.1/linux_amd64/
- Initialize Terraform:
terraform init
- Plan your Terraform configuration:
terraform plan
On macOS
1. Download and install [Terraform](https://www.terraform.io/downloads.html).- Move the plugin to the repository:
mkdir -p terraform.d/plugins/registry.terraform.io/outscale/outscale/1.3.1/darwin_arm64
mv terraform-provider-outscale_v1.3.1 terraform.d/plugins/registry.terraform.io/outscale/outscale/1.3.1/darwin_arm64/
- Initialize Terraform:
terraform init
- Plan your Terraform configuration:
terraform plan
For OpenTofu
On Linux
1. Download and install [OpenTofu](https://opentofu.org/docs/intro/install/deb/).- Move the plugin to the repository:
mkdir -p terraform.d/plugins/registry.opentofu.org/outscale/outscale/1.3.1/linux_amd64
mv terraform-provider-outscale_v1.3.1 terraform.d/plugins/registry.opentofu.org/outscale/outscale/1.3.1/linux_amd64/
- Initialize OpenTofu:
tofu init
- Plan your configuration:
tofu plan
On macOS
1. Download and install [OpenTofu](https://opentofu.org/docs/intro/install/homebrew/).- Move the plugin to the repository:
mkdir -p terraform.d/plugins/registry.opentofu.org/outscale/outscale/1.3.1/darwin_arm64
mv terraform-provider-outscale_v1.3.1 terraform.d/plugins/registry.opentofu.org/outscale/outscale/1.3.1/darwin_arm64/
- Initialize OpenTofu:
tofu init
- Plan your configuration:
tofu plan
🤝 Contributing
See CONTRIBUTING.md.
📝 Building the Documentation
Requirements:
makepython3python-venv
make doc
Documentation
¶
There is no documentation for this package.
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.