Skip to content

Commit b5e0888

Browse files
addetzaddetz
committed
Merge branch 'master' into docs-rel-4-8-a
2 parents 90d04ae + 6dc800f commit b5e0888

File tree

21 files changed

+7419
-29090
lines changed

21 files changed

+7419
-29090
lines changed

‎.prettierignore‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ vale/
1111
static/scripts/kapa-widget.bundle.js
1212

1313
docs/api-content/**/*.json
14+
static/apis/**/*.json
1415

1516
# Troublesome files
1617
tsconfig.json

‎README.md‎

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -135,8 +135,8 @@ API documentation is generated by the
135135

136136
We have two different OpenAPI spec files (also known as Swagger files) for two sets of APIs.
137137

138-
- [Palette API](./docs/api-content/api-docs/v1/api.json)
139-
- [Edge Management API](./docs/api-content/api-docs/edge-v1/emc-api.json)
138+
- [Palette API](./static/apis/v1/api.json)
139+
- [Edge Management API](./static/apis/edge-v1/emc-api.json)
140140

141141
The Palette API is exposed on each instance of Palette, while the Edge management is available on each Edge host.
142142

@@ -1046,6 +1046,19 @@ its usage is as follows.
10461046

10471047
Your page will now redirect to `/integrations/packs/?pack=myPack`.
10481048

