Feat/lcm integration terraform

examples/lcm_config_v2/main.tf

@@ -0,0 +1,41 @@
+terraform {
+  required_providers {
+    nutanix = {
+      source  = "nutanix/nutanix"
+      version = "2.1.0"
+    }
+  }
+}
+
+#defining nutanix configuration
+provider "nutanix" {
+  username = var.nutanix_username
+  password = var.nutanix_password
+  endpoint = var.nutanix_endpoint
+  port     = 9440
+  insecure = true
+}
+
+# List Prism Central
+data "nutanix_clusters_v2" "pc" {
+  filter = "config/clusterFunction/any(t:t eq Clustermgmt.Config.ClusterFunctionRef'PRISM_CENTRAL')"
+}
+
+locals {
+  pcExtID      = data.nutanix_clusters_v2.pc.cluster_entities[0].ext_id
+}
+
+# Example here, we are enabling Auto Inventory, adding Auto Inventory Schedule and enabling auto upgrade
+resource "nutanix_lcm_config_v2" "lcm-configuration-update" {
+    x_cluster_id = local.pcExtID
+    is_auto_inventory_enabled = true
+	auto_inventory_schedule = "16:30"
+    has_module_auto_upgrade_enabled = true
+}
+
+# Read LCM config.
+data "nutanix_lcm_config_v2" "get-lcm-configuration" {
+    x_cluster_id = local.pcExtID
+    depends_on = [nutanix_lcm_config_v2.lcm-configuration-update]
+}
+

examples/lcm_config_v2/terraform.tfvars

@@ -0,0 +1,5 @@
+#define values to the variables to be used in terraform file
+nutanix_username = "admin"
+nutanix_password = "password"
+nutanix_endpoint = "10.xx.xx.xx"
+nutanix_port = 9440

examples/lcm_config_v2/variables.tf

@@ -0,0 +1,13 @@
+#define the type of variables to be used in terraform file
+variable "nutanix_username" {
+  type = string
+}
+variable "nutanix_password" {
+  type = string
+}
+variable "nutanix_endpoint" {
+  type = string
+}
+variable "nutanix_port" {
+  type = string
+}

examples/lcm_entities_v2/main.tf

@@ -0,0 +1,41 @@
+terraform {
+  required_providers {
+    nutanix = {
+      source  = "nutanix/nutanix"
+      version = "2.1.0"
+    }
+  }
+}
+
+#defining nutanix configuration
+provider "nutanix" {
+  username = var.nutanix_username
+  password = var.nutanix_password
+  endpoint = var.nutanix_endpoint
+  port     = 9440
+  insecure = true
+}
+
+# get all entities
+data "nutanix_lcm_entities_v2" "lcm-entities" {}
+
+# get filtered entities
+data "nutanix_lcm_entities_v2" "lcm-entities-filtered" {
+  filter = "entityModel eq 'Calm Policy Engine'"
+}
+
+# get limited entities
+data "nutanix_lcm_entities_v2" "lcm-entities-limited" {
+  limit = 5
+}
+
+# get filtered and limited entities
+data "nutanix_lcm_entities_v2" "lcm-entities-filter-and-limit" {
+  filter = "startswith(entityModel,'Calm')"
+  limit  = 5
+}
+
+# get specific entity
+data "nutanix_lcm_entity_v2" "entity" {
+  ext_id = data.nutanix_lcm_entities_v2.lcm-entities.entities[0].ext_id
+}

examples/lcm_entities_v2/terraform.tfvars

@@ -0,0 +1,5 @@
+#define values to the variables to be used in terraform file
+nutanix_username = "admin"
+nutanix_password = "password"
+nutanix_endpoint = "10.xx.xx.xx"
+nutanix_port = 9440

examples/lcm_entities_v2/variables.tf

@@ -0,0 +1,13 @@
+#define the type of variables to be used in terraform file
+variable "nutanix_username" {
+  type = string
+}
+variable "nutanix_password" {
+  type = string
+}
+variable "nutanix_endpoint" {
+  type = string
+}
+variable "nutanix_port" {
+  type = string
+}

examples/lcm_upgrade_v2/main.tf

