mesosphere/tweeter-go repository overview

Example Go (golang) web app with dependency injection and graceful shutdown. Acts like a mini Twitter clone.

⁠Dependencies

Building requires Go⁠, Godep⁠, Docker⁠, & Make.

Code dependencies are vendored with Godep:

• Facebook's Grace library⁠ - graceful shutdown
• Inject⁠ - dependency injection
• Humanize⁠ - readable units
• Logrus⁠ - structured, leveled logging

⁠Compilation

Build a local binary:

make

Build a docker image:

# make the build image first
make build-image
make image

⁠Operation

There are several ways to launch the Tweeter server.

⁠Source

Run from local source code:

go run main.go

(ctrl-c to quit)

⁠Docker

Run in Docker:

docker run -d --name tweeter -p 0.0.0.0:8080:8080 mesosphere/tweeter-go:latest

With Cassandra:

docker run -d --name cassandra cassandra:2.2.3
docker run -d --name tweeter --link cassandra:cassandra -p 0.0.0.0:8080:8080 mesosphere/tweeter-go:latest --cassandra-addr=cassandra

Find Tweeter IP:

docker inspect --format "{{.NetworkSettings.IPAddress}}" tweeter

⁠Marathon

Run in Marathon⁠:

curl -H 'Content-Type: application/json' -X POST -d @"marathon.json" ${MARATHON_URL}/v2/apps

⁠Kubernetes

Run in Kubernetes⁠:

kubectl create -f kubernetes.yaml

By default, kubernetes.yaml assumes you have 3 public slave nodes and want 1 Tweeter instance on each. With this configuration, Tweeter can be reached on the default HTTP port (80) through the public slave DNS URL. On AWS, the DNS should automatically handle round-robin for requests to Tweeter. Load Balancing could also be configured, using AWS Elastic Load Balancing.

⁠Usage

Visit the home page at http://localhost:8080/⁠

Enter handle & message & hit Tweet.

See past tweets on the right-hand side of the home page.

⁠License

Copyright 2015-2017 Mesosphere, Inc.

Licensed under the Apache License Version 2.0⁠ (the "License"); you may not use this project except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.