1049+
### Create link with full URL display
1050+
1051+
You must use the `<FullUrlLink />` component to create a link that displays its full URL in text, as thi is currently
1052+
not supported by markdown.
1053+
1054+
```mdx
1055+
<FullUrlLink path="/apis/v1/palette-apis.json" />
1056+
```
1057+
1058+
Check out
1059+
[Import the Postman Collection](/docs/api-content/api-docs/3-postman-collection.md#import-the-postman-collection) for an
1060+
example.
1061+
10491062
## Our Kapa Widget Setup
10501063

10511064
Kapa is our embedded AI assistant that helps users navigate documentation and find answers through natural-language

‎_partials/permissions/_aws-controller-policy.mdx‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
partial_category: permissions
33
partial_name: aws-controller-policy
44
---
5-
**Last Update**: May 25, 2025
5+
**Last Update**: December 9, 2025
66

77
```json
88
{
@@ -107,6 +107,7 @@ partial_name: aws-controller-policy
107107
"ec2:DescribeVpcEndpoints",
108108
"ec2:DescribeDhcpOptions",
109109
"ec2:DescribeTags",
110+
"ec2:GetInstanceMetadataDefaults",
110111
"ec2:ModifyInstanceMetadataOptions",
111112
"elasticloadbalancing:DescribeTargetGroups",
112113
"elasticloadbalancing:SetSecurityGroups",

‎docs/api-content/api-docs/3-postman-collection.md‎

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -33,17 +33,30 @@ Learn more about [authentication methods](/user-management/authentication/api-ke
3333

3434
## Import the Postman Collection
3535

36-
Use the following URL to import your configuration into Postman:
36+
Right-click the following URL and select **Save Link as** (in Safari, select **Download Linked Files As ...**) to
37+
download the Postman collection to your local machine.
3738

38-
https://raw.githubusercontent.com/spectrocloud/librarium/version-4-8/docs/api-content/api-docs/palette-apis.json
39+
<Tabs>
3940

40-
1. Open the **Import** dialog.
41+
<TabItem label="Palette API V1" value="palette">
4142

42-
2. Select the **Link** tab and copy/paste the URL in the field as shown in the screenshot.
43+
<FullUrlLink path="/apis/v1/palette-apis.json" />
4344

44-
3. Click the **Continue** button.
45+
</TabItem>
4546

46-
4. Click on the **Import** button.
47+
<TabItem label="Edge Management API V1" value="edge">
48+
49+
<FullUrlLink path="/apis/edge-v1/emc-api.json" />
50+
51+
</TabItem>
52+
53+
</Tabs>
54+
55+
1. Navigate to Postman on your computer and open the **Import** dialog.
56+
57+
2. Select the downloaded API specification file and click the **Continue** button.
58+
59+
3. Click on the **Import** button.
4760

4861
Postman imports your collection and lists it under Import Complete. <br />
4962

‎docs/docs-content/clusters/edge/site-deployment/site-installation/initial-setup.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,10 @@ automatically. To launch the setup manually, issue the command `/opt/spectroclou
2828
- Depending on the console environment, the TUI may not display the full QR code for Palette registration. This issue
2929
has been observed in the VMware vSphere web console, where limited console window size can cause the QR code to appear
3030
partially truncated.
31+
- In Agent mode, modifying VLAN settings using the TUI is allowed only if the settings were created via the TUI.
32+
Pre-existing settings are read-only. If you attempt to update pre-existing network settings via the TUI, a new
33+
configuration is created alongside the existing one. To manage pre-existing configurations, use the original
34+
configuration method such as `systemd-networkd`, Netplan, or NetworkManager.
3135

3236
## Prerequisites
3337

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

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

1717
| Description | Workaround | Publish Date | Product Component |
1818
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------------------- |
19+
| After upgrading to [Palette Management Appliance](../enterprise-version/install-palette/palette-management-appliance.md) or [VerteX Management Appliance](../vertex/install-palette-vertex/vertex-management-appliance.md) 4.8.10, the new `stylus` version is not reflected in [Local UI](../clusters/edge/local-ui/local-ui.md), which continues to display the previous value of 4.7.16. | No workaround available. | December 12, 2025 | Edge |
20+
| [Agent mode](../deployment-modes/agent-mode/agent-mode.md) Edge cluster nodes configured with Agent version 4.8.1 may lose pre-existing `systemd-networkd` configurations (VLANs, bonds, and bridges) after a reboot. This occurs because the cleanup logic intended to remove stale VLAN configurations inadvertently deletes valid, pre-existing configurations not created through user data. | Pre-configure the nodes with the required `systemd-networkd` settings via [user data](../clusters/edge/edge-configuration/installer-reference.md), so the Agent recognizes these as managed configurations and retains them on boot. | December 5, 2025 | Edge |
1921
| The [Palette CLI](../automation/palette-cli/palette-cli.md) fails to deploy [PCGs](../clusters/pcg/pcg.md) on environments where SSO is enabled. | For environments configured with SSO, specify the organization specific endpoint using the `--console-url` option on the Palette CLI [Login](../automation/palette-cli/commands/login.md) command. | November 28, 2025 | Automation |
2022
| After upgrading to 4.8.8, the [self-hosted Palette](../enterprise-version/enterprise-version.md) and [VerteX](../vertex/vertex.md) management cluster appears to be **Unhealthy** in the Palette UI due to `mongodb-key-manager-manifest` errors. The cluster functionality is not affected and will return to **Healthy** after a few hours. | No workaround. | November 24, 2025 | Self-hosted, VerteX |
2123
| The [Terminal User Interface (TUI)](../clusters/edge/site-deployment/site-installation/initial-setup.md) introduced in Palette version 4.8.6, using CanvOS version 4.8.1, does not start automatically on Edge hosts upgraded directly from Palette versions prior to 4.6.32, using CanvOS versions earlier than 4.6.21. | Reboot the hosts, or issue the following command on each host: <br />- `systemctl restart palette-tui` for **appliance mode** <br />- `systemctl restart spectro-palette-tui` for **agent mode** | November 22, 2025 | Edge |

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

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,22 @@ Check out the [CLI Tools](/downloads/cli-tools/) page to find the compatible ver
141141

142142
#### Deprecations and Removals
143143

144+
## December 12, 2025 - Component Updates {#component-updates-2025-50}
145+
146+
The following components have been updated for Palette version 4.8.6 - 4.8.9.
147+
148+
| Component | Version |
149+
| ----------------------------------------------------------------------------------------------------- | ------- |
150+
| [Palette Management Appliance](../enterprise-version/install-palette/palette-management-appliance.md) | 4.8.10 |
151+
| [VerteX Management Appliance](../vertex/install-palette-vertex/vertex-management-appliance.md) | 4.8.10 |
152+
153+
Review the active known issues that affect this component update on the [Known Issues](./known-issues.md) page.
154+
155+
### Bug Fixes
156+
157+
- Fixed an issue that caused [`stylus`](../clusters/edge/edge-configuration/installer-reference.md) to incorrectly map
158+
some image references.
159+
144160
## December 5, 2025 - Component Updates {#component-updates-2025-49}
145161

146162
The following components have been updated for Palette version 4.8.6 - 4.8.9.
@@ -174,7 +190,7 @@ The following components have been updated for Palette version 4.8.6 - 4.8.9.
174190
| Calico | CNI | :white_check_mark: | :x: | 3.31.2 |
175191
| Calico Network Policy | Add-on | :white_check_mark: | :x: | 3.31.2 |
176192
| KAI Scheduler | Add-on | :white_check_mark: | :x: | 0.10.0 |
177-
| Kuberay Operator | Add-on | :white_check_mark: | :x: | 1.5.1 |
193+
| KubeRay Operator | Add-on | :white_check_mark: | :x: | 1.5.1 |
178194
| Open Policy Agent | Add-on | :white_check_mark: | :x: | 3.21.0 |
179195
| Prometheus Agent | Add-on | :white_check_mark: | :x: | 27.45.0 |
180196
| Prometheus Operator | Add-on | :white_check_mark: | :x: | 79.5.0 |
@@ -186,6 +202,7 @@ The following components have been updated for Palette version 4.8.6 - 4.8.9.
186202
The following component updates are applicable to this release:
187203

188204
- [December 5, 2025 - Component Updates](#component-updates-2025-49) <!-- omit in toc -->
205+
- [December 12, 2025 - Component Updates](#component-updates-2025-50) <!-- omit in toc -->
189206

190207
### Bug Fixes
191208

@@ -217,6 +234,7 @@ The following component updates are applicable to this release:
217234

218235
- [November 28, 2025 - Component Updates](#component-updates-2025-48) <!-- omit in toc -->
219236
- [December 5, 2025 - Component Updates](#component-updates-2025-49) <!-- omit in toc -->
237+
- [December 12, 2025 - Component Updates](#component-updates-2025-50) <!-- omit in toc -->
220238

221239
### Improvements
222240

@@ -240,6 +258,7 @@ The following component updates are applicable to this release:
240258

241259
- [November 28, 2025 - Component Updates](#component-updates-2025-48) <!-- omit in toc -->
242260
- [December 5, 2025 - Component Updates](#component-updates-2025-49) <!-- omit in toc -->
261+
- [December 12, 2025 - Component Updates](#component-updates-2025-50) <!-- omit in toc -->
243262

244263
### Security Notices
245264

‎docusaurus.config.js‎

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -262,10 +262,9 @@ const config = {
262262
docsPluginId: "api",
263263
config: {
264264
palette: {
265-
specPath: "docs/api-content/api-docs/v1/api.json",
265+
specPath: "static/apis/v1/api.json",
266266
outputDir: "docs/api-content/api-docs/v1",
267-
downloadUrl:
268-
"https://github.com/spectrocloud/librarium/blob/master/docs/api-content/api-docs/palette-apis.json",
267+
downloadUrl: "/apis/v1/palette-apis.json",
269268
sidebarOptions: {
270269
groupPathsBy: "tag",
271270
categoryLinkSource: "tag",
@@ -275,10 +274,9 @@ const config = {
275274
hideSendButton: true,
276275
},
277276
emc: {
278-
specPath: "docs/api-content/api-docs/edge-v1/emc-api.json",
277+
specPath: "static/apis/edge-v1/emc-api.json",
279278
outputDir: "docs/api-content/api-docs/edge-v1",
280-
downloadUrl:
281-
"https://github.com/spectrocloud/librarium/blob/master/docs/api-content/api-docs/palette-apis.json",
279+
downloadUrl: "/apis/edge-v1/emc-api.json",
282280
sidebarOptions: {
283281
groupPathsBy: "tag",
284282
categoryLinkSource: "tag",

‎linkinator/linkinator-ci.config.json‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,9 @@
2424
"^https://www.intel.com.*$$",
2525
"^https://developer.hashicorp.com.*$$",
2626
"^https://www.packer.io.*$$",
27-
"^https://www.gnu.org.*$$"
27+
"^https://www.gnu.org.*$$",
28+
"^https://socket.dev.*$$",
29+
"^https://www.freedesktop.org.*$$"
2830
],
2931
"verbosity": "error",
3032
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.117 Safari/537.36"

‎linkinator/linkinator-rate-limit-ci.config.json‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,9 @@
2424
"^https://www.intel.com.*$$",
2525
"^https://developer.hashicorp.com.*$$",
2626
"^https://www.packer.io.*$$",
27-
"^https://www.gnu.org.*$$"
27+
"^https://www.gnu.org.*$$",
28+
"^https://socket.dev.*$$",
29+
"^https://www.freedesktop.org.*$$"
2830
],
2931
"verbosity": "error",
3032
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.117 Safari/537.36"

0 commit comments

Comments
 (0)