Skip to content

Commit 75cf50f

Browse files
karl-cardenas-codingyuliiiahvault-token-factory-spectrocloud[bot]addetzravi-k8
authored
Release 4.4.a (#3177)
* fix: release patch * docs: PLT-1267 EC Install Validate Flag (#3176) * docs: PEM-5236 Updated Screenshots (#3182) * docs: PEM-5236 * chore: more tenant images updated * chore: more images * chore: more images * chore: more images * chore: fixed all SSO guides * chore: Fix a broken link (#3183) * Optimised images with calibre/image-actions * Optimised images with calibre/image-actions * Apply suggestions from code review Co-authored-by: Adelina Simion <[email protected]> --------- Co-authored-by: Yuliia Horbenko <[email protected]> Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com> Co-authored-by: Adelina Simion <[email protected]> * docs: PCP-3015 (#3190) * docs: PCP-3015 * chore: removed br * docs: palette 4.4.a API docs (#3245) Co-authored-by: Karl Cardenas <[email protected]> * docs: add edge management api 44a (#3234) Co-authored-by: Lenny Chen <[email protected]> Co-authored-by: Karl Cardenas <[email protected]> * Steps for deleting the incorrectly created `kubernetes` LB and public IP (#3252) * chore: Fix markup and alignment in the Troubleshooting section * docs: Document the steps for deleting the incorrectly created LB * docs: Fix a typo * docs: Apply comments from the peer review * chore: Fix a typo that Vale caught * Document the `fullyPrivateAddressing` property and its limitations for Azure (#3258) * docs: Document the property for Azure * docs: Document the limitations for Azure * chore: Fix link format * docs: Small edits to the topic * docs: Implement peer review * docs: edge host grid view (#3286) * docs: document edge host grid view * docs: add png * docs: add webp * docs: add docs for grid view * Update edge-host-view.md * Optimised images with calibre/image-actions * docs: add page to index pages * minor edit * Apply suggestions from code review Co-authored-by: caroldelwing <[email protected]> * docs: make format --------- Co-authored-by: Lenny Chen <[email protected]> Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com> Co-authored-by: caroldelwing <[email protected]> * docs: update OSS licenses OPS-4804 (#3327) * docs: edge mgmt APIs exposed to connected clusters. (#3235) * docs: document list of apis unavailable to connected clusters * docs: add another endpoint * minor edit * Apply suggestions from code review Co-authored-by: Yuliia Horbenko <[email protected]> --------- Co-authored-by: Lenny Chen <[email protected]> Co-authored-by: Yuliia Horbenko <[email protected]> * docs: PEM-5064 (#3212) * docs: PEM-5064 * draft * docs: test * docs: added draft * chore: fix broken page issue * docs: added warning * Apply suggestions from code review Co-authored-by: caroldelwing <[email protected]> * chore: fix prettier * chore: fixed partials --------- Co-authored-by: caroldelwing <[email protected]> * docs: change screenshot for Edge filter (#3329) * docs: document edge host grid view * docs: add png * docs: add webp * docs: add docs for grid view * Update edge-host-view.md * Optimised images with calibre/image-actions * docs: add page to index pages * minor edit * Apply suggestions from code review Co-authored-by: caroldelwing <[email protected]> * docs: make format * docs: crop screenshot * docs: change to webp * docs: rename image * Optimised images with calibre/image-actions * Optimised images with calibre/image-actions * docs: fix font awesome change --------- Co-authored-by: Lenny Chen <[email protected]> Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com> Co-authored-by: caroldelwing <[email protected]> * docs: add parameter about preventing password change in local ui (#3243) * docs: add parameter for diabling pw change * docs: document password change through API * docs: delete dangling sentence * docs: minor edits * Update docs/docs-content/clusters/edge/local-ui/host-management/access-console.md Co-authored-by: Karl Cardenas <[email protected]> * docs: make format * docs: fix font awesome * docs: cross linking * docs: add cross link * docs: add cloud config * docs: remove unrelated changes * docs: long form commands * docs: address review comments --------- Co-authored-by: Lenny Chen <[email protected]> Co-authored-by: Karl Cardenas <[email protected]> * docs: Update prereqs for the `fullyPrivateAddressing` parameter (#3339) * docs: Update prereqs for the parameter * chore: Trigger build * docs: document new process for customizing local ui and custom links (#3205) * docs: address breaking change for local ui content * Update docs/docs-content/clusters/edge/local-ui/host-management/custom-link.md * docs: add font awesome * docs: minor edit * docs: remove breanking change from release notes * Apply suggestions from code review Co-authored-by: Yuliia Horbenko <[email protected]> * docs: address review comments --------- Co-authored-by: Lenny Chen <[email protected]> Co-authored-by: Yuliia Horbenko <[email protected]> * docs: DOC-1269 PLT-1298 Release Notes 4.4.a (#3320) * docs: DOC-1269 * docs: more notes * docs: more content * docs: added more content * docs: updated release notes * docs: update release notes * docs: vale feedback * docs: added VerteX section * docs: update edge section * docs: minor updates * docs: apply suggestions from code review Co-authored-by: Lenny Chen <[email protected]> * docs: updated release notes * doc: PLT-1298 --------- Co-authored-by: Lenny Chen <[email protected]> Co-authored-by: Lenny Chen <[email protected]> * docs: document signed content (#3251) * docs: draft for signed content * docs: fix broken link * docs: add crosslink * docs: add minor clarifications * Update docs/docs-content/clusters/edge/edgeforge-workflow/palette-canvos/signed-content.md * docs: address review comments * docs: add note about signed content --------- Co-authored-by: Lenny Chen <[email protected]> * Document the steps for using custom CA (#3338) * docs: Document the steps for using custom CA * chore: Trigger build * Optimised images with calibre/image-actions * chore: Fix image format * docs: Add a note about HTTPS and TLS to the custom CA topic --------- Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com> * Convert the HTTPS/TLS admonition to a bullet (#3346) * docs: Convert admonitions to bullets in prerequisites * docs: Update wording * Document the step for removing kind images after EC and PCG installation (#3337) * docs: Document the step for removing kind * chore: Trigger build * docs: Add the guidance for PCG deployments * docs: PCP-3244 * docs: fixed date * docs: fixed broken url * docs: PCP-3141 (#3378) * docs: PCP-3141 * docs: added guides * chore: fix release note * docs: updated release notes * docs: vale feedback * docs: added tip about proxy and Palette support * docs: minor updates * Apply suggestions from code review Co-authored-by: Yuliia Horbenko <[email protected]> * chore: fix prettier * chore: completed feedback suggestions --------- Co-authored-by: Yuliia Horbenko <[email protected]> * docs: PEM-5375 (#3397) * docs: PEM-5375 * docs: vale feedback * docs: update release number * Update Palette CLI Binaries URLs (#3437) * docs: update palette cli binaries URL * docs: update spectro cli download URLs * docs: update spectro registry docker image * docs: rearrange Palette CLI rows so that the latest version comes first * docs: update self-hosted upgrade paths * docs: DOC-1312 (#3438) * docs: DOC-1312 * docs: azure update * Apply suggestions from code review Co-authored-by: Adelina Simion <[email protected]> --------- Co-authored-by: Adelina Simion <[email protected]> * docs: added spectro proxy --------- Co-authored-by: Yuliia Horbenko <[email protected]> Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com> Co-authored-by: Adelina Simion <[email protected]> Co-authored-by: Ravikumar Kondepati <[email protected]> Co-authored-by: Lenny Chen <[email protected]> Co-authored-by: Lenny Chen <[email protected]> Co-authored-by: caroldelwing <[email protected]>
1 parent 2e643b7 commit 75cf50f

File tree

84 files changed

+3582
-8162
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

84 files changed

+3582
-8162
lines changed

.gitignore

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,6 @@ _partials/index.ts
7373
# Ignore statoc/img/packs
7474
static/img/packs
7575

76-
7776
.vale-config/
7877
vale/styles/spectrocloud/
7978
vale/styles/spectrocloud-docs-internal/

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ To contribute, we recommend having the following software installed locally on y
2626

2727
- Node.js v20 and npm.
2828

29-
- [Vale](https://vale.sh/docs/vale-cli/installation/)
29+
- [Vale](https://vale.sh/docs/vale-cli/installation/), version 3.6.0 or higher.
3030

3131
## Local Development (Docker)
3232

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
partial_category: feature-flags
3+
partial_name: feature-flags-overview
4+
---
5+
6+
<!-- prettier-ignore -->
7+
Feature flags allow <PaletteURL text="system administrators" edition={props.edition} url="/system-management/account-management/#system-administrators" /> to
8+
manage what features are available to the system's tenants. They can use this capability to roll out new features to {props.edition} tenants in a controlled manner or choose not to implement a feature for their tenants due to security or compliance reasons.
9+
10+
Features enabled by system administrators are applied to all tenants in the system. Once a feature is enabled, it cannot
11+
be disabled.
12+
13+
:::warning
14+
15+
We recommend trying out new features in a test environment before enabling them in a production environment. Depending
16+
on the feature, enabling it may have a significant impact on the system and current workloads.
17+
18+
:::
19+
20+
Review the following section for detailed instructions on enabling and managing feature flags.
21+
22+
## Enable a Feature
23+
24+
Use the following steps to enable a feature flag.
25+
26+
## Prerequisites
27+
28+
- You are a system administrator of the type _Operations Administrator_ or _Root Administrator_.
29+
30+
- You have access to the system console.
31+
32+
## Enablement
33+
34+
<!-- prettier-ignore -->
35+
1. Log in to the system console. For additional guidance on accessing the system console, check out the
36+
<PaletteURL
37+
edition={props.edition}
38+
text="Access the System Console"
39+
url="/system-management/#access-the-system-console"
40+
/> guide.
41+
42+
2. From the left **Main Menu**, select **Administration**.
43+
44+
3. Select the **Feature Flags** tab.
45+
46+
4. Locate the feature you want to enable and toggle the switch on the right to enable it. You can also search
47+
for a feature by typing the feature name in the search bar.
48+
49+
## Validate
50+
51+
Use the following steps to validate that the feature flag is enabled.
52+
53+
1. Log in as a tenant administrator to one of the tenants in the system.
54+
55+
2. Attempt to access the enabled feature flag. If the feature is enabled, you will be able to use it. If the feature is
56+
disabled, you will not be able to access it.
57+
58+
export function PaletteURL({ edition, text, url }) {
59+
return (
60+
<>
61+
{edition.toLowerCase() === "palette" ? (
62+
<VersionedLink text={text} url={`/enterprise-version${url}`} />
63+
) : (
64+
<VersionedLink text={text} url={`/vertex${url}`} />
65+
)}
66+
</>
67+
);
68+
}

docs/api-content/api-docs/1-introduction.md

Lines changed: 21 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ sidebar_custom_props:
88
icon: "graph"
99
---
1010

11-
The API documentation section includes documentation for Palette API and Local Management API.
11+
The API documentation section includes documentation for Palette API and Edge Management API.
1212

1313
## Palette API
1414

@@ -260,15 +260,15 @@ The API rate limits are as follows:
260260
| /v1/clusterprofiles/:uid/validate/packs | 50 | 5 | 250 |
261261
| /v1/spectroclusters/:uid/profiles | 50 | 5 | 250 |
262262

263-
## Local Management API
263+
## Edge Management API
264264

265265
An Edge host has its own set of API endpoints. These API endpoints are available on each Edge host instead of on a
266-
Palette instance. You can use Local Management API endpoints to programmatically perform tasks such as retrieve
266+
Palette instance. You can use Edge Management API endpoints to programmatically perform tasks such as retrieve
267267
information about Edge clusters, retrieve the list of available images on your Edge host, and create local clusters
268268
using embedded cluster definitions.
269269

270-
You can find the Open API Swagger specification for the Local Management API at the following location:
271-
https://raw.githubusercontent.com/spectrocloud/librarium/version-4-3/docs/api-content/api-docs/edge-v1/emc-api.json
270+
You can find the Open API Swagger specification for the Edge Management API at the following location:
271+
https://raw.githubusercontent.com/spectrocloud/librarium/version-4-4/docs/api-content/api-docs/edge-v1/emc-api.json
272272

273273
:::preview
274274

@@ -395,3 +395,19 @@ curl --location 'https://10.10.135.182:5080/v1/edge-mgmt/edgehosts/current' \
395395
}
396396
}
397397
```
398+
399+
### List of Endpoints Unavailable to Connected Edge Hosts
400+
401+
Most Edge Management API endpoints are available for Edge hosts with or without a connection to Palette. However, some
402+
endpoints are not available to connected Edge hosts and are available to airgapped Edge hosts only. Specifically,
403+
endpoints that create or update clusters, create or update cluster profile variables, and update cluster settings are
404+
unavailable, as those operations must be performed from Palette.
405+
406+
The following is a list of endpoints that are only available to Edge hosts that are not connected to Palette:
407+
408+
- `POST https://edge-host-ip:5080/v1/edge-mgmt/cluster`
409+
- `PATCH https://edge-host-ip:5080/v1/edge-mgmt/cluster`
410+
- `PUT https://edge-host-ip:5080/v1/edge-mgmt/cluster`
411+
- `PUT https://edge-host-ip:5080/v1/edge-mgmt/cluster/profiles`
412+
- `PUT https://edge-host-ip:5080/v1/edge-mgmt/cluster/settings`
413+
- `POST https://edge-host-ip:5080/v1/edge-mgmt/cluster/profiles/variables/validate`

docs/api-content/api-docs/edge-v1/emc-api.json

Lines changed: 134 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
],
1212
"swagger": "2.0",
1313
"info": {
14-
"title": "Edge Management APIs",
14+
"title": "Local Management APIs",
1515
"version": "v1"
1616
},
1717
"paths": {
@@ -564,6 +564,42 @@
564564
}
565565
}
566566
},
567+
"/v1/edge-mgmt/edgehosts/current/actions/content/signing-public-key": {
568+
"get": {
569+
"description": "Get the base64 encoded key used to verify the signed content.",
570+
"tags": [
571+
"content"
572+
],
573+
"summary": "Get the public key used to verify the signed content.",
574+
"operationId": "V1GetContentSigningPublicKey",
575+
"responses": {
576+
"200": {
577+
"description": "(empty)",
578+
"schema": {
579+
"$ref": "#/definitions/v1ContentSigningKey"
580+
}
581+
},
582+
"404": {
583+
"description": "Not found",
584+
"schema": {
585+
"$ref": "#/definitions/v1Error"
586+
}
587+
},
588+
"500": {
589+
"description": "Internal server error",
590+
"schema": {
591+
"$ref": "#/definitions/v1Error"
592+
}
593+
},
594+
"default": {
595+
"description": "generic error response",
596+
"schema": {
597+
"$ref": "#/definitions/apiError"
598+
}
599+
}
600+
}
601+
}
602+
},
567603
"/v1/edge-mgmt/edgehosts/current/actions/reboot": {
568604
"post": {
569605
"description": "Reboot edge host",
@@ -656,10 +692,16 @@
656692
"parameters": [
657693
{
658694
"type": "file",
659-
"description": "The archive file to be uploaded.",
695+
"description": "The clusterconfig file to be uploaded.",
660696
"name": "uploadFile",
661697
"in": "formData",
662698
"required": true
699+
},
700+
{
701+
"type": "file",
702+
"description": "The signature for the corresponding cluster config to be uploaded.",
703+
"name": "signature",
704+
"in": "formData"
663705
}
664706
],
665707
"responses": {
@@ -696,6 +738,12 @@
696738
"name": "uploadFile",
697739
"in": "formData",
698740
"required": true
741+
},
742+
{
743+
"type": "file",
744+
"description": "The signature for the corresponding archive file to be uploaded.",
745+
"name": "signature",
746+
"in": "formData"
699747
}
700748
],
701749
"responses": {
@@ -952,6 +1000,30 @@
9521000
}
9531001
}
9541002
},
1003+
"/v1/edge-mgmt/settings": {
1004+
"get": {
1005+
"description": "Get general settings",
1006+
"tags": [
1007+
"settings"
1008+
],
1009+
"summary": "Get general settings",
1010+
"operationId": "v1Settings",
1011+
"responses": {
1012+
"200": {
1013+
"description": "(empty)",
1014+
"schema": {
1015+
"$ref": "#/definitions/v1Settings"
1016+
}
1017+
},
1018+
"default": {
1019+
"description": "generic error response",
1020+
"schema": {
1021+
"$ref": "#/definitions/apiError"
1022+
}
1023+
}
1024+
}
1025+
}
1026+
},
9551027
"/v1/ping": {
9561028
"get": {
9571029
"description": "Ping Service",
@@ -1679,11 +1751,21 @@
16791751
"$ref": "#/definitions/v1ClusterNodePoolStatus"
16801752
}
16811753
},
1754+
"ntpServersApplied": {
1755+
"type": "boolean",
1756+
"default": false,
1757+
"x-isnullable": false
1758+
},
16821759
"services": {
16831760
"type": "array",
16841761
"items": {
16851762
"$ref": "#/definitions/v1Service"
16861763
}
1764+
},
1765+
"sshKeysApplied": {
1766+
"type": "boolean",
1767+
"default": false,
1768+
"x-isnullable": false
16871769
}
16881770
}
16891771
},
@@ -1776,6 +1858,21 @@
17761858
"Airgap"
17771859
]
17781860
},
1861+
"v1ContentSigningKey": {
1862+
"type": "object",
1863+
"properties": {
1864+
"creationTimestamp": {
1865+
"description": "CreationTimestamp is the timestamp when the resource was created.",
1866+
"$ref": "#/definitions/v1Time"
1867+
},
1868+
"description": {
1869+
"type": "string"
1870+
},
1871+
"key": {
1872+
"type": "string"
1873+
}
1874+
}
1875+
},
17791876
"v1DNS": {
17801877
"type": "object",
17811878
"properties": {
@@ -2086,12 +2183,6 @@
20862183
"type": "string",
20872184
"default": ""
20882185
},
2089-
"isTwoNodeCandidate": {
2090-
"description": "Enable this flag to support 2-Node HA mode. True indicates this edgehost which act as the recovery node. It is a immutable field can be set only during cluster provisioning.",
2091-
"type": "boolean",
2092-
"default": false,
2093-
"x-omitempty": false
2094-
},
20952186
"nic": {
20962187
"description": "Edge native nic",
20972188
"$ref": "#/definitions/v1Nic"
@@ -2103,6 +2194,14 @@
21032194
"staticIP": {
21042195
"description": "Deprecated. Edge host static IP",
21052196
"type": "string"
2197+
},
2198+
"twoNodeCandidatePriority": {
2199+
"description": "Set the edgehost candidate priority as primary or secondary, if the edgehost is nominated as two node candidate",
2200+
"type": "string",
2201+
"enum": [
2202+
"primary",
2203+
"secondary"
2204+
]
21062205
}
21072206
}
21082207
},
@@ -2751,6 +2850,9 @@
27512850
"name": {
27522851
"type": "string"
27532852
},
2853+
"values": {
2854+
"type": "string"
2855+
},
27542856
"version": {
27552857
"type": "string"
27562858
}
@@ -2829,6 +2931,9 @@
28292931
"type": {
28302932
"type": "string"
28312933
},
2934+
"values": {
2935+
"type": "string"
2936+
},
28322937
"version": {
28332938
"type": "string"
28342939
}
@@ -2985,6 +3090,22 @@
29853090
}
29863091
}
29873092
},
3093+
"v1Settings": {
3094+
"type": "object",
3095+
"properties": {
3096+
"hasHarborPack": {
3097+
"type": "boolean",
3098+
"default": false
3099+
},
3100+
"installationMode": {
3101+
"type": "string",
3102+
"enum": [
3103+
"airgap",
3104+
"connected"
3105+
]
3106+
}
3107+
}
3108+
},
29883109
"v1State": {
29893110
"type": "string",
29903111
"enum": [
@@ -3053,6 +3174,11 @@
30533174
"description": "Current user information",
30543175
"type": "object",
30553176
"properties": {
3177+
"disablePasswordUpdate": {
3178+
"description": "Flag to indicate if the user is allowed to update the password",
3179+
"type": "boolean",
3180+
"default": false
3181+
},
30563182
"sshKeys": {
30573183
"description": "Current user's ssh keys",
30583184
"type": "array",

0 commit comments

Comments
 (0)