@@ -0,0 +1,104 @@
+terraform {
+  required_providers {
+    nutanix = {
+      source  = "nutanix/nutanix"
+      version = "2.1.0"
+    }
+  }
+}
+
+#defining nutanix configuration
+provider "nutanix" {
+  username = var.nutanix_username
+  password = var.nutanix_password
+  endpoint = var.nutanix_endpoint
+  port     = 9440
+  insecure = true
+}
+
+# List Prism Central
+data "nutanix_clusters_v2" "pc" {
+  filter = "config/clusterFunction/any(t:t eq Clustermgmt.Config.ClusterFunctionRef'PRISM_CENTRAL')"
+}
+
+locals {
+  pcExtID      = data.nutanix_clusters_v2.pc.cluster_entities[0].ext_id
+}
+
+data "nutanix_lcm_entities_v2" "lcm-entities" {
+  filter = "entityModel eq 'Calm Policy Engine'"
+}
+
+data "nutanix_lcm_entity_v2" "entity-before-upgrade" {
+  ext_id = data.nutanix_lcm_entities_v2.lcm-entities.entities[0].ext_id
+}
+
+# perform inventory
+resource "nutanix_lcm_perform_inventory_v2" "inventory" {
+  x_cluster_id = local.pcExtID
+  depends_on   = [data.nutanix_lcm_entity_v2.entity-before-upgrade]
+}
+
+resource "nutanix_lcm_prechecks_v2" "pre-checks" {
+  x_cluster_id = local.pcExtID
+  entity_update_specs {
+    entity_uuid = data.nutanix_lcm_entity_v2.entity-before-upgrade.ext_id
+    to_version  = "4.0.0"
+  }
+  depends_on = [nutanix_lcm_perform_inventory_v2.inventory]
+}
+
+# check if there is any operation in progress before starting the upgrade
+data "nutanix_lcm_status_v2" "status-before-upgrade" {
+  x_cluster_id = local.pcExtID
+  lifecycle {
+    postcondition {
+      condition     = self.in_progress_operation[0].operation_type == "" && self.in_progress_operation[0].operation_id == ""
+      error_message = "operation is in progress: ${self.in_progress_operation[0].operation_type}"
+    }
+  }
+  depends_on = [nutanix_lcm_prechecks_v2.pre-checks]
+}
+
+# upgrade the entity
+resource "nutanix_lcm_upgrade_v2" "upgrade" {
+  entity_update_specs {
+    entity_uuid = data.nutanix_lcm_entity_v2.entity-before-upgrade.ext_id
+    to_version  = "4.0.0"
+  }
+  depends_on = [data.nutanix_lcm_status_v2.status-before-upgrade]
+}
+
+# check if there is any operation in progress after upgrade
+data "nutanix_lcm_status_v2" "status-after-upgrade" {
+  x_cluster_id = local.pcExtID
+  lifecycle {
+    postcondition {
+      condition     = self.in_progress_operation[0].operation_type == "" && self.in_progress_operation[0].operation_id == ""
+      error_message = "operation is in progress: ${self.in_progress_operation[0].operation_type}"
+    }
+  }
+  depends_on = [nutanix_lcm_upgrade_v2.upgrade]
+}
+
+# fetch the entity after upgrade
+data "nutanix_lcm_entity_v2" "entity-after-upgrade" {
+  ext_id = data.nutanix_lcm_entities_v2.lcm-entities.entities[0].ext_id
+  lifecycle {
+    postcondition {
+      condition     = self.ext_id == data.nutanix_lcm_entity_v2.entity-before-upgrade.ext_id
+      error_message = "entity ext id changed"
+    }
+    postcondition {
+      condition     = self.entity_version == "4.0.0"
+      error_message = "entity version is not upgraded, current version: ${self.entity_version}"
+    }
+    postcondition {
+      condition     = self.entity_model == "Calm Policy Engine"
+      error_message = "entity model is changed, current model: ${self.entity_model}"
+    }
+  }
+  depends_on = [nutanix_lcm_upgrade_v2.upgrade, data.nutanix_lcm_status_v2.status-after-upgrade]
+}
+
+

examples/lcm_upgrade_v2/terraform.tfvars

@@ -0,0 +1,5 @@
+#define values to the variables to be used in terraform file
+nutanix_username = "admin"
+nutanix_password = "password"
+nutanix_endpoint = "10.xx.xx.xx"
+nutanix_port = 9440

examples/lcm_upgrade_v2/variables.tf

