KubeZero/docs/Upgrade.md

99 lines
3.0 KiB
Markdown
Raw Normal View History

2020-11-26 17:37:10 +00:00
# Upgrade to KubeZero V2(Argoless)
2020-12-01 15:56:22 +00:00
## (optional) Upgrade control plane nodes / worker nodes
- Set kube version in the controller config to eg. `1.18`
- Update kube-controller and worker stacks with latest CFN code
- terminate controller node(s)
- once all controller nodes successfully upgraded replace worker nodes in a rolling fashion via. drain / terminate / rinse-repeat
## ArgoCD
- disable all auto-sync and "prune" features to prevent that eg. namespaces from previous apps get removed
2020-12-01 15:46:04 +00:00
- either remove auto-sync from old values.yaml and run deploy one last time, trigger kubezero sync !
- or disable manual via Argo UI starting with Kubezero app itself
2020-11-26 17:37:10 +00:00
2020-12-01 15:56:22 +00:00
- uninstall argo helm chart:
`helm uninstall kubezero -n argocd`
- remove all "argocd.argoproj.io/instance" labels from namespaces to prevent namespace removal later on:
`./scripts/remove_argo_ns.sh`
2020-11-26 17:37:10 +00:00
2020-12-01 15:56:22 +00:00
## KubeZero - Part 1
2020-11-30 17:30:06 +00:00
- migrate values.yaml to new structure, adapt as needed
2020-12-01 15:46:04 +00:00
& update new central kubezero location in git and merge cluster configs
2020-11-26 17:37:10 +00:00
2020-12-01 15:56:22 +00:00
- upgrade all CRDs:
2020-12-01 15:46:04 +00:00
`./bootstrap.sh crds all clusters/$CLUSTER ../../../kubezero/charts`
2020-12-01 15:56:22 +00:00
- upgrade first components:
2020-12-01 15:46:04 +00:00
`./bootstrap.sh deploy calico,cert-manager,kiam,aws-ebs-csi-driver,aws-efs-csi-driver clusters/$CLUSTER ../../../kubezero/charts`
2020-12-01 15:56:22 +00:00
## Istio - Brief DOWNTIME STARTS !
2020-12-01 15:46:04 +00:00
- Istio, due to changes of the ingress namespace we need brief downtime
2020-12-01 15:56:22 +00:00
2020-12-01 15:46:04 +00:00
- delete istio operators, to remove all pieces, remove operator itself
`./scripts/delete_istio_17.sh`
- deploy istio and istio-ingress via bootstrap.sh
`./bootstrap.sh deploy all clusters/$CLUSTER ../../../kubezero/charts`
- patch all VirtualServices via script to new namespace
`./scripts/patch_vs.sh`
2020-12-01 15:56:22 +00:00
!! DOWNTIME ENDS !!
## KubeZero - Part 2
- push kubezero & cluster config to git
- upgrade all remaining components and install new ArgoCD:
2020-12-01 15:46:04 +00:00
`./bootstrap.sh deploy all clusters/$CLUSTER ../../../kubezero/charts`
2020-12-01 15:56:22 +00:00
## Verification / Tests
2020-12-01 15:46:04 +00:00
- verify argocd incl. kubezero app
2020-12-01 15:56:22 +00:00
- verify all argo apps status
2020-12-01 15:46:04 +00:00
- verify all the things
2020-11-30 17:30:06 +00:00
2020-12-01 15:56:22 +00:00
# Changelog
2020-11-26 17:37:10 +00:00
## High level / Admin changes
- ArgoCD is now optional
- ArgoCD is NOT required nor used during initial cluster bootstrap
- the initial bootstrap script now uses the same config as ArgoCD later on
- the initial bootstrap is WAY faster and re-try safe
2020-11-30 17:30:06 +00:00
## Individual changes
2020-11-26 17:37:10 +00:00
### Cert-manager
- local issuer is now a cluster issuer
- all resources moved to cert-manager namespace
### Kiam
- check certs and function due to cert-manager changes
- set priorty class
### Logging
- ES/Kibana version bump, new ECK operator
### ArgoCD
- version bump, new app of app architecure
### Metrics
- version bumps
- all servicemonitor resources are now in the same namespaces as the apps
- check all metrics still work
### Calico
- version bump
2020-11-30 17:30:06 +00:00
### EBS
- version bump
2020-11-26 17:37:10 +00:00
### Istio
- operator removed, deployment migrated to helm, cleanups
- version bump to 1.8
2020-12-01 15:46:04 +00:00
- no more policy pod by default
2020-11-26 17:37:10 +00:00
- all ingress in dedicated new namespace istio-ingress as well as dedicated helm chart
- set priorty class