kit

module
v0.0.0-...-377bbca Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 19, 2015 License: MIT

README

Go kit Circle CI Drone.io Travis CI GoDoc

Go kit is a distributed programming toolkit for microservices in the modern enterprise. We want to make Go a viable choice for application (business-logic) software in large organizations.

Motivation

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

To reach its next level of success, Go needs more than simple primitives and idioms. It needs a comprehensive toolkit, for coherent distributed programming in the large. Go kit is a set of packages and best practices, leveraging years of production experience, and providing a comprehensive, robust, and trustable platform for organizations of any size.

In short, Go kit brings Go to the modern enterprise.

For more details, see the motivating blog post and the video of the talk. See also the Go kit talk at GopherCon 2015.

Goals

  • 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

Non-goals

  • Supporting messaging patterns other than RPC (in the initial release) — MPI, pub/sub, CQRS, etc.
  • Re-implementing functionality that can be provided by wrapping existing packages
  • Having opinions on deployment, orchestration, process supervision, etc.
  • Having opinions on configuration passing — flags, env vars, files, etc.

Component status

Dependency management

Users who import Go kit into their package main are responsible to organize and maintain all of their dependencies to ensure code compatibility and build reproducibility. Go kit makes no direct use of dependency management tools like Godep.

We will use a variety of continuous integration providers to find and fix compatibility problems as soon as they occur.

Contributing

Please see CONTRIBUTING.md. Thank you, contributors!

API stability policy

The Go kit project depends on code maintained by others. This includes the Go standard library and sub-repositories and other external libraries. The Go language and standard library provide stability guarantees, but the other external libraries typically do not. The API Stability RFC proposes a standard policy for package authors to advertise API stability. The Go kit project prefers to depend on code that abides the API stability policy.

Projects with a ★ have had particular influence on Go kit's design.

Service frameworks
  • go-micro, a microservices client/server library ★
  • gocircuit, dynamic cloud orchestration
  • gotalk, async peer communication protocol & library
  • Kite, a micro-service framework
Individual components
Web frameworks

Additional reading

Directories

Path Synopsis
pb
Package pb is a generated protocol buffer package.
Package pb is a generated protocol buffer package.
log
Package log provides basic interfaces for structured logging.
Package log provides basic interfaces for structured logging.
Package metrics provides an extensible framework to instrument your application.
Package metrics provides an extensible framework to instrument your application.
expvar
Package expvar implements an expvar backend for package metrics.
Package expvar implements an expvar backend for package metrics.
prometheus
Package prometheus implements a Prometheus backend for package metrics.
Package prometheus implements a Prometheus backend for package metrics.
statsd
Package statsd implements a statsd backend for package metrics.
Package statsd implements a statsd backend for package metrics.
teststat
Package teststat contains helper functions for statistical testing of metrics implementations.
Package teststat contains helper functions for statistical testing of metrics implementations.
tracing
transport

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL