From 49b0f9eda7830a00988708e0fe4cabf2a4be4114 Mon Sep 17 00:00:00 2001 From: Karl Cardenas Date: Mon, 18 Sep 2023 14:50:03 -0700 Subject: [PATCH] docs: url updates (#1563) * docs: url updates * ci: removed make versions from default runs * docs: updated node repave text * Apply suggestions from code review Co-authored-by: Rita Watson <117382432+ritawatson@users.noreply.github.com> --------- Co-authored-by: Rita Watson <117382432+ritawatson@users.noreply.github.com> --- .../clusters/public-cloud/azure/aks.md | 5 +++-- docs/docs-content/troubleshooting/nodes.md | 19 ++++++++++++++++++- netlify.toml | 2 +- 3 files changed, 22 insertions(+), 4 deletions(-) diff --git a/docs/docs-content/clusters/public-cloud/azure/aks.md b/docs/docs-content/clusters/public-cloud/azure/aks.md index 2cc32a19e0..6d48d6fbd6 100644 --- a/docs/docs-content/clusters/public-cloud/azure/aks.md +++ b/docs/docs-content/clusters/public-cloud/azure/aks.md @@ -94,14 +94,15 @@ For Azure cloud account creation, we first need to create an Azure Active Direct
- + The following steps need to be performed to provision a new cluster:
-1. If you already have a profile to use, go to the **Cluster** > **Add a New Cluster** > **Deploy New Cluster** and select an Azure cloud. If you do not have a profile to use, reference the [Creating a Cluster Profile](https://docs.spectrocloud.com/cluster-profiles/task-define-profile) page for steps on how to create one. +1. If you already have a profile to use, go to **Cluster** > **Add a New Cluster** > **Deploy New Cluster** and select an Azure cloud. If you do not have a profile to use, review the [Creating a Cluster Profile](../../../cluster-profiles/task-define-profile.md) page for steps to create one. + 2. Fill the basic cluster profile information such as **Name**, **Description**, **Tags** and **Cloud Account**. diff --git a/docs/docs-content/troubleshooting/nodes.md b/docs/docs-content/troubleshooting/nodes.md index 8fe88f1fd0..e4080ca220 100644 --- a/docs/docs-content/troubleshooting/nodes.md +++ b/docs/docs-content/troubleshooting/nodes.md @@ -24,7 +24,24 @@ Palette performs a rolling upgrade on nodes when it detects a change in the `kub * Changes in instance types * Certificate renewal -Logs are provided in Palette for traceability. However, these logs may be lost when the pods are relaunched. To ensure that the cause and context is persisted across repaving, a field titled **upgrades** is available in the status section of [SpectroCluster object](https://docs.spectrocloud.com/api/v1/clusters/). This field is represented in the Palette UI so that you can understand why and when repaving happened. +Logs are provided in Palette for traceability. However, these logs may be lost when the pods are relaunched. To ensure that the cause and context is persisted across repaving, refer to the `status.upgrades: []` field in the in the `SpectroCluster` object in the `/v1/dashboard/spectroclusters/:uid/overview` API. + +The following example shows the `status.upgrades` field for a cluster that had Kubernetes configuration changes that resulted in a node repave. The API payload is incomplete for brevity. + +```json hideClipboard +"upgrades": [ + { + "reason": [ + "{v1beta1.KubeadmConfigSpec}.ClusterConfiguration.APIServer.ControlPlaneComponent.ExtraArgs[\"oidc-client-id\"] changed from to xxxxxxxxxxx", + "{v1beta1.KubeadmConfigSpec}.ClusterConfiguration.APIServer.ControlPlaneComponent.ExtraArgs[\"oidc-groups-claim\"] changed from to groups", + "{v1beta1.KubeadmConfigSpec}.ClusterConfiguration.APIServer.ControlPlaneComponent.ExtraArgs[\"oidc-issuer-url\"] changed from to https://console.spectrocloud.com/v1/oidc/tenant/XXXXXXXXXXXX", + "{v1beta1.KubeadmConfigSpec}.ClusterConfiguration.APIServer.ControlPlaneComponent.ExtraArgs[\"oidc-username-claim\"] changed from to email" + ], + "timestamp": "2023-09-18T19:49:33.000Z" + } +] +``` + For detailed information, review the cluster upgrades [page](../clusters/clusters.md). diff --git a/netlify.toml b/netlify.toml index 9dec1859bd..703f5a28d0 100644 --- a/netlify.toml +++ b/netlify.toml @@ -1,5 +1,5 @@ [build] ignore = "./scripts/netlify.sh" - command = "make versions && npm run build" + command = "npm run build"