Custom Installation/Upgrade

    If you’re trying to upgrade from a big version later (e.g. from 1.2.x to 1.4.x), please refer to version migration for more guides.

    • Script
    • Homebrew
    • Download directly from releases
    • Docker

    MacOS/Linux

    Windows

    tip

    Pre-release versions will not be listed.

    macOS/Linux

    Update your brew first. Please note that the brew method only supports the installation of the official release version.

    1. brew update
    1. brew install kubevela
    • Download the latest vela binary file via .
    • Unzip the binary file, and configure the environment variables in $PATH, and you’re done.
    1. sudo mv ./vela /usr/local/bin/vela

    Custom Installation/Upgrade - 图3caution

    Installation Tips: If you are using a Mac system, it will pop up a warning that “vela” cannot be opened because the package from the developer cannot be verified.

    MacOS imposes stricter restrictions on the software that can run in the system. You can temporarily solve this problem by opening System Preference ->Security & Privacy -> General and clicking on Allow Anyway.

    Pull the latest image from the docker registry, or specify a version as tag:

    note

    Please make sure you already upgraded the Vela CLI to latest stable version.

      1. vela addon enable velaux

      Custom Installation/Upgrade - 图5tip

      Before uninstalling kubevela, you must delete all applications and disable all addons.

      1. Uninstall VelaUX
      1. vela addon disable velaux
      1. Uninstall KubeVela Core
      1. vela uninstall
      1. Uninstall CRD

      Before deleting, you must delete all CR resources.

      By default, KubeVela will use a self-signed certificate provided by for admissionWebhooks. You can also use cert-manager 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. vela install --set admissionWebhooks.certManager.enabled=true
      1. vela version list -a
      3. # Install the specified version.
      4. vela install --version 1.3.0-beta.2

      kubectl-vela provides the same features with vela CLI, it helps you to integrate with kubectl better.

      • Krew
      • Script
      1. Install and set up Krew on your machine.
      2. Discover plugins available on Krew:
      1. kubectl krew update
      1. install kubectl vela:

      macOS/Linux

        You can also download the binary from manually. Kubectl will discover it from your system path automatically.