Istio

An open platform to connect, manage, and secure microservices.

• Introduction
• Istio authors
• Repositories
• Issue management
• Contributing to the project
• Community and support

Introduction

Istio is an open platform for providing a uniform way to integrate microservices, manage traffic flow across microservices, enforce policies and aggregate telemetry data. Istio's control plane provides an abstraction layer over the underlying cluster management platform, such as Kubernetes, Mesos, etc.

Visit istio.io for in-depth information about using Istio.

Istio is composed of these components:

• Envoy - Sidecar proxies per microservice to handle ingress/egress traffic between services in the cluster and from a service to external services. The proxies form a secure microservice mesh providing a rich set of functions like discovery, rich layer-7 routing, circuit breakers, policy enforcement and telemetry recording/reporting functions.

  Note: The service mesh is not an overlay network. It simplifies and enhances how microservices in an application talk to each other over the network provided by the underlying platform.

• Mixer - Central component that is leveraged by the proxies and microservices to enforce policies such as ACLs, rate limits, quotas, authentication, request tracing and telemetry collection.

• Pilot - A component responsible for configuring the proxies at runtime.

• CA - A component responsible for cert issuance and rotation.

• Broker - A component implementing the open service broker API for Istio-based services. (Under development)

Istio currently supports Kubernetes, Consul, Eureka-based environments. We plan support for additional platforms such as Cloud Foundry, and Mesos in the near future.

Istio authors

Istio is an open source project with an active development community. The project was started by teams from Google and IBM, in partnership with the Envoy team at Lyft.

Repositories

The Istio project is divided across multiple GitHub repositories. Each repository contains information about how to build and test it.

• istio/api. This repository defines component-level APIs and common configuration formats for the Istio platform.

• istio/auth. This repository contains auth related code, including CA (Cert Authority), node agent, etc.

• istio/istio. This is the repo you are currently looking at. It hosts the various Istio sample programs along with the various documents that govern the Istio open source project.

• istio/pilot. This repository contains platform-specific code to populate the abstract service model, dynamically reconfigure the proxies when the application topology changes, as well as translate routing rules into proxy specific configuration. The istioctl command line utility is also available in this repository.

• istio/mixer. This repository contains code to enforce various policies for traffic passing through the proxies, and collect telemetry data from proxies and services. There are plugins for interfacing with various cloud platforms, policy management services, and monitoring services.

• istio/mixerclient. Client libraries for the mixer API.

• istio/broker. This repository contains code for Istio's implementation of the Open Service Broker API.

• istio/proxy. The Istio proxy contains extensions to the Envoy proxy (in the form of Envoy filters), that allow the proxy to delegate policy enforcement decisions to the mixer.

Issue management

We use GitHub combined with ZenHub to track all of our bugs and feature requests. Each issue we track has a variety of metadata:

• Epic. An epic represents a feature area for Istio as a whole. Epics are fairly broad in scope and are basically product-level things. Each issue is ultimately part of an epic.

• Milestone. Each issue is assigned a milestone. This is 0.1, 0.2, 0.3, or 'Nebulous Future'. The milestone indicates when we think the issue should get addressed.

• Priority/Pipeline. Each issue has a priority which is represented by the Pipeline field within GitHub. Priority can be one of P0, P1, P2, or >P2. The priority indicates how important it is to address the issue within the milestone. P0 says that the milestone cannot be considered achieved if the issue isn't resolved.

We don't annotate issues with Releases; Milestones are used instead. We don't use GitHub projects at all, that support is disabled for our organization.

Contributing to the project

We promote and encourage a set of shared values to improve our productivity and inter-personal interactions.

See the working groups for a list of working groups to participate in.

See the contribution guidelines for information on how to participate in the Istio project by submitting pull requests or issues.

You can then check out how to setup for development.

Community and support

There are several communication channels available to get support for Istio or to participate in its evolution.