Skip to content

Commit

Permalink
Small updates to several files
Browse files Browse the repository at this point in the history
  • Loading branch information
ritawatson committed Dec 15, 2023
1 parent 5815d3a commit ae2f4b6
Show file tree
Hide file tree
Showing 4 changed files with 13 additions and 27 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ hide_table_of_contents: false
tags: ["data center", "nutanix"]
---

Palette supports creating and managing Kubernetes clusters deployed to a Nutanix infrastructure. This section guides you in creating a Kubernetes cluster in a custom Nutanix cloud managed by Palette.
Palette supports creating and managing Kubernetes clusters deployed to a Nutanix infrastructure. This section guides you in creating a Kubernetes cluster in a Nutanix cloud managed by Palette.

## Prerequisites

Expand All @@ -16,16 +16,10 @@ Palette supports creating and managing Kubernetes clusters deployed to a Nutanix

- Minimum supported CAPI version v1.5.3. Refer to the Nutanix [Validated Integrations](https://opendocs.nutanix.com/capx/v1.2.x/validated_integrations/#validated-versions) compatibility matrix.

- A cluster profile created for the Nutanix cloud. To learn how to create a profile, refer to [Create Cluster Profiles](../../../profiles/cluster-profiles/create-cluster-profiles/).
- 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**. The

- A Cluster API (CAPI) image created for the Nutanix cloud platform. For guidance, refer to [Building CAPI Images for Nutanix Cloud Platform](https://image-builder.sigs.k8s.io/capi/providers/nutanix.html#building-capi-images-for-nutanix-cloud-platform-ncp).

<!-- - The following YAML files obtained and created during cloud registration process:
- cloudClusterTemplate.yaml
- controlPlanePoolTemplate.yaml
- infrastructure-component.yaml
- workerPoolTemplate.yaml -->


## Deploy a Nutanix Cluster

Expand Down
18 changes: 4 additions & 14 deletions docs/docs-content/clusters/data-center/nutanix/nutanix.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,19 +7,18 @@ sidebar_position: 10
tags: ["data center", "nutanix"]
---

[Nutanix](https://www.nutanix.com/what-we-do) is a hyper-converged infrastructure platform that combines storage, compute, and networking into a single integrated system. Palette provides a generic framework built upon the open-source [Cluster API (CAPI)](https://cluster-api.sigs.k8s.io) initiative to support adding cloud providers. Using this framework, Palette supports integration with Nutanix as a *Tech Preview* for enabling cluster deployment within the Nutanix environment. This integration is achieved through a Private Cloud Gateway (PCG), which establishes a secure connection with Nutanix.

[Nutanix](https://www.nutanix.com/what-we-do) is a hyper-converged infrastructure platform that combines storage, compute, and networking into a single integrated system. Palette provides a generic framework built upon the open-source [Cluster API (CAPI)](https://cluster-api.sigs.k8s.io) initiative to support adding cloud providers. As a technical preview implementing this framework, you can deploy Kubernetes clusters on Nutanix using Palette. Integration with Nutanix is achieved through a Private Cloud Gateway (PCG), which establishes a secure connection with Nutanix.

The section below describes the overall workflow.

## Workflow

The following summary steps outline the CAPI cloud workflow illustrated in the diagram below. A System Administrator performs the first step, and CAPI users perform the remaining steps in Palette.
The following summary steps outline the CAPI cloud workflow illustrated in the diagram below. A system administrator performs the first step at the system level to make the cloud provider available to all the tenants. CAPI users perform the remaining steps in Palette.

![Diagram showing the overall CAPI workflow for users to construct self-hosted cloud solutions tailored to their environment.](/clusters_data-center_nutanix_workflow.png)

1. A System Administrator registers a cloud with Palette by invoking system-level APIs. This includes defining the cloud logo, required cloud account information and key-value pairs to create the cloud account for your particular cloud. If you do not have a cloud logo, Palette provides a default cloud logo. Palette displays the cloud when registration is complete.

<<< Does SA configure PCG in the local cluster at this step??>>>
1. A system administrator registers a cloud with Palette by invoking system-level APIs. This includes defining the cloud logo, required cloud account information and key-value pairs to create the cloud account for your particular cloud. If you do not have a cloud logo, Palette provides a default cloud logo. Palette displays the cloud when registration is complete.

2. Create a self-hosted PCG for your cloud type, and install Palette agents for the PCG in your Kubernetes cluster by issuing the kubectl commands provided in Palette.

Expand All @@ -37,17 +36,8 @@ The following summary steps outline the CAPI cloud workflow illustrated in the d

Palette displays out-of-the-box packs for the network and storage profile layers. If you have custom packs, you can add them to Palette by adding a custom registry. To learn how to add a custom pack registry, review [Add a Custom Registry](https://docs.spectrocloud.com/registries-and-packs/adding-a-custom-registry/#configure-a-custom-pack-registry-in-palette).

<!-- OR
Create a cluster profile by selecting your cloud as the cloud type.
<<< Alternatively, you can provide your OS image by copying it to the provided YAML file.>>> <<<Is this correct? Will the YAML editor be blank for user to copy/paste their own image??>>> -->

5. Deploy a cluster by specifying the cluster type. Locate Nutanix, which is listed under **Tech Preview**. Select the cloud account you added and make any needed changes to the profile layers by using the YAML editor. At the **Cluster Config** step, use YAML templates to customize the cluster for your cloud environment. You can provide your own Operating System (OS) image and configure a custom Kubernetes pack layer by specifying the OS image and other settings in YAML template files during cluster creation.

<!-- Configure the control plane node and worker nodes in the provided YAML files, specifying the node pool name and the number of nodes in the pool. -->



## Resources
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,11 +34,13 @@ Create a full profile by first adding infrastructure layers composed of an Opera

To learn how to create multiple profile versions that use the same name, check out [Version a Cluster Profile](../modify-cluster-profiles/version-cluster-profile.md).

5. Select the infrastructure provider, managed Kubernetes, or *Tech Preview* cloud type for your environment and click **Next**.
5. Select the infrastructure provider, managed Kubernetes, or technical preview cloud type for your environment and click **Next**.

:::info

Cluster profiles created from the Tech Preview cloud type are part of a generic framework Palette provides that is built upon the open-source Cluster API (CAPI) initiative. The Operating System (OS) and Kubernetes layers of these profiles get populated during cluster creation from YAML files created at the system level. During cluster creation, you specify the OS image and Kubernetes version. Palette also provides out-of-the-box packs for the OS layer and for the network and storage layers.
Cluster profiles created from cloud types that are under technical preview are intended for clusters that a cloud provider deploys using Palette's generic framework built upon the open-source Cluster API (CAPI) initiative. When creating this type of profile, you do not have to specify anything for the OS or Kubernetes layers, and out-of-the-box packs are provided for the network and storage profile layers.

<!-- To learn how Palette is previewing its generic framework to support adding cloud providers, check out our [Nutanix](../../../clusters/data-center/nutanix/nutanix.md) documentation. -->

:::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,13 +34,13 @@ Create an infrastructure profile by adding layers composed of an Operating Syste

To learn more about creating multiple profile versions, check out [Version a Cluster Profile](../modify-cluster-profiles/version-cluster-profile.md).

5. Select the infrastructure provider, managed Kubernetes, or *Tech Preview* cloud type for your environment and click **Next**.
5. Select the infrastructure provider, managed Kubernetes, or technical preview cloud type for your environment and click **Next**.

:::info

Cluster profiles created from the Tech Preview cloud type are part of a generic framework Palette provides that is built upon the open-source Cluster API (CAPI) initiative. The Operating System (OS) and Kubernetes layers of these profiles get populated during cluster creation from YAML files created at the system level. During cluster creation, you specify the OS image and Kubernetes version. Palette also provides out-of-the-box packs for the OS layer and for the network and storage layers.
Cluster profiles created from cloud types that are under technical preview are intended for clusters that a cloud provider deploys using Palette's generic framework built upon the open-source Cluster API (CAPI) initiative. When creating this type of profile, you do not have to specify anything for the OS or Kubernetes layers, and out-of-the-box packs are provided for the network and storage profile layers.

For more information about Palette's generic framework implementing Nutanix as a Tech Preview, check out our [Nutanix](../../../clusters/data-center/nutanix/nutanix.md) documentation.
<!-- To learn how Palette is previewing its generic framework to support adding cloud providers, check out our [Nutanix](../../../clusters/data-center/nutanix/nutanix.md) documentation. -->

:::

Expand Down

0 comments on commit ae2f4b6

Please sign in to comment.