Previder Provider

The Previder provider is used to interact with resources on the Previder IaaS environment. The provider needs to be configured with an API token that will be provided by Previder.

Before using this README, make sure that you have installed the Previder Provider using INSTALL.

Important notice

This Terraform/OpenTofu provider is provided to you "as-is" and without warranty of any kind, express, implied or otherwise, including without limitation, any warranty of fitness for a particular purpose.

If you have any questions, we encourage you to do your own research, seek out experts, and discuss with your community. If there are questions that remain unanswered, please send an e-mail to [email protected]. We’re going to do our best to help answer the questions that you have. Since the Terraform/OpenTofu provider is provided for free, please understand that more complex questions can only be answered for a fee.

Example Usage

terraform {
  required_providers {
    previder = {
      source  = "previder/previder"
      version = "~> 1.0"
    }
  }
}

provider "previder" {
  token = "<MY PREVIDER TOKEN>"
}

Argument reference

The following arguments are supported:

• token - (Required) This is your personal API token for accessing resources in the Previder IaaS environment.
• customer - (Optional) For a default sub customer account to perform actions in

Resources

previder_virtual_network

Example usage

resource "previder_virtual_network" "testlab-net" {
    name = "testlab-net"
    type = "VLAN"
}

Argument reference

The following arguments are supported:

• name : (Required) The network name

previder_virtual_server

Example usage 1

resource "previder_virtual_server" "test" {
  name = "test"
  cpu_cores = 2
  memory = 4096
  network_interfaces = {
    "NIC1" = {
      network = "56655e04e4b0069fba0c6252"
    },
    "NIC2" = {
      network = "5a17da71fcaae44a910027a9"
    }
  }
  guest_id = "other4xLinux64Guest"
  compute_cluster = "express-pdc2"
  disks = {
    "Disk1" = {
      size = 4096
    },
    "Disk2" = {
      size = 4096
    }
  }
  tags = [
    "tag1",
    "tag2"
  ]
}

Argument Reference

The following arguments are supported:

• name - (Required)
• cpu_cores - (Required)
• cpu_sockets - (Optional)
• memory - (Required)
• disks - (Required) - The disks are always handled alphabetically!
• compute_cluster - (Optional)
• group - (Optional) This identifier can be found in the Previder Portal as ObjectId, or through the Previder API.
• network_interfaces - (Required) The network_interfaces are always handled alphabetically!
  • network - (Required) This identifier can be found in the Previder Portal as ObjectId, or through the Previder API.
• template - (Optional) One of the fields template, guest_id or source_virtual_machine is required.
• guest_id - (Optional)
• source_virtual_machine - (Optional)
• user_data - (Optional)
• termination_protection - (Optional)

previder_kubernetes_cluster

Example usage

resource previder_kubernetes_cluster "testcluster" {
  name = "Tofu"
  cni = "cilium"
  network = "LocalNetIpBlock"
  vips = ["10.5.0.3"]
  version = "1.30.0"
  auto_update = false
  minimal_nodes = 1
  control_plane_cpu_cores = 2
  control_plane_memory_gb = 2
  control_plane_storage_gb = 25
  node_cpu_cores = 4
  node_memory_gb = 8
  node_storage_gb = 30
  compute_cluster = "express"
  high_available_control_plane = false
}

Argument Reference

The following arguments are supported:

• name (Required)
• cni (Optional) - Leave empty if you want to install your own CNI, or choose a supported CNI from the Previder Portal
• network (Required)
• vips (Required) - VIP(s) in your own network to reach the cluster
• endpoints (Optional) - Optional extra SANs with which your cluster certificates will be reachable
• version (Optional) - Only optional when auto_update is false
• auto_update (Optional) - Only Required when version is not set
• auto_scale_enabled (Optional)
• minimal_nodes (Required) - You default number of nodes
• maximal_nodes (Optional) - Only required when auto_scale_enabled is true
• control_plane_cpu_cores (Required)
• control_plane_memory_gb (Required)
• control_plane_storage_gb (Required)
• node_cpu_cores (Required)
• node_memory_gb (Required)
• node_storage_gb (Required)
• compute_cluster (Required) - When set to a global cluster like "express", the nodes will automatically be spread over locations. When choosing a specific location, all nodes will run in that location.
• high_available_control_plane (Optional) - when set to true, 3 control plane nodes will be deployed instead of 1

