Fix RKE addons list and add/remove/switch behavior

This commit is contained in:
Sebastiaan van Steenis
2019-11-03 20:15:13 -08:00
committed by Denise
parent a65c745994
commit d6aa6531ae
3 changed files with 6 additions and 3 deletions
@@ -13,12 +13,11 @@ RKE supports configuring pluggable add-ons in the cluster YML. Add-ons are used
These add-ons require images that can be found under the [`system_images` directive]({{< baseurl >}}/rke/latest/en/config-options/system-images/). For each Kubernetes version, there are default images associated with each add-on, but these can be overridden by changing the image tag in `system_images`. These add-ons require images that can be found under the [`system_images` directive]({{< baseurl >}}/rke/latest/en/config-options/system-images/). For each Kubernetes version, there are default images associated with each add-on, but these can be overridden by changing the image tag in `system_images`.
There are a few things worth noting: There are a few things worth noting:
* In addition to these pluggable add-ons, you can specify an add-on that you want deployed after the cluster deployment is complete. * In addition to these pluggable add-ons, you can specify an add-on that you want deployed after the cluster deployment is complete.
* RKE only adds additional add-ons when using `rke up` multiple times. RKE does **not** support removing of cluster add-ons when doing `rke up` with a different list of add-ons.
* As of v0.1.8, RKE will update an add-on if it is the same name. * As of v0.1.8, RKE will update an add-on if it is the same name.
* Prior to v0.1.8, update any add-ons by using `kubectl edit`. * Prior to v0.1.8, update any add-ons by using `kubectl edit`.
## Critical and Non-Critical Add-ons ## Critical and Non-Critical Add-ons
As of version v0.1.7, add-ons are split into two categories: As of version v0.1.7, add-ons are split into two categories:
@@ -16,6 +16,8 @@ RKE provides the following DNS providers that can be deployed as add-ons:
CoreDNS was made the default in RKE v0.2.5 when using Kubernetes 1.14 and higher. If you are using an RKE version lower than v0.2.5, kube-dns will be deployed by default. CoreDNS was made the default in RKE v0.2.5 when using Kubernetes 1.14 and higher. If you are using an RKE version lower than v0.2.5, kube-dns will be deployed by default.
> **Note:** If you switch from one DNS provider to another, the existing DNS provider will be removed before the new one is deployed.
# CoreDNS # CoreDNS
_Available as of v0.2.5_ _Available as of v0.2.5_
@@ -10,6 +10,8 @@ RKE provides the following network plug-ins that are deployed as add-ons:
- Canal - Canal
- Weave - Weave
> **Note:** After you launch the cluster, you cannot change your network provider. Therefore, choose which network provider you want to use carefully, as Kubernetes doesn’t allow switching between network providers. Once a cluster is created with a network provider, changing network providers would require you tear down the entire cluster and all its applications.
By default, the network plug-in is `canal`. If you want to use another network plug-in, you need to specify which network plug-in to enable at the cluster level in the `cluster.yml`. By default, the network plug-in is `canal`. If you want to use another network plug-in, you need to specify which network plug-in to enable at the cluster level in the `cluster.yml`.
```yaml ```yaml