Terraform Provider for Dell Technologies PowerScale

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

The Terraform Provider can be used to manage access zone, active directory, cluster, user, user group, file system, smb share, nfs export, snapshot, snapshot schedule, quota, groupnet, subnet, network pool, network settings, smart pool settings, ldap providers, network rule, file pool policy, ntp server, ntp settings, cluster email settings, acl settings, nfs export settings, role, user mapping rules, role privilege, s3 bucket, nfs global settings, nfs zone settings, smb share settings, smb server settings, namespace acl, cluster identity, cluster snmp, cluster owner, cluster time, support assist, s3 keys, s3 zone settings, s3 global settings, synciq policies, synciq rules, synciq global settings, synciq peer certificates, writeable snapshots, snapshot restore, nfs alias, synciq replication job and synciq rules.

The logged-in user configured in the Terraform provider must possess adequate permissions against the target Dell PowerScale System.

Table of Contents

• Code of Conduct
• Maintainer Guide
• Committer Guide
• Contributing Guide
• List of Adopters
• Security
• Support
• License
• Prerequisites
• List of DataSources in Terraform Provider for Dell PowerScale
• List of Resources in Terraform Provider for Dell PowerScale
• Releasing, Maintenance and Deprecation
• Documentation
• New to Terraform?

Support

For any Terraform Provider for Dell PowerScale issues, questions or feedback, please follow our support process

License

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

Prerequisites

Terraform Provider	PowerScale Version	OS	Terraform	Golang
v1.6.0	9.5 9.7 9.8	ubuntu22.04 rhel9.x	1.8.x 1.9.x	1.22

List of DataSources in Terraform Provider for Dell PowerScale

• Cluster
• Access Zone
• ACL Settings
• Active Directory Service Provider
• Cluster Email Settings
• File Pool Policy
• File System
• Groupnet
• LDAP Provider
• Namespace ACL
• Network Pool
• Network Rule
• Network Settings
• NFS Export
• NFS Export Settings
• NFS Global Settings
• NFS Zone Settings
• NTP Server
• NTP Settings
• Quota
• Role
• Role Privilege
• S3 Bucket
• Smart Pool Settings
• SMB Server Settings
• SMB Share
• SMB Share Settings
• Snapshot
• Snapshot Schedule
• Subnet
• User
• User Group
• User Mapping Rules
• SyncIQ Policy
• SyncIQ Global Settings
• SyncIQ Rule
• SyncIQ Peer Certificate
• SyncIQ Replication Report
• NFS Alias
• Writeable Snapshot
• SyncIQ Replication Job

List of Resources in Terraform Provider for Dell PowerScale

• Access Zone
• ACL Settings
• Active Directory Service Provider
• Cluster Email Settings
• File Pool Policy
• File System
• Groupnet
• LDAP Provider
• Namespace ACL
• Network Pool
• Network Rule
• Network Settings
• NFS Export
• NFS Export Settings
• NFS Global Settings
• NFS Zone Settings
• NTP Server
• NTP Settings
• Quota
• Role
• S3 Bucket
• Smart Pool Settings
• SMB Server Settings
• SMB Share
• SMB Share Settings
• Snapshot
• Snapshot Schedule
• Subnet
• User
• User Group
• User Mapping Rules
• Cluster Identity
• Cluster SNMP
• Cluster Owner
• Cluster Time
• Support Assist
• S3 Key
• S3 Zone Settings
• S3 Global Settings
• SyncIQ Policy
• SyncIQ Global Settings
• SyncIQ Peer Certificate
• Support Assist
• Writeable Snapshot
• Snapshot Restore
• NFS Alias
• SyncIQ Replication Job
• SyncIQ Rules

Installation and execution of Terraform Provider for Dell PowerScale

Installation from public repository

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

terraform {
  required_providers {
    powerscale = { 
      version = "1.6.0"
      source = "registry.terraform.io/dell/powerscale"
    }
  }
}

Then, in that workspace, run

terraform init

Installation from source code

1. Clone this repo
2. In the root of this repo run

make install

Then follow installation from public repo

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 Technologies PowerScale follows Semantic Versioning.

New versions will be release regularly if significant changes (bug fix or new feature) 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.

Documentation

For more detailed information, please refer to Dell Terraform Providers Documentation.

New to Terraform?

Here are some helpful links to get you started if you are new to terraform before using our provider:

• Intro to Terraform: https://developer.hashicorp.com/terraform/intro
• Providers: https://developer.hashicorp.com/terraform/language/providers
• Resources: https://developer.hashicorp.com/terraform/language/resources
• Datasources: https://developer.hashicorp.com/terraform/language/data-sources
• Import: https://developer.hashicorp.com/terraform/language/import
• Variables: https://developer.hashicorp.com/terraform/language/values/variables
• Modules: https://developer.hashicorp.com/terraform/language/modules
• State: https://developer.hashicorp.com/terraform/language/state