Repository files navigation

Go kit is adistributed programming toolkit for building microservicesin large organizations. We solve common problems in distributed systems, soyou can focus on your business logic.

• Website:gokit.io
• Mailing list:go-kit
• Slack:gophers.slack.com#go-kit (invite)

Go has emerged as the language of the server, but it remains underrepresentedin large, consumer-focused tech companies like Facebook, Twitter, Netflix, andSoundCloud. These organizations have largely adopted JVM-based stacks fortheir business logic, owing in large part to libraries and ecosystems thatdirectly support their microservice architectures.

To reach its next level of success, Go needs more than simple primitives andidioms. It needs a comprehensive toolkit, for coherent distributed programmingin the large. Go kit is a set of packages and best practices, which provide acomprehensive, robust, and trustable way of building microservices fororganizations of any size.

For more details, seethe website,the motivating blog post andthe video of the talk.See also theGo kit talk at GopherCon 2015.

• Operate in a heterogeneous SOA — expect to interact with mostly non-Go-kit services
• RPC as the primary messaging pattern
• Pluggable serialization and transport — not just JSON over HTTP
• Operate within existing infrastructures — no mandates for specific tools or technologies

• Supporting messaging patterns other than RPC (for now) — e.g. MPI, pub/sub, CQRS, etc.
• Re-implementing functionality that can be provided by adapting existing software
• Having opinions on operational concerns: deployment, configuration, process supervision, orchestration, etc.

Please seeCONTRIBUTING.md.Thank you,contributors!

Go kit is a library, designed to be imported into a binary package.Vendoring is currently the best way for binary package authorsto ensure reliable, reproducible builds.Therefore, we strongly recommend our users use vendoring for all of their dependencies,including Go kit.To avoid compatibility and availability issues,Go kit doesn't vendor its own dependencies,and doesn't recommend use of third-party import proxies.

There are several tools which make vendoring easier, includinggb,glide,gvt,govendor, andvendetta.In addition, Go kit uses a variety of continuous integration providersto find and fix compatibility problems as soon as they occur.

Projects with a ★ have had particular influence on Go kit's design (or vice-versa).

• gizmo, a microservice toolkit from The New York Times ★
• go-micro, a microservices client/server library ★
• gotalk, async peer communication protocol & library
• Kite, a micro-service framework
• gocircuit, dynamic cloud orchestration

• afex/hystrix-go, client-side latency and fault tolerance library
• armon/go-metrics, library for exporting performance and runtime metrics to external metrics systems
• codahale/lunk, structured logging in the style of Google's Dapper or Twitter's Zipkin
• eapache/go-resiliency, resiliency patterns
• sasbury/logging, a tagged style of logging
• grpc/grpc-go, HTTP/2 based RPC
• inconshreveable/log15, simple, powerful logging for Go ★
• mailgun/vulcand, programmatic load balancer backed by etcd
• mattheath/phosphor, distributed system tracing
• pivotal-golang/lager, an opinionated logging library
• rubyist/circuitbreaker, circuit breaker library
• Sirupsen/logrus, structured, pluggable logging for Go ★
• sourcegraph/appdash, application tracing system based on Google's Dapper
• spacemonkeygo/monitor, data collection, monitoring, instrumentation, and Zipkin client library
• streadway/handy, net/http handler filters
• vitess/rpcplus, package rpc + context.Context
• gdamore/mangos, nanomsg implementation in pure Go

• Gorilla
• Gin
• Negroni
• Goji
• Martini
• Beego
• Revel (consideredharmful)

• Architecting for the Cloud — Netflix
• Dapper, a Large-Scale Distributed Systems Tracing Infrastructure — Google
• Your Server as a Function (PDF) — Twitter

Development supported byDigitalOcean.