whatisgithub

What is istio-ingress-tutorial?

kelseyhightower/istio-ingress-tutorial — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2018-07-26

321ShellAudience · ops devopsComplexity · 4/5DormantSetup · hard

In one sentence

A step-by-step tutorial for setting up Istio's ingress layer alone, using Envoy proxies to route external traffic into a Kubernetes cluster without adopting all of Istio.

Mindmap

mindmap
  root((repo))
    What it does
      Sets up ingress only
      Uses Envoy proxies
      Istio Pilot manages routing
    Tech stack
      Kubernetes
      Istio
      Envoy
    Use cases
      Route external traffic
      Gradual service migration
      Traffic splitting
    Audience
      Infra operators
      Kubernetes engineers
    Design
      Lightweight adoption
      Step by step guide
      Includes cleanup script

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Set up a front door for external traffic into a Kubernetes cluster using Istio's ingress component alone.

USE CASE 2

Gradually shift traffic from an old service version to a new one using Istio route rules.

USE CASE 3

Learn Istio's traffic routing pieces without committing to the full platform.

USE CASE 4

Manage load-balanced entry points for a Kubernetes-hosted application.

What is it built with?

KubernetesIstioEnvoyShell

How does it compare?

kelseyhightower/istio-ingress-tutorialcodecrafters-io/build-your-own-rediskelseyhightower/nomad-on-kubernetes
Stars321327354
LanguageShellShellShell
Last pushed2018-07-262018-06-26
MaintenanceDormantDormant
Setup difficultyhardmoderatehard
Complexity4/51/54/5
Audienceops devopsdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires provisioning dedicated servers and a load balancer for the Envoy proxy layer on top of an existing Kubernetes cluster.

So what is it?

The Istio Ingress Tutorial is a step-by-step guide that shows you how to route incoming web traffic into applications running on a Kubernetes cluster using a tool called Istio. Instead of forcing you to adopt an entire complex platform all at once, it walks you through setting up just the piece that handles how outside visitors reach your services. At a high level, Kubernetes is a system for running applications across many servers. When you want external users to reach those applications, you need an "ingress controller" to act as a front door. This tutorial sets up that front door using Envoy, a powerful proxy. A central component called the Istio Pilot manages these Envoy proxies and lets you set rules for how traffic flows. The architecture spreads these proxies across dedicated servers, with a load balancer sitting in front to distribute visitor traffic evenly. This guide is built for teams already using Kubernetes who want more control over their traffic routing without committing to a massive platform overhaul. For example, if you run an online store and want to gradually shift traffic from an old version of your checkout service to a new one, the route rules covered here let you do exactly that. It is aimed at infrastructure operators or engineers who need to manage how requests enter a cluster. The project is notable because it emphasizes that adopting large platforms does not have to be an all-or-nothing decision. By focusing exclusively on the ingress component, it keeps the setup lightweight while still providing robust traffic management. The tutorial breaks the process into clear steps, starting from installing client tools and provisioning infrastructure, all the way to configuring specific route rules. It also includes a clean-up script to remove all resources once you are done.

Copy-paste prompts

Prompt 1
Walk me through this tutorial's steps for setting up Istio ingress with Envoy on a Kubernetes cluster.
Prompt 2
How do I write an Istio route rule to gradually shift traffic from an old checkout service to a new one?
Prompt 3
Explain how Istio Pilot and Envoy proxies work together to route incoming traffic in this setup.
Prompt 4
Help me adapt this ingress-only tutorial so I can add it to an existing Kubernetes cluster without adopting the rest of Istio.

Frequently asked questions

What is istio-ingress-tutorial?

A step-by-step tutorial for setting up Istio's ingress layer alone, using Envoy proxies to route external traffic into a Kubernetes cluster without adopting all of Istio.

What language is istio-ingress-tutorial written in?

Mainly Shell. The stack also includes Kubernetes, Istio, Envoy.

Is istio-ingress-tutorial actively maintained?

Dormant — no commits in 2+ years (last push 2018-07-26).

How hard is istio-ingress-tutorial to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is istio-ingress-tutorial for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.