previder_virtual_firewall

Example usage

resource previder_virtual_firewall "fw01" {
  name = "FW Tofu"
  type = "previder"
  network = "<network id>"
  group = "<group id, empty or not defined>"
  lan_address = "192.168.1.1/24"
  dhcp_enabled = true
  dhcp_range_start = "192.168.1.10"
  dhcp_range_end = "192.168.1.100"
  dns_enabled = true
  nameservers = ["80.65.96.50","62.165.127.222"]
  termination_protected = false
  icmp_wan_enabled = true
  icmp_lan_enabled = true
  nat_rules = {
    "Web 443 to webserver 8080" = {
       port = 443
       protocol = "TCP"
       active = true
       nat_destination = "192.168.1.200"
       nat_port = 8080
    },
    "6443 to kubernetes from office" = {
       port = 6443
       protocol = "TCP"
       active = true
       nat_destination = "192.168.1.250"
       nat_port = 6443
       source = "1.2.3.4/24"
    }
  }
}

Argument reference

The following arguments are supported:

• name (Required)
• type (Required)
• network (Required)
• group (Optional)
• lan_address (Required) - LAN CIDR eg 192.168.1.1/24
• dhcp_enabled (Required)
• dhcp_range_start (Optional) - Only required when dhcp_enabled is true
• dhcp_range_end (Optional) - Only required when dhcp_enabled is true
• local_domain_name (Optional) - Only required when dhcp_enabled is true
• dns_enabled (Required)
• nameservers (Optional) - Only required when dns_enabled is true
• termination_protected (Optional)
• icmp_wan_enabled (Optional) - Default true
• icmp_lan_enabled (Optional) - Default true
• nat_rules (Required) - Map of Nat rules
  • port (Required) - External port
  • protocol (Required) - Valid values are TCP or UDP
  • active (Required)
  • nat_destination (Required) - Valid IP address
  • nat_port (Required) - Port on the destination host
  • source (Optional) - Valid CIDR to specify a source

previder_staas_environment

Example usage

resource previder_staas_environment "my_test_environment" {
  name    = "MyTestEnv"
  type    = "NFS"
  cluster = "5ff6d4cc02d0fc472c40bc17"
  windows = true
  volumes = {
    "TofuVol1" = {
      name    = "TofuVol1"
      size_mb = 10240
      type    = "express"
      allowed_ips_ro = ["192.168.0.0/24"]
      allowed_ips_rw = ["192.168.1.0/24"]
    },
    "TofuVol2" = {
      name    = "TofuVol2"
      size_mb = 10240
      type    = "express"
      allowed_ips_ro = ["192.168.2.0/24"]
      allowed_ips_rw = ["192.168.3.0/24"]
    },
  }
  networks = {
    "56655e04e4b0069fba0c6252" = {
      network_id = "56655e04e4b0069fba0c6252" 
      cidr = "192.168.1.10/24"
    },
    "5a17da71fcaae44a910027a9" = {
      network_id = "5a17da71fcaae44a910027a9"
      cidr = "192.168.2.10/24"
    },
  }
}

Argument Reference

The following arguments are supported:

• name (Required)
• type (Required) - only NFS is currently supported
• cluster (Required) - ID of the STaaS cluster
• windows (Required) - set windows specific flags on this STaaS environment. Default: true
• volumes - (Required) - The volumes are always handled alphabetically!
• networks - (Required) - The volumes are always handled alphabetically!

The volume and network keys must be exact to the name of the object, or the warning that array elements have vanished or appeared will be thrown.

Motivation

As projects besides e.g. the Previder Portal, the development team at Previder develops and maintains multiple projects aiming to integrate the Previder IaaS environment.

API Reference

This project uses the API client from the previder-go-sdk project.

Contributors

• Check out the latest master to make sure the feature has not been implemented or the bug is not fixed yet
• Fork the project
• Start a feature/bugfix branch
• Commit and push until you are happy with your contribution
• Send a pull request describing your exact problem, what and how you fixed it