addsvc

command
v0.0.0-...-6aeb139 Latest Latest
Warning

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

Go to latest
Published: Aug 28, 2015 License: MIT Imports: 31 Imported by: 0

README

addsvc

addsvc is an example service, used to illustrate the mechanics of Go kit. It exposes a single method to add two integers on a variety of transports and endpoints.

Highlights

Configuration via flags

Go kit has no strong opinions about how to pass configuration to your service. If your organization has established conventions to pass configuration into your service, Go kit won't stand in your way. That said, package flag is a good default: it's simple, well-understood, and provides a self-documenting configuration surface area. Keeping with best practices, flags are defined in func main.

Declarative composition

Go kit strongly favors explicit, declarative composition of interacting components via a comprehensive func main. Time spent in keystrokes is made up many, many times over when returning to the code and understanding exactly what's happening, without having to unravel indirections or abstractions.

Multiple transports

Go kit treats transports — HTTP, Thrift, gRPC, etc. — as pluggable. The same service can be exposed on any, or multiple, available transports. The addsvc example demonstrates how to make the same business logic available over multiple transports simultaneously.

Daemonizing

Go kit has no strong opinions about how to daemonize, supervise, or run your service. If your organization has established conventions for running services. Go kit won't stand in your way. Go kit services run equally well as manually-copied binaries; applications provisioned with configuration management tools like Chef, Puppet, or Ansible; in containers like Docker or rkt; or as part of a comprehensive scheduling platform like Kubernetes, Mesos, OpenStack, Deis, etc.

Server

To build and run addsvc,

go install
addsvc

Client

addsvc comes with an example client, addcli.

$ cd client/addcli
$ go install
$ addcli

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
_thrift
client
Package pb is a generated protocol buffer package.
Package pb is a generated protocol buffer package.

Jump to

Keyboard shortcuts

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