Giter VIP home page Giter VIP logo

voyager's Introduction

WebsiteSlackForumTwitter

voyager

Voyager provides controller for Ingress and Certificates for Kubernetes developed by AppsCode.

Ingress

In here we call it ExtendedIngress. An extended plugin of Kubernetes Ingress by AppsCode, to support both L7 and L4 loadbalancing via a single ingress. This is built on top of the HAProxy, to support high availability, sticky sessions, name and path-based virtual hosting. This also support configurable application ports with all the features available in Kubernetes Ingress. Here is a complex ingress example that shows how various features can be used. You can find the generated HAProxy Configuration here.

Feautures

Comparison with Kubernetes

Feauture Kube Ingress AppsCode Ingress
HTTP Loadbalancing
TCP Loadbalancing
TLS Termination
Name and Path based virtual hosting
Cross Namespace service support
URL and Header rewriting
Wildcard name virtual hosting
Loadbalancer statistics

Certificate

Kubernetes Controller to manage TLS Certificate.

Feautures

  • Manage Kubernetes TLS secrets backed by Custom Certificate Provider, uses Let's Encrypt by default,
  • Manage issued certificates based on Kubernetes ThirdParty Resources,
  • Domain validation using ACME dns-01 challenges,
  • Support for multiple DNS providers,
  • Auto Renew Certificates,
  • Use issued Certificates with Ingress to Secure Communications.

Supported Versions

Kubernetes 1.3+

User Guide

To deploy voyager in Kubernetes follow this guide. In short this contains those two steps

  1. Create ingress.appscode.com and certificate.appscode.com Third Party Resource
  2. Deploy voyager to kubernetes.

Running voyager alongside with other ingress controller

voyager can be configured to handle default kubernetes ingress or only ingress.appscode.com. voyager can also be run along side with other controllers.

  --ingress-class
  // this flag can be set to 'voyager' to handle only ingress
  // with annotation kubernetes.io/ingress.class=voyager.

  // If unset, voyager will also handle ingress without ingress-class annotation.

Developer Guide

Want to learn whats happening under the hood, read the developer guide.

Contribution

If you're interested in being a contributor, read the contribution guide.

Building voyager

Read Build Instructions to build voyager.

Acknowledgement

Support

If you have any questions, you can reach out to us.

voyager's People

Contributors

tamalsaha avatar sadlil avatar ben-st avatar jakeaustwick avatar mirshahriar avatar

Watchers

James Cloos avatar Zou Nengren avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.