Skip to content

Commit 57379e9

Browse files
Note: restart k8c api after dex migration (kubermatic#1897)
* Note: restart k8c api after dex migration * update * update
1 parent 10fed03 commit 57379e9

File tree

3 files changed

+21
-0
lines changed
  • content/kubermatic

3 files changed

+21
-0
lines changed

content/kubermatic/main/installation/upgrading/upgrade-from-2.26-to-2.27/_index.en.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,13 @@ Finally, theming support has changed. The old `oauth` Helm chart allowed to inli
184184

185185
Once you have prepared a new `values.yaml` with the updated configuration, remember to set `useNewDexChart` to `true` and then you're ready. The next time you run the KKP installer, it will install the `dex` Chart for you, but leave the `oauth` release untouched in your cluster. Note that you cannot have two Ingress objects with the same host names and paths, so if you install the new Dex in parallel to the old one, you will have to temporarily use a different hostname (e.g. `kkp.example.com/dex` for the old one and `kkp.example.com/dex2` for the new Dex installation).
186186

187+
**Restarting Kubermatic API After Dex Migration**:
188+
If you choose to delete the `oauth` chart and immediately switch to the new `dex` chart without using a different hostname, it is recommended to restart the `kubermatic-api` to ensure proper functionality. You can do this by running the following command:
189+
190+
```bash
191+
kubectl rollout restart deploy kubermatic-api -n kubermatic
192+
```
193+
187194
#### Important: Update OIDC Provider URL for Hostname Changes
188195
Before configuring the UI to use the new URL, ensure that the new Dex installation is healthy by checking that the pods are running and the logs show no suspicious errors.
189196

content/kubermatic/main/installation/upgrading/upgrade-from-2.27-to-2.28/_index.en.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -255,6 +255,13 @@ Finally, theming support has changed. The old `oauth` Helm chart allowed to inli
255255

256256
**Note that you cannot have two Ingress objects with the same host names and paths. So if you install the new Dex in parallel to the old one, you will have to temporarily use a different hostname (e.g. `kkp.example.com/dex` for the old one and `kkp.example.com/dex2` for the new Dex installation).**
257257

258+
**Restarting Kubermatic API After Dex Migration**:
259+
If you choose to delete the `oauth` chart and immediately switch to the new `dex` chart without using a different hostname, it is recommended to restart the `kubermatic-api` to ensure proper functionality. You can do this by running the following command:
260+
261+
```bash
262+
kubectl rollout restart deploy kubermatic-api -n kubermatic
263+
```
264+
258265
#### Important: Update OIDC Provider URL for Hostname Changes
259266

260267
Before configuring the UI to use the new URL, ensure that the new Dex installation is healthy by checking that the pods are running and the logs show no suspicious errors.

content/kubermatic/v2.27/installation/upgrading/upgrade-from-2.26-to-2.27/_index.en.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,13 @@ Finally, theming support has changed. The old `oauth` Helm chart allowed to inli
184184

185185
Once you have prepared a new `values.yaml` with the updated configuration, remember to set `useNewDexChart` to `true` and then you're ready. The next time you run the KKP installer, it will install the `dex` Chart for you, but leave the `oauth` release untouched in your cluster. Note that you cannot have two Ingress objects with the same host names and paths, so if you install the new Dex in parallel to the old one, you will have to temporarily use a different hostname (e.g. `kkp.example.com/dex` for the old one and `kkp.example.com/dex2` for the new Dex installation).
186186

187+
**Restarting Kubermatic API After Dex Migration**:
188+
If you choose to delete the `oauth` chart and immediately switch to the new `dex` chart without using a different hostname, it is recommended to restart the `kubermatic-api` to ensure proper functionality. You can do this by running the following command:
189+
190+
```bash
191+
kubectl rollout restart deploy kubermatic-api -n kubermatic
192+
```
193+
187194
#### Important: Update OIDC Provider URL for Hostname Changes
188195
Before configuring the UI to use the new URL, ensure that the new Dex installation is healthy by checking that the pods are running and the logs show no suspicious errors.
189196

0 commit comments

Comments
 (0)