Installation of Terraform Provider for Dell Apex

Installation from public repository

The Apex Provider can be found on the Terraform Registry here

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 {
    apex = { 
      version = "1.0.0-beta.2"
      source = "registry.terraform.io/dell/Apex"
    }
  }
}

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

Usage

Once you have installed the Apex provider, you can start using it in your Terraform configuration files. The provider has a number of resources that you can use to manage your Apex Resources.

For example, you can use the apex_navigator_block_storage resource to deploy a new storage system:

resource "apex_navigator_block_storage" "cloud_instance" {
  # Type of system you want to deploy
  system_type = "POWERFLEX"
  # The name of the system.
  name = "apex-navigator-terraform"

  product_version = "4.5.1"
  deployment_details = {
    system_public_cloud = {
      deployment_type            = "PUBLIC_CLOUD"
      cloud_type                 = "AWS"
      cloud_account              = "123456789012"
      cloud_region               = "us-east-1"
      availability_zone_topology = "SINGLE_AVAILABILITY_ZONE"
      minimum_iops               = "100"
      minimum_capacity           = "8"
      tier_type                  = "BALANCED"
      ssh_key_name               = "apex-navigator-terraform-key"
      vpc = {
        is_new_vpc = false
        vpc_id     = "vpc-12345678901234567"
        # vpc_name                 = "my-vpc"
      }
      subnet_options = [
        {
          subnet_id = "subnet-12345678901234567"
          #cidr_block  = "30.0.8.0/22"
          subnet_type = "EXTERNAL"
        },
        {
          #subnet_id   = "subnet-2"
          cidr_block  = "10.0.16.0/21"
          subnet_type = "INTERNAL"
        }
      ]
    }
  }

For more resources, please refer to Product Guide

Setup Auth Scripts

Follow the instructions in the Script Documentation to setup the authentication scripts