Document Nutanix

docs/docs-content/clusters/data-center/nutanix/add-nutanix-cloud-account.md

@@ -0,0 +1,53 @@
+---
+sidebar_label: "Add Nutanix Cloud Account"
+title: "Add Nutanix Cloud Account"
+description: "Learn how to add a Nutanix cloud account in Palette."
+hide_table_of_contents: false
+tags: ["data center", "nutanix"]
+---
+
+ Once the Private Cloud Gateway (PCG) is installed, the Nutanix cloud account must be added to Palette. The required fields to add the cloud are pre-defined by the system administrator during the cloud registration process. These cloud-specific fields vary based on the cloud type.
+
+## Prerequisites
+
+- A Nutanix cloud that a system administrator has registered with Palette. 
+
+- A PCG installed that connects the Nutanix cloud with Palette. For guidance, refer to [Install Private Cloud Gateway](install-pcg.md).
+
+
+## Add Cloud Account
+
+1. Log in to [Palette](https://console.spectrocloud.com/) as a tenant administrator.
+
+2. From the **left Main Menu**, select **Tenant Settings**. 
+
+3. Next, select **Cloud Accounts** in the **Tenant Settings** menu.
+
+4. Locate Nutanix and click **Add Nutanix Cloud**.  
+
+5. Fill out the following input values and click on **Confirm** to continue. 
+
+  | **Field** | **Description** |
+  |-----------|-----------------|
+  | **Name**| A custom name for the account. |
+  | **Private Cloud Gateway**| This name is auto-filled based on the name you provided when you installed the PCG.|
+  | **NUTANIX_USER**| The Prism Central user name.|
+  | **NUTANIX_PASSWORD** | The Prism Central user password.|
+  | **NUTANIX_ENDPOINT** | The Prism Central IP address or the fully qualified domain name (FQDN) assigned to Prism.|
+  | **NUTANIX_PORT** | Specify the default port you assigned in the ``cloudClusterTemplate.yaml`` file. The default value is `9440`. |
+  | **NUTANIX_INSECURE** | Specify the SSL behavior you used in the ``cloudClusterTemplate.yaml`` file. The default behavior is `false`. |
+
+## Validate
+
+1. Log in to [Palette](https://console.spectrocloud.com/).
+
+2. From the **left Main Menu**, select **Tenant Settings**. 
+
+3. Next, select **Cloud Accounts** in the **Tenant Settings Menu**. 
+
+4. Verify the account you added is listed and available.
+
+
+## Next Steps
+
+Now that you have added a Nutanix account to Palette, you can start deploying Kubernetes clusters to your Nutanix infrastructure. To learn how to get started deploying Kubernetes clusters to Nutanix, review the [Create and Manage Nutanix Cluster](/clusters/data-center/nutanix/create-manage-nutanix-cluster.md) guide.

docs/docs-content/clusters/data-center/nutanix/architecture.md

@@ -0,0 +1,34 @@
+---
+sidebar_label: "Architecture"
+title: "Architecture"
+description: "Learn about the architecture used to support Nutanix in Palette."
+hide_table_of_contents: false
+sidebar_position: 0
+tags: ["data center", "nutanix", "architecture"]
+---
+
+
+[Nutanix](https://www.nutanix.com) is a private data center-based cloud that can be registered to Palette using Palette's generic framework built upon the open-source Cluster API (CAPI) initiative. Nutanix offers a hyper-converged infrastructure (HCI) that combines storage, compute, and networking into a single integrated system. 
+
+Below are key architectural highlights of Nutanix clusters provisioned through Palette.
+
+- Palette integrates with Nutanix through the Cloud Native Computing Foundation (CNCF) [Nutanix Cluster API infrastructure provider](https://github.com/nutanix-cloud-native/cluster-api-provider-nutanix).
+
+- Nutanix Prism is a resource management platform that centralizes the monitoring and management of objects across Nutanix environments, whether hosted in your data center or a public cloud provider environment. Nutanix Prism has two main components: Prism Central (PC) and Prism Element (PE).
+
+  - Prism Central is a workspace in which you can register and manage Nutanix workload clusters. The Cluster API Provider Nutanix Cloud Infrastructure (CAPX) relies on Prism Central APIs to manage the Kubernetes cluster infrastructure resources. 
+
+  <!-- Prism Central is required. CAPI Provider Nutanix Cloud Infrastructure (CAPX) interacts with Prism Central APIs using a Prism Central user account. For more information, refer to the Nutanix [Credential Management](https://opendocs.nutanix.com/capx/latest/credential_management/) reference guide. -->
+
+  - Prism Element is a localized cluster manager available for every deployed Nutanix cluster. Within Prism Element, you can configure a cluster, specifying its components such as the number of control plane and worker nodes, networking settings, and more.
+
+- The Kubernetes API Server endpoint is accessible through kube-vip, which is a load balancing solution for the cluster’s control plane. Kube-vip distributes API requests across control plane nodes and also has fail over capabilities.
+
+- A Private Cloud Gateway (PCG) is required to enable Palette to securely communicate with the Nutanix cloud. The direct communication channel allows Palette to create clusters within the Nutanix cloud.
+
+The following diagram illustrates the Nutanix architecture.
+
+
+
+![Network flow from an architectural perspective of how Nutanix works with Palette.](/clusters_data-center_nutanix_architecture.png)
+

docs/docs-content/clusters/data-center/nutanix/create-manage-nutanix-cluster.md

@@ -0,0 +1,118 @@
+---
+sidebar_label: "Create and Manage Nutanix Cluster"
+title: "Create and Manage Nutanix Cluster"
+description: "Learn how to create and manage Nutanix clusters in Palette."
+hide_table_of_contents: false
+tags: ["data center", "nutanix"]
+---
+
+Palette supports creating and managing Kubernetes clusters deployed to a Nutanix infrastructure environment. This section guides you in creating a Kubernetes cluster in a Nutanix cloud managed by Palette.
+
+## Prerequisites
+
+- A Nutanix Prism Central cloud account. For more information, review [Add Nutanix Cloud Account](add-nutanix-cloud-account.md). 
+
+- A Private Cloud Gateway (PCG) deployed. For guidance, review [Install Private Cloud Gateway](install-pcg.md).
+
+- The minimum supported CAPI version 1.5.3. Refer to the Nutanix [Validated Integrations](https://opendocs.nutanix.com/capx/v1.2.x/validated_integrations/#validated-versions) compatibility matrix.
+
+- An infrastructure cluster profile created for the Nutanix cloud. For guidance on creating a profile, refer to [Create an Infrastructure Profile](../../../profiles/cluster-profiles/create-cluster-profiles/create-infrastructure-profile.md). At the **Cloud Type** step of profile creation, select **Nutanix** listed under the **Tech Preview**. Select the custom packs provided at the OS and Kubernetes layers. Out-of-the-box packs are provided for the network and storage profile layers. Additionally, Palette provides a Nutanix-specific storage pack.
+
+
+## Deploy a Nutanix Cluster
+
+Use the following steps to deploy a Kubernetes cluster in Nutanix.
+
+1. Log in to [Palette](https://console.spectrocloud.com/).
+
+2. From the left **Main Menu** select **Clusters**.
+
+3. Click on **Add New Cluster** and select **Deploy New Cluster** on the next page Palette displays. 
+
+4. Select **Nutanix** and click the **Start Nutanix Configuration** button.
+
+5. Fill out the following basic information, and click **Next** to continue.
+
+  | **Field** | **Description** |
+  |-----------|-----------------|
+  | **Cluster Name**| A custom name for the cluster. |
+  | **Description**| Use the description to provide context about the cluster.|
+  | **Tags**| Assign any desired cluster tags. Tags on a cluster are propagated to the Virtual Machines (VMs) deployed to the target environments.|
+  | **Cloud Account** | Select your Nutanix account from the **drop-down Menu**. If you have not yet added your account, select **Add New Account** and add your Nutanix account information. |
+
+6. Select the Nutanix cluster profile you created and click **Next**. Palette displays the profile layers.
+
+7. Review profile layers and customize parameters as desired in the YAML files that display when you select a layer. Click **Next** when you are done.
+
+8. In the Cluster configuration YAML file that Palette displays, edit the file to replace variables within curly braces listed in the table below with values that apply to your Nutanix cloud environment, and make any adjustments to configure your cluster. Click **Next** when you are done.
+
+  | **Variable** | **Description** |
+  |--------------|-----------------|
+  | `${CLUSTER_NAME}`| The name of the Nutanix workload cluster. |
+  | `${CONTROL_PLANE_ENDPOINT_IP}`| The host static IP address. |
+  | `${CLUSTER_ENDPOINT}`| The cluster IP address. |  
+
+  :::caution
+
+  The following applies when replacing variables within curly braces in the YAML configuration files.
+
+    - All the variables must be resolved or have a default value.
+
+    - Names you provide must match. Any names in the YAML files that do not match your Nutanix cluster configuration will result in unsuccessful cluster deployment.
+
+    - Values that are passed as a string, such as names and keys, must be enclosed in quotes, for example `" "`.
+
+    - When replacing values, remove the dollar sign and curly braces.
+
+    - Verify the port specified in the YAM file.
+
+  :::
+
+9. In the Node pool configuration YAML files for the master and worker pools, edit the files to replace each occurrence of the variables within curly braces listed in the tables below with values that apply to your Nutanix cloud environment. You can configure scaling in the Palette UI by specifying the number of nodes in the pool. This corresponds to `replicas` in the YAML file.
+
+  #### Master Pool 
+
+  | **Variable** | **Description** |
+  |--------------|-----------------|
+  | `${CLUSTER_NAME}`| The name of the Nutanix workload cluster. |
+  | `${CONTROL_PLANE_ENDPOINT_IP}`| The Nutanix IP address. |
+  | `${NUTANIX_SSH_AUTHORIZED_KEY}`| Provide your public SSH key. |
+  | `${KUBERNETES_VERSION}`| Specify the Kubernetes version for your cluster, and precede the version number with `v`. For example `v.1.26.3` |
+  | `${NUTANIX_PRISM_ELEMENT_CLUSTER_NAME}`| The name of your Nutanix Prism cluster. |
+  | `${NUTANIX_MACHINE_TEMPLATE_IMAGE_NAME}` | The name of your OS image. |
+  | `${NUTANIX_SUBNET_NAME}` | The name of the subnet for your Nutanix Prism cluster. |
+
+  #### Worker-Pool
+
+    | **Variable** | **Description** |
+    |--------------|-----------------|
+    | `${NUTANIX_SSH_AUTHORIZED_KEY}`| Provide your public SSH key. |
+    | `${KUBERNETES_VERSION}`| Specify the Kubernetes version for your cluster, and precede the version number with `v`. For example `v.1.26.3` |
+    | `${NUTANIX_PRISM_ELEMENT_CLUSTER_NAME}`| The name of your Nutanix Prism cluster. |
+    | `${NUTANIX_MACHINE_TEMPLATE_IMAGE_NAME}` | The name of your OS image. |
+    | `${NUTANIX_SUBNET_NAME}` | The name of the subnet for your Nutanix Prism cluster. |
+
+
+10. Click **Next** when you are done.
+
+11. Review the options for OS patching schedule, scanning, backups, and RBAC. 
+
+12. Click **Validate** and review the cluster configuration and settings summary.
+
+13. Click **Finish Configuration** to deploy the cluster. The cluster details page contains the status and details of the deployment. Use this page to track deployment progress. Provisioning clusters can take several minutes to complete.
+
+14. To edit node pool configurations, navigate to the cluster details page, click the **Nodes** tab, and select the node pool you want to edit. Click the **Edit** button and edit the YAML file that Palette displays. 
+
+15. To edit cluster settings, from the cluster details page, click the **Settings** button and select **Cluster Configuration**. Edit the YAML file that Palette displays.
+
+
+## Validate
+
+1.  Log in to [Palette](https://console.spectrocloud.com/).
+
+2. Navigate to the **left Main Menu** and select **Clusters**. The Clusters page displays a list of all available clusters that Palette manages.
+
+3. Click on the Nutanix cluster you created to view its details page.
+
+4. Ensure the **Cluster Status** field displays **Running**.
+