Upgrade Istio using istioctl [Experimental]

    The command performs an upgrade of Istio. Before performingthe upgrade, it checks that the Istio installation meets the upgrade eligibilitycriteria. Also, it alerts the user if it detects any changes in the profiledefault values between Istio versions.

    The upgrade command can also perform a downgrade of Istio.

    See the istioctl upgrade referencefor all the options provided by the istioctl experimental upgrade command.

    Ensure you meet these requirements before starting the upgrade process:

    • Istio version 1.3.3 or higher is installed.

    • Your Istio installation was .

    Traffic disruption may occur during the upgrade process. To minimize the disruption, ensurethat at least two replicas of each component (except Citadel) are running. Also, ensure thatPodDistruptionBudgetsare configured with a minimum availability of 1.

    The commands in this section should be run using the new version of istioctl whichcan be found in the bin/ subdirectory of the downloaded package.

    • and change directory to the new release directory.

    • Verify that istoctl supports upgrading from your current Istio version byviewing the supported versions list:

    • Ensure that your Kubernetes configuration points to the cluster to upgrade:

    <your-custom-configuration-file> is theIstioControlPlane API Custom Resource Definitionfile you used to customize the installation of the currently-running version of Istio.

    istioctl upgrade does not support the —set flag. Therefore, if youinstalled Istio using the —set command, create a configuration file withthe equivalent configuration options and pass it to the istioctl upgradecommand using the -f flag instead.

    If you omit the -f flag, Istio upgrades using the default profile.

    After performing several checks, will ask you to confirm whether to proceed.

    • istioctl will install the new version of Istio control plane and indicate thecompletion status.

    • After istioctl completes the upgrade, you must manually update the Istio data planeby restarting any pods with Istio sidecars:

    Ensure you meet these requirements before starting the downgrade process:

    • Istio version 1.4 or higher is installed.

    • Your Istio installation was .

    • Downgrade must be done using the istioctl binary version thatcorresponds to the Istio version that you intend to downgrade to.For example, if you are downgrading from Istio 1.4 to 1.3.3, use istioctlversion 1.3.3.

    You can also use istioctl upgrade to downgrade versions. The process steps areidentical to the upgrade process mentioned in the previous section, only use theistioctl binary corresponding to the lower version. When completed, theprocess will restore Istio back to the Istio version that was installed beforeyou ran istioctl experimental upgrade.

    The istioctl experimental upgrade command is not available in Istio 1.3.3 and lower.Therefore, downgrade must be performed using the command.

    Upgrade using Helm

    Upgrade the Istio control plane, and optionally, the CNI plug-in using Helm.

    De-mystify how Istio manages to plugin its data-plane components into an existing deployment.

    Diagnose your Configuration with Istioctl Analyze

    Shows you how to use istioctl analyze to identify potential issues with your configuration.

    在 Docker Desktop 中运行 Istio 的设置说明。

    Getting Started

    Download, install, and try out Istio.