Reverting PE-7908 due to 4.8.b shift (#9053)

Author: achuribooks

docs/docs-content/clusters/edge/architecture/architecture.md

@@ -35,9 +35,7 @@ The following are architectural highlights of Palette-provisioned Edge native cl
 
 ## Limitations
 
-<!-- prettier-ignore-start -->
-
-- The <VersionedLink text="Palette Optimized Canonical" url="/integrations/packs/?pack=edge-canonical" /> pack does not
+- The Palette Optimized Canonical distribution that supports Canonical Kubernetes is a Tech Preview feature and does not
   support the following:
 
   - ARM64 architecture
@@ -46,12 +44,30 @@ The following are architectural highlights of Palette-provisioned Edge native cl
   - [Network overlay](../networking/vxlan-overlay/) in locally managed Edge clusters.
   - High availability mode with one or two nodes.
 
-<!-- prettier-ignore-end -->
-
 - When scaling down a Palette Optimized Canonical Kubernetes cluster with two nodes, ensure you do not delete the leader
   node. In this configuration, one node is the leader (and voter), while the other is a spare. Deleting the leader will
   render the cluster inaccessible, as database updates are not replicated to the spare node.
 
+:::info
+
+The Palette Optimized Canonical Kubernetes distribution uses distributed SQLite (Dqlite) as its datastore. Each node
+assumes one of the following roles at any given time:
+
+- Voter - replication and leader election voting are enabled.
+- Stand-by - only replication is enabled.
+- Spare - neither replication nor election is enabled.
+
+Run the `k8s status` command on a control plane node to view the current roles of all nodes in the cluster.
+
+```bash hideClipboard title="Example output"
+cluster status:           ready
+control plane nodes:      10.10.216.81:6400 (voter), 10.10.217.4:6400 (voter), 10.10.220.115:6400 (voter)
+high availability:        yes
+datastore:                k8s-dqlite
+```
+
+:::
+
 ## Minimum Device Requirements
 
 All Edge hosts must meet the following minimum hardware requirements. For specific features, additional hardware
@@ -74,12 +90,19 @@ ARM64 support is only verified for the Nvidia Jetson Orin device family.
 
 Palette provides the following distributions for edge installations.
 
-| Name                                                                                                       | Kubernetes Distribution | OS               | CNIs            | CSIs      |
-| ---------------------------------------------------------------------------------------------------------- | ----------------------- | ---------------- | --------------- | --------- |
-| <VersionedLink text="Palette eXtended Kubernetes Edge (PXK-E)" url="/integrations/packs/?pack=edge-k8s" /> | CNCF                    | openSUSE, Ubuntu | Calico, Flannel | Rook Ceph |
-| <VersionedLink text="Palette Optimized Canonical" url="/integrations/packs/?pack=edge-canonical" />        | Canonical Kubernetes    | Ubuntu           | Calico, Cilium  | Longhorn  |
-| <VersionedLink text="Palette Optimized K3s" url="/integrations/packs/?pack=edge-k3s" />                    | K3s                     | openSUSE, Ubuntu | Calico, Flannel | Rook Ceph |
-| <VersionedLink text="Palette Optimized RKE2" url="/integrations/packs/?pack=edge-rke2" />                  | RKE2                    | openSUSE, Ubuntu | Calico, Flannel | Rook Ceph |
+| Name                                                                                                        | Kubernetes Distribution | OS               | CNIs            | CSIs      |
+| ----------------------------------------------------------------------------------------------------------- | ----------------------- | ---------------- | --------------- | --------- |
+| Palette Optimized K3s                                                                                       | K3s                     | openSUSE, Ubuntu | Calico, Flannel | Rook Ceph |
+| Palette Optimized RKE2                                                                                      | RKE2                    | openSUSE, Ubuntu | Calico, Flannel | Rook Ceph |
+| [Palette eXtended Kubernetes Edge (PXK-E)](../../../glossary-all.md#palette-extended-kubernetes-edge-pxk-e) | CNCF                    | openSUSE, Ubuntu | Calico, Flannel | Rook Ceph |
+| Palette Optimized Canonical                                                                                 | Canonical Kubernetes    | Ubuntu           | Calico, Cilium  | Longhorn  |
+
+:::preview
+
+The **Palette Optimized Canonical** Kubernetes distribution is a Tech Preview feature and is subject to change. Do not
+use this feature in production workloads.
+
+:::
 
 ## Supported Configurations
 
@@ -90,7 +113,7 @@ table below describes these aspects and the available options.
 | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Management Mode                   | - Central: The site has a connection to Palette and is managed centrally via Palette Management Console<br/> - Local: The site does not have a connection to Palette and is managed locally.                                                                                                                                                                                                                                                                                              |
 | OS                                | - Ubuntu<br/>- OpenSUSE<br/>- Bring Your Own OS (BYOOS)                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| Kubernetes Flavor                 | - <VersionedLink text="Palette eXtended Kubernetes Edge (PXK-E)" url="/integrations/packs/?pack=edge-k8s" /> (FIPS and non-FIPS) <br/> - <VersionedLink text="Palette Optimized Canonical" url="/integrations/packs/?pack=edge-canonical" /> <br/> - <VersionedLink text="Palette Optimized K3s" url="/integrations/packs/?pack=edge-k3s" /> <br/>- <VersionedLink text="Palette Optimized RKE2" url="/integrations/packs/?pack=edge-rke2" />                                             |
+| Kubernetes Flavor                 | - Palette eXtended K8s for Edge FIPS (PXK-E) <br /> - Palette eXtended K8s for Edge (PXK-E) <br/> - Palette Optimized K3s <br/> - Palette Optimized RKE2<br/>- Palette Optimized Canonical                                                                                                                                                                                                                                                                                                |
 | Kubernetes Version                | - 1.26.x<br/>- 1.27.x<br/>- 1.28.x<br/>- 1.29.x<br/>- 1.30.x<br/>- 1.31.x<br/>- 1.32.x <br/>- 1.33.x                                                                                                                                                                                                                                                                                                                                                                                      |
 | FIPS Mode                         | - True: Enforce usage of FIPS packs and other required FIPS configuration to meet FIPS compliance<br/>- False                                                                                                                                                                                                                                                                                                                                                                             |
 | Edge Host Registration Mode       | - Manual: A unique Edge host ID is manually entered into the Palette Management Console <br/> - Auto: Edge hosts automatically register with the Palette through the usage of a registration token supplied in the user-data<br/>- QR Code: Scan a QR code that takes you to a web application that registers the Edge host with Palette. This method is considered advanced with the benefit of simplifying the Edge host registration without needing a tenant token or a manual entry. |

docs/docs-content/clusters/edge/edgeforge-workflow/palette-canvos/build-installer-iso.md

@@ -96,6 +96,14 @@ Use the following instructions to build the Edge Installer ISO. The optional ste
    the provider images. Refer to [Edge Artifact Build Configuration](./arg.md) for all available configuration
    parameters.
 
+   :::preview
+
+   The `K8S_DISTRIBUTION` argument, defined in the `.arg` file, accepts `canonical` as a valid value. This value
+   corresponds to the **Palette Optimized Canonical** pack, which is a Tech Preview feature and is subject to change. Do
+   not use this feature in production workloads.
+
+   :::
+
 7. Customize these arguments to use during the build process. The following is an example `.arg` file.
 
    ```

docs/docs-content/clusters/edge/edgeforge-workflow/palette-canvos/build-provider-images.md

@@ -159,6 +159,14 @@ artifacts at the same time.
 
     Refer to [Edge Artifact Build Configurations](./arg.md) for all available configuration parameters.
 
+    :::preview
+
+    The `K8S_DISTRIBUTION` argument, defined in the `.arg` file, accepts `canonical` as a valid value. This value
+    corresponds to the **Palette Optimized Canonical** pack, which is a Tech Preview feature and is subject to change.
+    Do not use this feature in production workloads.
+
+    :::
+
 11. (Optional) If you want to build multiple versions of provider images using different Kubernetes versions, remove the
     `K8S_VERSION` argument from the `.arg` file. Open the `k8s_version.json` file in the `CanvOS` directory. Remove the
     Kubernetes versions that you don't need from the JSON object corresponding to your Kubernetes distribution.

docs/docs-content/clusters/edge/edgeforge-workflow/palette-canvos/palette-canvos.md

@@ -147,6 +147,14 @@ customization.
 
    Refer to [Edge Artifact Build Configurations](./arg.md) for all available configuration parameters.
 
+   :::preview
+
+   The `K8S_DISTRIBUTION` argument, defined in the `.arg` file, accepts `canonical` as a valid value. This value
+   corresponds to the **Palette Optimized Canonical** pack, which is a Tech Preview feature and is subject to change. Do
+   not use this feature in production workloads.
+
+   :::
+
    Using the arguments defined in the `.arg` file, the final provider images you generate will have the following naming
    convention, `[IMAGE_REGISTRY]/[IMAGE_REPO]:[CUSTOM_TAG]`. For example, one of the provider images will be
    `spectrocloud/ubuntu:k3s-1.27.2-v4.4.12-palette-learn`.
@@ -590,6 +598,14 @@ required Edge artifacts.
     OS distribution. The `.arg` file uses the default values for the remaining arguments. Refer to
     [Edge Artifact Build Configurations](./arg.md) for all available configuration parameters.
 
+    :::preview
+
+    The `K8S_DISTRIBUTION` argument, defined in the `.arg` file, accepts `canonical` as a valid value. This value
+    corresponds to the **Palette Optimized Canonical** pack, which is a Tech Preview feature and is subject to change.
+    Do not use this feature in production workloads.
+
+    :::
+
     ```bash
     cat << EOF > .arg
     IMAGE_REGISTRY=$IMAGE_REGISTRY

docs/docs-content/clusters/edge/site-deployment/cluster-deployment.md

@@ -33,23 +33,14 @@ Use the following steps to create a new host cluster so that you can add Edge ho
 - In a multi-node cluster with PXK-E as its Kubernetes layer, you cannot change custom Network Interface Card (NIC).
   When you add an Edge host to such a cluster, leave the NIC field as its default value.
 
-<!-- prettier-ignore-start -->
-
+<!-- prettier-ignore -->
 - For multi-node clusters, do not use the
   <VersionedLink text="Local Path Provisioner Pack" url="/integrations/packs/?pack=csi-local-path-provisioner" />. This
   is because whenever a node is drained during an upgrade or for any other reason, the volumes will not dynamically move
   with the local path provisioner.
 
-<!-- prettier-ignore-end -->
-
 - Two-node clusters operating in high availability mode only support K3s and no other Kubernetes distributions.
-
-<!-- prettier-ignore-start -->
-
-- <VersionedLink text="Palette Optimized Canonical" url="/integrations/packs/?pack=edge-canonical" /> Kubernetes
-  clusters require at least three nodes to operate in high availability mode.
-
-<!-- prettier-ignore-end -->
+- Palette Optimized Canonical Kubernetes clusters require at least three nodes to operate in high availability mode.
 
 ### Prerequisites
 

docs/docs-content/deployment-modes/agent-mode/architecture.md

@@ -25,9 +25,7 @@ The following are architectural highlights of clusters deployed using agent mode
 
 ## Limitations
 
-<!-- prettier-ignore-start -->
-
-- The <VersionedLink text="Palette Optimized Canonical" url="/integrations/packs/?pack=edge-canonical" /> distribution does not
+- The Palette Optimized Canonical distribution that supports Canonical Kubernetes is a Tech Preview feature and does not
   support the following:
 
   - Non-Edge environments
@@ -36,7 +34,8 @@ The following are architectural highlights of clusters deployed using agent mode
   - Palette VerteX
   - Custom installation paths for Kubernetes and its dependencies in [Agent Mode](./agent-mode.md)
   - [Network overlay](../../clusters/edge/networking/vxlan-overlay.md) in locally managed Edge clusters.
-  - High availability mode with one or two nodes.
+
+<!-- prettier-ignore-start -->
 
 - Edge clusters deployed in agent mode with a Palette cluster agent version prior to 4.7.7 do not support upgrading to
   the following Kubernetes pack versions released in 4.7.20:
@@ -68,14 +67,16 @@ The following are architectural highlights of clusters deployed using agent mode
 
 Agent mode deployments support the following Kubernetes distributions:
 
-<!-- prettier-ignore-start -->
+- PXK-E
+- K3s
+- Canonical
 
-  - <VersionedLink text="Palette eXtended Kubernetes Edge (PXK-E)" url="/integrations/packs/?pack=edge-k8s" />
-  - <VersionedLink text="Palette Optimized Canonical" url="/integrations/packs/?pack=edge-canonical" />
-  - <VersionedLink text="Palette Optimized K3s" url="/integrations/packs/?pack=edge-k3s" />
-  - <VersionedLink text="Palette Optimized RKE2" url="/integrations/packs/?pack=edge-rke2" />
+:::preview
 
-<!-- prettier-ignore-end -->
+The **Palette Optimized Canonical** distribution that supports Canonical Kubernetes is a Tech Preview feature and is
+subject to change. Do not use this feature in production workloads.
+
+:::
 
 ## Minimum Device Requirements
 

docs/docs-content/release-notes/release-notes.md

@@ -68,12 +68,6 @@ The [CanvOS](https://github.com/spectrocloud/CanvOS) version corresponding to th
 
 #### Improvements
 
-<!-- prettier-ignore-start -->
-
-- The <VersionedLink text="Palette Optimized Canonical" url="/integrations/packs/?pack=edge-canonical" /> pack has exited Tech Preview and is now ready for production workloads.
-
-<!-- prettier-ignore-end -->
-
 - [Trusted Boot](../clusters/edge/trusted-boot/trusted-boot.md) has exited Tech Preview and is now ready for production
   workloads.
 

docs/docs-content/troubleshooting/edge/edge.md

@@ -362,14 +362,10 @@ remove the container manually. The kubelet then restarts the component using the
 
 ## Scenario - Canonical Edge Clusters in Proxied Environments Experience Failure upon Reboot
 
-<!-- prettier-ignore-start -->
-
-When rebooting nodes in an Edge cluster using <VersionedLink text="Palette Optimized Canonical" url="/integrations/packs/?pack=edge-canonical" /> deployed in a proxied environment, the nodes
+When rebooting nodes in an Edge cluster using Palette Optimized Canonical deployed in a proxied environment, the nodes
 may fail to come back online. To prevent this, add the second IP address in the `service_cidr` range from the Canonical
 pack to the `NO_PROXY` list in your Edge installer `user-data`.
 
-<!-- prettier-ignore-end -->
-
 ### Debug Steps
 
 1. Log in to [Palette](https://console.spectrocloud.com).