Skip to content

Commit 9134b24

Browse files
svetlana-efimovaSvetlana Efimovavault-token-factory-spectrocloud[bot]achuribooks
authored
docs: Move 4.7.b known issues to limitations (#8038)
* Move 4.7.b known issues to limitations * Update release-notes.md * ci: auto-formatting prettier issues * ci: auto-formatting prettier issues * Update architecture.md * ci: auto-formatting prettier issues * Update docs/docs-content/clusters/edge/edgeforge-workflow/palette-canvos/build-content-bundle.md Co-authored-by: Amanda Churi Filanowski <[email protected]> --------- Co-authored-by: Svetlana Efimova <[email protected]> Co-authored-by: svetlana-efimova <[email protected]> Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com> Co-authored-by: Amanda Churi Filanowski <[email protected]>
1 parent dcb2d06 commit 9134b24

File tree

4 files changed

+27
-13
lines changed

4 files changed

+27
-13
lines changed

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

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -62,14 +62,19 @@ require a local Harbor registry. Built-in registries must be configured using ei
6262

6363
<!-- prettier-ignore-end -->
6464

65-
- Edge content bundles created with Edge CLI version greater than `4.5.5`, are incompatible with Palette agent versions
66-
before `4.5.4` due to a new format schema. If you are using an older version of the Palette agent, use the Edge CLI
67-
version `4.5.3` or earlier to create content bundles. To download the latest version of the Edge CLI, visit the
68-
[Downloads](../../../../downloads/cli-tools.md#palette-edge-cli) page.
69-
70-
- Content bundles built with the Palette Edge CLI versions earlier than `4.5.20` cannot be used to provision multi-node
71-
clusters. Download the latest version of the Palette Edge CLI from the
72-
[Downloads](../../../../downloads/cli-tools.md#palette-edge-cli) page to build the content bundle instead.
65+
- Edge content bundles built with Palette Edge CLI versions later than 4.5.5 are incompatible with Palette agent
66+
versions earlier than 4.5.4 due to a new format schema. If you are using an older version of the Palette agent,
67+
[download](../../../../downloads/cli-tools.md#palette-edge-cli) Palette Edge CLI version 4.5.3 or earlier to create
68+
content bundles.
69+
70+
- Content bundles built with Palette Edge CLI versions earlier than 4.5.20 do not support provisioning of multi-node
71+
clusters. [Download](../../../../downloads/cli-tools.md#palette-edge-cli) and use Palette Edge CLI version 4.5.20 or
72+
later to create content bundles.
73+
74+
- Palette CLI versions earlier than 4.7.b do not support building content for local Edge cluster deployment on Palette
75+
4.7.b or later because content created with older CLI versions lacks the required images.
76+
[Download](../../../../downloads/cli-tools.md#palette-cli) and use Palette CLI version 4.7.b or later to build content
77+
for Palette 4.7.b or later.
7378

7479
## Prerequisites
7580

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

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,24 @@ The following are architectural highlights of clusters deployed using agent mode
2727

2828
- The Palette Optimized Canonical distribution that supports Canonical Kubernetes is a Tech Preview feature and does not
2929
support the following:
30+
3031
- Non-Edge environments
3132
- ARM64 architecture
3233
- OS other than Ubuntu
3334
- Palette VerteX
3435
- Custom installation paths for Kubernetes and its dependencies in [agent mode](../)
3536
- [Network overlay](../../../clusters/edge/networking/vxlan-overlay/)
3637

38+
- Edge clusters deployed in agent mode with the Palette agent versions prior to 4.7.b do not support upgrading to the
39+
following Kubernetes pack versions released in 4.7.b:
40+
<VersionedLink text="Palette Optimized Canonical" url="/integrations/packs/?pack=edge-canonical" /> 1.32.8 and 1.33.4;
41+
<VersionedLink text="Palette eXtended Kubernetes Edge (PXK-E)" url="/integrations/packs/?pack=edge-k8s" /> 1.31.12,
42+
1.32.8, and 1.33.4. For locally managed clusters, refer to [Configure Palette Agent
43+
Version](../../clusters/edge/cluster-management/agent-upgrade-airgap.md) to upgrade the agent to the latest version
44+
before upgrading Kubernetes packs. For centrally managed clusters, do not [pause
45+
upgrades](../../clusters/cluster-management/platform-settings/pause-platform-upgrades.md) so the agent can upgrade
46+
automatically.
47+
3748
## Supported Kubernetes Distributions
3849

3950
Agent mode deployments support the following Kubernetes distributions:

‎docs/docs-content/release-notes/known-issues.md‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,6 @@ The following table lists all known issues that are currently active and affecti
1616

1717
| Description | Workaround | Publish Date | Product Component |
1818
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------------------- |
19-
| Palette CLI versions prior to 4.7.b do not support building content for local Edge cluster deployment on Palette 4.7.b or later because content created with older CLI versions lacks required images. | [Download](../downloads/cli-tools.md) and use Palette CLI version 4.7.b or later to build content for Palette 4.7.b or later. | September 13, 2025 | Edge, Palette CLI |
20-
| Edge clusters with the Palette agent versions prior to 4.7.b do not support upgrading to the following Kubernetes pack versions released in 4.7.b: <VersionedLink text="Palette Optimized Canonical" url="/integrations/packs/?pack=edge-canonical" /> 1.32.8 and 1.33.4; <VersionedLink text="Palette eXtended Kubernetes Edge (PXK-E)" url="/integrations/packs/?pack=edge-k8s" /> 1.31.12, 1.32.8, and 1.33.4. This issue affects agent mode clusters only and does not impact appliance mode clusters. | For locally managed clusters, refer to [Configure Palette Agent Version](../clusters/edge/cluster-management/agent-upgrade-airgap.md) to upgrade the agent to the latest version before upgrading Kubernetes packs. For centrally managed clusters, do not [pause upgrades](../clusters/cluster-management/platform-settings/pause-platform-upgrades.md) so the agent can upgrade automatically. | September 13, 2025 | Edge, Packs |
2119
| In [self-hosted Palette](../enterprise-version/enterprise-version.md) and [VerteX](../vertex/vertex.md) environments running version 4.6.32 or later, scaling Azure IaaS worker node pools does not attach newly created nodes to an outbound load balancer. This impacts outbound connectivity and may also disassociate existing NAT gateways from the worker node pool subnet, resulting in a loss of egress connectivity. | Before upgrading your self-hosted Palette or VerteX instance to version 4.6.32 or later, [Pause Agent Upgrades](../clusters/cluster-management/platform-settings/pause-platform-upgrades.md) on any Azure IaaS clusters where you plan to perform Day-2 operations, such as scaling or repaving node pools or upgrading the Kubernetes version. | August 28, 2025 | Clusters, Self-Hosted |
2220
| [Virtual Machine Orchestrator (VMO)](../vm-management/vm-management.md) 4.7.1 cannot be uninstalled due to a missing image. | No workaround available. | September 9, 2025 | Virtual Machine Orchestrator |
2321
| After an OS image upgrade in appliance mode, an Edge host may fail to boot into the expected active system image and instead boot into the passive partition as a fallback due to an upgrade failure. When this happens, the Edge host does not automatically rejoin the cluster. The kernel command line (`/proc/cmdline`) includes the `upgrade_failure` flag and confirms the system root is set to `LABEL=COS_PASSIVE`. | Recover the Edge host manually using one of the following methods:<br /> - Reboot the host and select **Palette eXtended Kubernetes – Edge** at the GRand Unified Bootloader (GRUB) menu to boot the active image.<br /> - Establish an SSH connection to the host and run `/usr/bin/grub2-editenv /oem/grubenv set next_entry=cos && reboot`. This command updates GRUB to use the boot entry labeled `cos` (the active image) and reboots the host. | August 28, 2025 | Edge |

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,13 +33,13 @@ tags: ["release-notes"]
3333

3434
### Edge
3535

36+
#### Breaking Changes
37+
3638
- Palette CLI versions prior to 4.7.b do not support building content for local Edge cluster deployment on Palette 4.7.b
37-
or later because content created with older CLI versions lacks required images. We recommend
39+
or later because content created with older CLI versions lacks the required images. We recommend
3840
[downloading](downloads/cli-tools.md) and using Palette CLI version 4.7.b or later to build content for Palette 4.7.b
3941
or later.
4042

41-
#### Breaking Changes
42-
4343
- Edge clusters with the Palette agent versions prior to 4.7.b do not support upgrading to the following Kubernetes pack
4444
versions released in 4.7.b:
4545
<VersionedLink text="Palette Optimized Canonical" url="/integrations/packs/?pack=edge-canonical" /> 1.32.8 and 1.33.4;

0 commit comments

Comments
 (0)