@@ -0,0 +1,13 @@
+#define the type of variables to be used in terraform file
+variable "nutanix_username" {
+  type = string
+}
+variable "nutanix_password" {
+  type = string
+}
+variable "nutanix_endpoint" {
+  type = string
+}
+variable "nutanix_port" {
+  type = string
+}

go.mod

@@ -13,6 +13,7 @@ require (
 	github.com/nutanix/ntnx-api-golang-clients/clustermgmt-go-client/v4 v4.0.1
 	github.com/nutanix/ntnx-api-golang-clients/dataprotection-go-client/v4 v4.0.1
 	github.com/nutanix/ntnx-api-golang-clients/iam-go-client/v4 v4.0.1
+	github.com/nutanix/ntnx-api-golang-clients/lifecycle-go-client/v4 v4.0.1
 	github.com/nutanix/ntnx-api-golang-clients/microseg-go-client/v4 v4.0.1
 	github.com/nutanix/ntnx-api-golang-clients/networking-go-client/v4 v4.0.1
 	github.com/nutanix/ntnx-api-golang-clients/prism-go-client/v4 v4.0.1

go.sum

@@ -462,6 +462,8 @@ github.com/nutanix/ntnx-api-golang-clients/dataprotection-go-client/v4 v4.0.1 h1
 github.com/nutanix/ntnx-api-golang-clients/dataprotection-go-client/v4 v4.0.1/go.mod h1:S07bx9/6uUbMOY/OUJsaIUdvZ/LDaE46Kx9VX7Pt7Ek=
 github.com/nutanix/ntnx-api-golang-clients/iam-go-client/v4 v4.0.1 h1:zWbA2qtSJt0WsBcEhqqv6FQTSz8pIwBnHA5etaQg4qo=
 github.com/nutanix/ntnx-api-golang-clients/iam-go-client/v4 v4.0.1/go.mod h1:+HvW0f4QGDRZ3/1jcXvF7xA/gQsvQc4XtZy6OUobaO4=
+github.com/nutanix/ntnx-api-golang-clients/lifecycle-go-client/v4 v4.0.1 h1:JBSalV1dvI+5YjZzzE9E/tz8V4A7CbSA7wl4C3L8iYs=
+github.com/nutanix/ntnx-api-golang-clients/lifecycle-go-client/v4 v4.0.1/go.mod h1:fQTNQlfh5g4SavaQn+sDoMn29K+Lur5lHWtnbq3uA28=
 github.com/nutanix/ntnx-api-golang-clients/microseg-go-client/v4 v4.0.1 h1:9SC9PsLQjvkuo0MyL2HMDXQ/dQl1a57RDR4OS22so/U=
 github.com/nutanix/ntnx-api-golang-clients/microseg-go-client/v4 v4.0.1/go.mod h1:75Ro+aFIepNAkf2eWjFrFR7m+Ct36EVrD9n9pwAYBrc=
 github.com/nutanix/ntnx-api-golang-clients/networking-go-client/v4 v4.0.1 h1:2D2ZJd5Cn0fMeWYnTEHsR1Fcv2G1BSrOAl1fVURtfn4=

nutanix/config.go

@@ -12,6 +12,7 @@ import (
 	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/sdks/v4/clusters"
 	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/sdks/v4/dataprotection"
 	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/sdks/v4/iam"
+	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/sdks/v4/lcm"
 	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/sdks/v4/microseg"
 	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/sdks/v4/networking"
 	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/sdks/v4/prism"
@@ -111,6 +112,10 @@ func (c *Config) Client() (*Client, error) {
 	if err != nil {
 		return nil, err
 	}
+	LcmClient, err := lcm.NewLcmClient(configCreds)
+	if err != nil {
+		return nil, err
+	}
 	return &Client{
 		WaitTimeout:         c.WaitTimeout,
 		API:                 v3Client,
@@ -126,6 +131,7 @@ func (c *Config) Client() (*Client, error) {
 		VolumeAPI:           volumeClient,
 		DataProtectionAPI:   dataprotectionClient,
 		VmmAPI:              vmmClient,
+		LcmAPI:              LcmClient,
 	}, nil
 }
 
@@ -145,4 +151,5 @@ type Client struct {
 	VolumeAPI           *volumes.Client
 	DataProtectionAPI   *dataprotection.Client
 	VmmAPI              *vmm.Client
+	LcmAPI              *lcm.Client
 }

nutanix/provider/provider.go

@@ -17,6 +17,7 @@ import (
 	foundationCentral "github.com/terraform-providers/terraform-provider-nutanix/nutanix/services/foundationCentral"
 	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/services/iam"
 	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/services/iamv2"
+	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/services/lcmv2"
 	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/services/ndb"
 	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/services/networking"
 	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/services/networkingv2"
@@ -289,6 +290,10 @@ func Provider() *schema.Provider {
 			"nutanix_clusters_v2":                             clustersv2.DatasourceNutanixClusterEntitiesV2(),
 			"nutanix_host_v2":                                 clustersv2.DatasourceNutanixHostEntityV2(),
 			"nutanix_hosts_v2":                                clustersv2.DatasourceNutanixHostEntitiesV2(),
+			"nutanix_lcm_status_v2":                           lcmv2.DatasourceNutanixLcmStatusV2(),
+			"nutanix_lcm_entities_v2":                         lcmv2.DatasourceNutanixLcmEntitiesV2(),
+			"nutanix_lcm_entity_v2":                           lcmv2.DatasourceNutanixLcmEntityV2(),
+			"nutanix_lcm_config_v2":                           lcmv2.DatasourceNutanixLcmConfigV2(),
 		},
 		ResourcesMap: map[string]*schema.Resource{
 			"nutanix_virtual_machine":                         vmm.ResourceNutanixVirtualMachine(),
@@ -385,6 +390,10 @@ func Provider() *schema.Provider {
 			"nutanix_pc_registration_v2":                      clustersv2.ResourceNutanixClusterPCRegistrationV2(),
 			"nutanix_clusters_discover_unconfigured_nodes_v2": clustersv2.ResourceNutanixClusterDiscoverUnconfiguredNodesV2(),
 			"nutanix_clusters_unconfigured_node_networks_v2":  clustersv2.ResourceNutanixClusterUnconfiguredNodeNetworkV2(),
+			"nutanix_lcm_perform_inventory_v2":                lcmv2.ResourceNutanixLcmPerformInventoryV2(),
+			"nutanix_lcm_prechecks_v2":                        lcmv2.ResourceNutanixPreChecksV2(),
+			"nutanix_lcm_upgrade_v2":                          lcmv2.ResourceLcmUpgradeV2(),
+			"nutanix_lcm_config_v2":                           lcmv2.ResourceNutanixLcmConfigV2(),
 		},
 		ConfigureContextFunc: providerConfigure,
 	}

nutanix/sdks/v4/lcm/lcm.go

@@ -0,0 +1,43 @@
+package lcm
+
+import (
+	"github.com/nutanix/ntnx-api-golang-clients/lifecycle-go-client/v4/api"
+	lcm "github.com/nutanix/ntnx-api-golang-clients/lifecycle-go-client/v4/client"
+	"github.com/terraform-providers/terraform-provider-nutanix/nutanix/client"
+)
+
+type Client struct {
+	LcmConfigAPIInstance    *api.ConfigApi
+	LcmInventoryAPIInstance *api.InventoryApi
+	LcmPreChecksAPIInstance *api.PrechecksApi
+	LcmStatusAPIInstance    *api.StatusApi
+	LcmEntitiesAPIInstance  *api.EntitiesApi
+	LcmUpgradeAPIInstance   *api.UpgradesApi
+}
+
+func NewLcmClient(credentials client.Credentials) (*Client, error) {
+	var baseClient *lcm.ApiClient
+
+	// check if all required fields are present. Else create an empty client
+	if credentials.Username != "" && credentials.Password != "" && credentials.Endpoint != "" {
+		pcClient := lcm.NewApiClient()
+
+		pcClient.Host = credentials.Endpoint
+		pcClient.Password = credentials.Password
+		pcClient.Username = credentials.Username
+		pcClient.Port = 9440
+		pcClient.VerifySSL = false
+
+		baseClient = pcClient
+	}
+
+	f := &Client{
+		LcmInventoryAPIInstance: api.NewInventoryApi(baseClient),
+		LcmConfigAPIInstance:    api.NewConfigApi(baseClient),
+		LcmPreChecksAPIInstance: api.NewPrechecksApi(baseClient),
+		LcmStatusAPIInstance:    api.NewStatusApi(baseClient),
+		LcmEntitiesAPIInstance:  api.NewEntitiesApi(baseClient),
+		LcmUpgradeAPIInstance:   api.NewUpgradesApi(baseClient),
+	}
+	return f, nil
+}