15308555518/ website
1
0
Fork 0
mirror of https://github.com/kubesphere/website.git synced 2026-01-01 03:33:29 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #930 from Sherlock113/addonin 

add add-on error faq
This commit is contained in:
Sherlock113 2021-01-18 09:40:20 +08:00 committed by GitHub
parent 936ba150c7 8bb21ae096
commit 53cdb676ae
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 38 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
content/en/docs/faq/installation/install-addon-through-yaml-using-kubekey.md Normal file
View File

@ -0,0 +1,19 @@
---
title: "Install an Add-on through YAML Using KubeKey"
keywords: "Installer, KubeKey, KubeSphere, Kubernetes, add-ons"
description: "Fail to install an add-on through YAML using KubeKey"
linkTitle: "Install an Add-on through YAML Using KubeKey"
Weight: 16400
---
When you use KubeKey to install add-ons, you put the add-on information (Chart or YAML) under the `addons` field in the configuration file (`config-sample.yaml` by default). If the add-on configuration is provided as a YAML file, in some cases, you may see an error message similar to this during the installation:
```bash
Error from server: failed to create typed patch object: xxx: element 0: associative list with keys has an element that omits key field "protocol"
```
This is a [known issue of Kubernetes itself](https://github.com/kubernetes-sigs/structured-merge-diff/issues/130), caused by the flag `--server-side`. To solve this issue, do not add your add-on in the configuration file. Instead, you can apply your YAML file after KubeSphere is deployed. For example:
```bash
kubectl apply -f xxx.yaml # Use your own YAML file.
```

19
content/zh/docs/faq/installation/install-addon-through-yaml-using-kubekey.md Normal file
View File

@ -0,0 +1,19 @@
---
title: "Install an Add-on through YAML Using KubeKey"
keywords: "Installer, KubeKey, KubeSphere, Kubernetes, add-ons"
description: "Fail to install an add-on through YAML using KubeKey"
linkTitle: "Install an Add-on through YAML Using KubeKey"
Weight: 16400
---
When you use KubeKey to install add-ons, you put the add-on information (Chart or YAML) under the `addons` field in the configuration file (`config-sample.yaml` by default). If the add-on configuration is provided as a YAML file, in some cases, you may see an error message similar to this during the installation:
```bash
Error from server: failed to create typed patch object: xxx: element 0: associative list with keys has an element that omits key field "protocol"
```
This is a [known issue of Kubernetes itself](https://github.com/kubernetes-sigs/structured-merge-diff/issues/130), caused by the flag `--server-side`. To solve this issue, do not add your add-on in the configuration file. Instead, you can apply your YAML file after KubeSphere is deployed. For example:
```bash
kubectl apply -f xxx.yaml # Use your own YAML file.
```