typhoon/docs/addons
Dalton Hubble b3c384fbc0 Introduce the component system for managing pre-installed addons
* Previously: Typhoon provisions clusters with kube-system components
like CoreDNS, kube-proxy, and a chosen CNI provider (among flannel,
Calico, or Cilium) pre-installed. This is convenient since clusters
come with "batteries included". But it also means upgrading these
components is generally done in lock-step, by upgrading to a new
Typhoon / Kubernetes release
* It can be valuable to manage these components with a separate
plan/apply process or through automations and deploy systems. For
example, this allows managing CoreDNS separately from the cluster's
lifecycle.
* These "components" will continue to be pre-installed by default,
but a new `components` variable allows them to be disabled and
managed as "addons", components you apply after cluster creation
and manage on a rolling basis. For some of these, we may provide
Terraform modules to aide in managing these components.

```
module "cluster" {
  # defaults
  components = {
    enable = true
    coredns = {
      enable = true
    }
    kube_proxy = {
      enable = true
    }
    # Only the CNI set in var.networking will be installed
    flannel = {
      enable = true
    }
    calico = {
      enable = true
    }
    cilium = {
      enable = true
    }
  }
}
```

An earlier variable `install_container_networking = true/false` has
been removed, since it can now be achieved with this more extensible
and general components mechanism by setting the chosen networking
provider enable field to false.
2024-05-19 16:33:57 -07:00
..
fleetlock.md Update poseidon/ct provider and Butane Config version 2023-04-21 08:58:20 -07:00
grafana.md Improve Prometheus rules and alerts and Grafana dashboards 2019-02-18 12:19:23 -08:00
ingress.md Add/update docs for asset_dir and kubeconfig usage 2019-12-05 22:56:42 -08:00
overview.md Introduce the component system for managing pre-installed addons 2024-05-19 16:33:57 -07:00
prometheus.md Change rooted links to absolute links for mkdocs v1.0 2018-10-07 20:51:54 +02:00