Terraform Provider for Dell PowerFlex

Contributor Covenant License Go version Terraform version GitHub release (latest by date including pre-releases)

The Terraform Provider for Dell PowerFlex allows Data Center and IT administrators to use Hashicorp Terraform to automate and orchestrate the provisioning and management of Dell PowerFlex storage systems.

The Terraform Provider can be used to manage SDCs, MDM, volumes, snapshots, snapshot-policies, storage pools, SDSs, devices, protection domains, package, mapping SDC to volumes/snapshots and deploy the PowerFlex cluster. The logged-in user configured in the Terraform provider must possess adequate permissions against the target Dell PowerFlex System.

Table of contents

License

The Terraform Provider for PowerFlex is released and licensed under the MPL-2.0 license. See LICENSE for the full terms.

Prerequisites

Terraform Provider PowerFlex/VxFlex OS Version OS Terraform Golang
v1.2.0 3.6 Ubuntu22.04
RHEL8.x
RHEL9.x
1.3.x
1.5.x
1.20.x

List of DataSources in Terraform Provider for Dell PowerFlex

  • SDC
  • Storage pool
  • Volume
  • SDS
  • Protection Domain
  • Snapshot Policy
  • Device
  • vTree

List of Resources in Terraform Provider for Dell PowerFlex

  • SDC
  • Storage pool
  • Volume
  • SDS
  • Snapshot
  • Device
  • SdcVolumeMapping
  • Protection Domain
  • Package
  • Cluster
  • User
  • MDM Cluster

Installation of Terraform Provider for Dell PowerFlex

Install from Terraform Registry

The provider will be fetched from the Terraform registry and installed by Terraform automatically. Create a file called main.tf in your workspace with the following contents

terraform {
  required_providers {
    powerflex = {
      version = "1.2.0"
      source  = "registry.terraform.io/dell/powerflex"
    }
  }
}

Then, in that workspace, run

terraform init

If you are upgrading from a previous version, set the version of powerflex in the required providers block to “1.2.0” as shown above. Then, in your workspace, run

terraform init -upgrade

For more details on how to upgrade provider versions, please check out https://developer.hashicorp.com/terraform/tutorials/configuration-language/provider-versioning

Installation from source code

Dependencies: Go 1.20.x, make, Terraform 1.3.x/1.5.x

Run

git clone https://github.com/dell/terraform-provider-powerflex.git --branch v1.2.0
cd terraform-provider-powerflex
make install

Then follow installation from Terraform registry

SSL Certificate Verification

For SSL verifcation on RHEL, these steps can be performed:

  • Copy the CA certificate to the /etc/pki/ca-trust/source/anchors path of the host by any external means.
  • Import the SSL certificate to host by running
update-ca-trust extract

For SSL verification on Ubuntu, these steps can be performed:

  • Copy the CA certificate to the /etc/ssl/certs path of the host by any external means.
  • Import the SSL certificate to host by running:
 update-ca-certificates

Releasing, Maintenance and Deprecation

Terraform Provider for Dell Technnologies PowerFlex follows Semantic Versioning.

New versions will be released regularly if significant changes (bug fixes or new features) are made in the provider.

Released code versions are located on tags in the form of “vx.y.z” where x.y.z corresponds to the version number.