Comments (4)
Yeah, some of those things can technically be disabled, but will break other things if they are, so we don't document them. For example:
- disabling rolebindings will break most of the k3s built-in controllers.
- disabling ccm will break the built-in cloud controller.
- disabling runtimes will remove the runtimeclasses for all autodetected runtimes.
- disabling individual metrics-server addons (aggregated-metrics-reader, and so on) will break metrics-server, which is split across 7 different add-ons for historical reasons.
from docs.
but will break other things if they are, so we don't document them.
I understand, but maybe there should still be a list of reserved names. Or the advise should recommend prefixing additional manifests with some custom prefix?
I noticed this because I was creating a runtimes.yaml
and then found that k3s
was just overwriting it (which doesn't make any sense if you specify the --container-runtime-endpoint
or --docker
options, but whatever).
It's not a big deal, as I wouldn't have checked the documentation until after I ran into problems anyways. 😄
Feel free to close if you think this is not worth the trouble.
from docs.
No I think you are correct that we should document this. There are also some nuances of how disable works - note that --disable=metrics-server
works because the addon manifests are in a directory named metrics-server, which is not exactly how we document things working.
A lot of this is stuff that was thrown together early on and we have avoided changing to try to prevent breakage on upgrades; it's certainly not ideal.
from docs.
There are also some nuances of how disable works
That's why I like the SERVICE.yaml.skip
mechanism. You just touch the file, and either the k3s
versions knows about SERVICE
and skips it, or it simply ignores the file.
No need to worry if --disable=SERVICE
will fail in older k3s
versions because maybe --disable
wasn't supported yet, or maybe it validated that SERVICE
was a known service, to catch typos etc. Worst case is that it will kubectl apply
the file as a manifest, which should be a no-op because the file is empty.
from docs.
Related Issues (20)
- docs: cli documentation nor faq describes what a server or agent is.
- Document pitfalls when attempting a downgrade
- Deploying the Kubernetes Dashboard fails on v3 due to a breaking change HOT 3
- Document use of base template for containerd config
- "Stopping K3s" page is misleading
- Document the default(?) path used by local-path-provisioner for --default-local-storage-path HOT 2
- Documentation doesn't give details on external database setup and permissions HOT 1
- air-gap installation instruction to include steps for installing k3s-selinux packages offline HOT 1
- Reorganize networking content in the docs HOT 1
- Move OS prereqs out of "advanced configuration" HOT 1
- Confusing documentation on secrets encryption. HOT 2
- No reference to `k3s-ansible` repo in documentation
- Example Traefik chart config is out of date HOT 2
- automatic upgrade, not tolerating my default and still on deprectaded k3s version HOT 3
- `curl` command for downloading k3s airgap images not working
- Update Sizing Guide based on stress test data
- Installation of CRD for system-upgrade-controller is missing HOT 1
- Failed to determine GroupVersionResource for manifest HOT 1
- improve config.yaml documentation, provide example with all available keys HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docs.