Version: v1.0

Other Install Topics

Install KubeVela with cert-manager

KubeVela can use cert-manager generate certs for your application if it’s available. Note that you need to install cert-manager before the KubeVela chart.

  1. helm repo add jetstack https://charts.jetstack.io
  2. helm repo update
  3. helm install cert-manager jetstack/cert-manager --namespace cert-manager --version v1.2.0 --create-namespace --set installCRDs=true

Install kubevela with enabled certmanager:

  1. helm install --create-namespace -n vela-system --set admissionWebhooks.certManager.enabled=true kubevela kubevela/vela-core

Install Pre-release

Add flag --devel in command helm search to choose a pre-release version in format <next_version>-rc-master. It means a release candidate version build on master branch, such as 0.4.0-rc-master.

  1. helm search repo kubevela/vela-core -l --devel
  1. NAME CHART VERSION APP VERSION DESCRIPTION
  2. kubevela/vela-core 0.4.0-rc-master 0.4.0-rc-master A Helm chart for KubeVela core
  3. kubevela/vela-core 0.3.2 0.3.2 A Helm chart for KubeVela core
  4. kubevela/vela-core 0.3.1 0.3.1 A Helm chart for KubeVela core

And try the following command to install it.

  1. helm install --create-namespace -n vela-system kubevela kubevela/vela-core --version <next_version>-rc-master
  1. NAME: kubevela
  2. LAST DEPLOYED: Thu Apr 1 19:41:30 2021
  3. NAMESPACE: vela-system
  4. STATUS: deployed
  5. REVISION: 1
  6. NOTES:
  7. Welcome to use the KubeVela! Enjoy your shipping application journey!

Upgrade

Step 1. Update Helm repo

You can explore the newly released chart versions of KubeVela by run:

  1. helm repo update
  2. helm search repo kubevela/vela-core -l

Step 2. Upgrade KubeVela CRDs

  1. kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/master/charts/vela-core/crds/core.oam.dev_componentdefinitions.yaml
  2. kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/master/charts/vela-core/crds/core.oam.dev_workloaddefinitions.yaml
  3. kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/master/charts/vela-core/crds/core.oam.dev_traitdefinitions.yaml
  4. kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/master/charts/vela-core/crds/core.oam.dev_applications.yaml
  5. kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/master/charts/vela-core/crds/core.oam.dev_approllouts.yaml
  6. kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/master/charts/vela-core/crds/core.oam.dev_applicationrevisions.yaml
  7. kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/master/charts/vela-core/crds/core.oam.dev_scopedefinitions.yaml
  8. kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/master/charts/vela-core/crds/core.oam.dev_appdeployments.yaml
  9. kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/master/charts/vela-core/crds/core.oam.dev_applicationcontexts.yaml
  10. kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/master/charts/vela-core/crds/core.oam.dev_definitionrevisions.yaml

Tips: If you see errors like * is invalid: spec.scope: Invalid value: "Namespaced": filed is immutable. Please delete the CRD which reports error and re-apply the kubevela crds.

  1. kubectl delete crd \
  2. scopedefinitions.core.oam.dev \
  3. traitdefinitions.core.oam.dev \
  4. workloaddefinitions.core.oam.dev

Step 3. Upgrade KubeVela Helm chart

  1. helm upgrade --install --create-namespace --namespace vela-system kubevela kubevela/vela-core --version <the_new_version>

Clean Up

Run:

  1. helm uninstall -n vela-system kubevela
  2. rm -r ~/.vela

This will uninstall KubeVela server component and its dependency components. This also cleans up local CLI cache.

Then clean up CRDs (CRDs are not removed via helm by default):

  1. kubectl delete crd \
  2. appdeployments.core.oam.dev \
  3. applicationconfigurations.core.oam.dev \
  4. applicationcontexts.core.oam.dev \
  5. applicationrevisions.core.oam.dev \
  6. applications.core.oam.dev \
  7. approllouts.core.oam.dev \
  8. componentdefinitions.core.oam.dev \
  9. components.core.oam.dev \
  10. containerizedworkloads.core.oam.dev \
  11. healthscopes.core.oam.dev \
  12. manualscalertraits.core.oam.dev \
  13. podspecworkloads.standard.oam.dev \
  14. scopedefinitions.core.oam.dev \
  15. traitdefinitions.core.oam.dev \
  16. workloaddefinitions.core.oam.dev \
  17. definitionrevisions.core.oam.dev