Example Go (golang) web app with dependency injection and graceful shutdown. Acts like a mini Twitter clone.
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
Build a local binary:
make
Build a docker image:
# make the build image first
make build-image
make image
There are several ways to launch the Tweeter server.
Run from local source code:
go run main.go
(ctrl-c to quit)
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
Run in Marathon:
curl -H 'Content-Type: application/json' -X POST -d @"marathon.json" ${MARATHON_URL}/v2/apps
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.
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.
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.