Document extension APIserver

This commit is contained in:
Tom Lebreux
2025-03-17 13:18:11 -04:00
parent af896b7aba
commit 1391623ae5
3 changed files with 28 additions and 0 deletions
+25
View File
@@ -0,0 +1,25 @@
---
title: Extension Apiserver
---
<head>
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/api/extension-apiserver"/>
</head>
Rancher extends Kubernetes with additional APIs by registering an extension
apiserver using [Kubernetes's Aggregation
layer](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation/).
## Disabling the extension apiserver
The [aggregation layer must be
configured](https://kubernetes.io/docs/tasks/extend-kubernetes/configure-aggregation-layer/)
on the local Kubernetes cluster for the `imperative-api-extension` feature to be
enabled and to work correctly. The feature assumes this is configured and is
enabled by default. If it is not possible to configure the aggregation layer for
your local Kubernetes cluster, then you must turn off the feature.
It will still be possible to access the additional APIs when the feature is
turned off. The additional APIs are available at `https://<rancher url>/ext` and
they are compatible with Kubernetes apiserver. This means you can use `curl` or
even `kubectl` to interact with the APIs.
@@ -22,6 +22,7 @@ The following is a list of feature flags available in Rancher. If you've upgrade
- `continuous-delivery`: Allows Fleet GitOps to be disabled separately from Fleet. See [Continuous Delivery.](../../../how-to-guides/advanced-user-guides/enable-experimental-features/continuous-delivery.md) for more information.
- `fleet`: The Rancher provisioning framework in v2.6 and later requires Fleet. The flag will be automatically enabled when you upgrade, even if you disabled this flag in an earlier version of Rancher. See [Continuous Delivery with Fleet](../../../integrations-in-rancher/fleet/fleet.md) for more information.
- `harvester`: Manages access to the Virtualization Management page, where users can navigate directly to Harvester clusters and access the Harvester UI. See [Harvester Integration Overview](../../../integrations-in-rancher/harvester/overview.md) for more information.
- `imperative-api-extension`: Enables Rancher's [extension API server](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation/) to register new APIs to Kubernetes. See [Extension Apiserver](../../../api/extension-apiserver.md) for more information.
- `istio-virtual-service-ui`: Enables a [visual interface](../../../how-to-guides/advanced-user-guides/enable-experimental-features/istio-traffic-management-features.md) to create, read, update, and delete Istio virtual services and destination rules, which are Istio traffic management features.
- `legacy`: Enables a set of features from 2.5.x and earlier, that are slowly being phased out in favor of newer implementations. These are a mix of deprecated features as well as features that will eventually be available to newer versions. This flag is disabled by default on new Rancher installations. If you're upgrading from a previous version of Rancher, this flag is enabled.
- `managed-system-upgrade-controller`: Enables the installation of the system-upgrade-controller app in downstream RKE2/K3s clusters, currently limited to imported clusters and the local cluster, with plans to expand support to node-driver clusters.
@@ -44,6 +45,7 @@ The following table shows the availability and default values for some feature f
| `fleet` | `true` | Can no longer be disabled | v2.6.0 | |
| `fleet` | `true` | GA | v2.5.0 | |
| `harvester` | `true` | Experimental | v2.6.1 | |
| `imperative-api-extension` | `true` | GA | v2.11.0 | |
| `legacy` | `false` for new installs, `true` for upgrades | GA | v2.6.0 | |
| `managed-system-upgrade-controller` | `true` | GA | v2.10.0 | |
| `rke1-custom-node-cleanup`| `true` | GA | v2.6.0 | |
+1
View File
@@ -1359,6 +1359,7 @@ const sidebars = {
},
"api/api-reference",
"api/api-tokens",
"api/extension-apiserver",
"api/v3-rancher-api-guide",
]
},