Installing Antrea with Helm

    We provide the following Helm charts:

    • : the Antrea network plugin.
    • antrea/flow-aggregator: the Antrea Flow Aggregator; see here for more details.
    • antrea/theia: Theia, the Antrea network observability solution; refer to the sub-project for more details.

    Note that these charts are the same charts that we use to generate the YAML manifests for the installation method.

    Helm installation is currently considered Alpha.

    • Ensure that the necessary for running Antrea are met.

    • Ensure that Helm 3 is installed. We recommend using a recent version of Helm if possible. Refer to the for compatibility between Helm and Kubernetes versions.

    Installation

    To install the Antrea Helm chart, use the following command:

    1. helm install antrea antrea/antrea --namespace kube-system

    This will install the latest available version of Antrea. You can also install a specific version of Antrea (>= v1.8.0) with --version <TAG>.

    Upgrade

    To upgrade the Antrea Helm chart, use the following commands:

    An important note on CRDs

    Helm 3 introduces “special treatment” for , with the ability to place CRD definitions (as plain YAML, not templated) in a special crds/ directory. When CRDs are defined this way, they will be installed before other resources (in case these other resources include CRs corresponding to these CRDs). CRDs defined this way will also never be deleted (to avoid accidental deletion of user-defined CRs) and will also never be upgraded (in case the chart author didn’t ensure that the upgrade was backwards-compatible). The rationale for all of this is described in details in this Helm community document.

    Even though Antrea follows a , which reduces the likelihood of a serious issue when upgrading Antrea, we have decided to follow Helm best practices when it comes to CRDs. It means that an extra step is required for upgrading the chart:

    The Flow Aggregator is on the same release schedule as Antrea. Please ensure that you use the same released version for the Flow Aggregator chart as for the Antrea chart.

    Installation

    To install the Flow Aggregator Helm chart, use the following command:

    This will install the latest available version of the Flow Aggregator. You can also install a specific version (>= v1.8.0) with --version <TAG>.

    Upgrade

    To upgrade the Flow Aggregator Helm chart, use the following command:

      Refer to the Theia documentation.