Istio

What is Istio

Istio is an open-source service mesh that provides a uniform way to manage, connect, and secure microservices. It helps to manage traffic, enhance security capabilities, and provide telemetry data for understanding service behavior. See the open-source Istio documentation.

The Istio module installs and manages Istio in your Kyma cluster. The version of Istio depends on the version of the Istio module that you use. When a new version of the Istio module introduces a new version of Istio, an upgrade of the module causes an automatic upgrade of Istio. To track the changes introduced in open-source Istio, learn which version of Istio the latest version of the Istio module installs. For this information, follow Releases. To learn how to enable compatibility with the previous minor version of Istio, see Compatibility Mode.

Install the Latest Release of the Istio Module

Prerequisites

• Access to a Kubernetes cluster
• kubectl

Procedure

1. Create the kyma-system namespace and label it with istio-injection=enabled:

   kubectl create namespace kyma-system
   kubectl label namespace kyma-system istio-injection=enabled --overwrite
   

2. Install the latest version of Istio Operator and Istio CustomResourceDefinition. You can install either the standard or experimental version.

   • To install the standard version, run:

     kubectl apply -f https://github.com/kyma-project/istio/releases/latest/download/istio-manager.yaml
     

   • To install the experimental version, run:

     kubectl apply -f https://github.com/kyma-project/istio/releases/latest/download/istio-manager-experimental.yaml
     

3. To install Istio, apply the default Istio custom resource (CR):

   kubectl apply -f https://github.com/kyma-project/istio/releases/latest/download/istio-default-cr.yaml
   

4. To verify the Istio was installed successfully, check the state of the Istio CR.

   kubectl get -n kyma-system istios/default
   

   After successful installation, you get the following output:

   NAME      STATE
   default   Ready
   

For more installation options, visit the installation guide.

Useful links

To learn how to use the Istio module, read the documentation in the user directory.

If you are interested in the detailed documentation of the Istio module's design and technical aspects, check the contributor directory.

Contributing

See the Contributing guidelines.

Code of Conduct

See the Code of Conduct document.

Licensing

See the license file.