YourBase, the development platform for growing teams

YourBase is a fully automated delivery platform that enforces microservice best-practices. Our main goals:

• Be very easy to get started.
• Scale from small teams to large ones and perhaps help build the next Google or Facebook ;-).
• Enforce uniformity between apps of the same type. (e.g: "Go REST API Server" or "Java Spring REST API Server") to simplify operations and debugging.

See Getting Started and the User Guide for details.

Roadmap

Phase 1 (In Progress)

• CI: build and tests code on demand.
• CD: continuous deployment pipeline that releases and deploys code to different stages.
• Logging: collection, aggregation, searching and visualization.
• Monitoring: metrics and alerting with support for external integrations.
• Configuration uniformity for each type of application (e.g: different instances of Java Sprint REST API Server should have nearly identical setup.

Phase 2

• Tracing: correlation of events based on request traces.
• Enforcement of best-practices:
  • Prevent connections to un-managed resources.
  • Check for sane distributed system practices: request retry logic; circuit breakers; health-checking.
  • Setup loadtest with one command, and optionally require loadtests before rollout.

Community

Join the community slack.

Getting Started

First, install Bazel (requires Java, for now):

$ brew install bazel

Build the HTTP server:

$ bazel build examples/hellohttp/server:server

Run it locally:

$ bazel-bin/examples/hellohttp/server/server

Now run the HTTP client.

You can use the bazel run command for that. We can not do multiple bazel operations at once, that's why we cannot do bazel run for the server and the client at the same time.

You can pass arguments to the target program by putting them after a -- otherwise the arguments are interpreted as arguments to bazel.

$ bazel run //examples/hellohttp/client:client http://localhost:8080/
(20:20:49) INFO: Current date is 2018-01-11
(20:20:49) INFO: Analysed target //examples/hellohttp/client:client (0 packages loaded).
(20:20:49) INFO: Found 1 target...
Target //examples/hellohttp/client:client up-to-date:
  bazel-bin/examples/hellohttp/client/darwin_amd64_stripped/client
(20:20:50) INFO: Elapsed time: 0.893s, Critical Path: 0.02s
(20:20:50) INFO: Build completed successfully, 1 total action

(20:20:50) INFO: Running command line: bazel-bin/examples/hellohttp/client/darwin_amd64_stripped/client http://localhost:8080/
fetching http://localhost:8080/
Hello, World

The last line saying Hello, World is what we wanted. Great!

Troubleshooting

• Repos in the Go code and shell scripts are cloned using https not ssh. Make sure your personal token is setup through the command line. This token is required if you are using 2FA on github with https. See Setting up 2FA through command line.

Uniformity tests

The example server above is a go_http_server so we automatically enable uniformity tests for it. You can run them like this:

$ bazel test --test_output=all $(bazel query //examples/hellohttp/server/...|grep uniformity_test)
INFO: From Testing //examples/hellohttp/server:go-hellohttp_uniformity_test
==================== Test output for //examples/hellohttp/server:go-hellohttp_uniformity_test:
Found framework of type GoApp
Fetching http://localhost:8080/
PASS
================================================================================
//examples/hellohttp/server:go-hellohttp_uniformity_test        (cached) PASSED in 2.2s

Deploy Remotely

For Remote deployment we are using GCP, for now.

Install the Google Cloud SDK

Install kubectl

Now check that you have a working kubectl with access to a kubernetes cluster:

$ kubectl cluster-info

Note: To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

Configure kubectl cli access

gcloud container clusters get-credentials cluster-2 --zone us-central1-a --project deft-cove-184100

Create a namespace for your $USER:

$ kubectl create namespace $USER

Now, deploy the examples/hellohttp/server to kubernetes.

We'll deploy our service with a single bazel run command. This will create a new service on a namespace based on your current $USER.

$ bazel run --experimental_platforms=@io_bazel_rules_go//go/toolchain:linux_amd64  //examples/hellohttp/server:go-hellohttp_deploy.apply

(The --experimental_platform is necessary if you're using bazel on OSX because this command is generating docker container images for Linux, so we must use a cross-platform build.)

If everything works, after a few seconds you'll see the "EXTERNAL-IP" of your service here:

$ kubectl -n $USER get services
NAME               TYPE           CLUSTER-IP     EXTERNAL-IP       PORT(S)        AGE
go-hellohttp-svc   LoadBalancer   10.11.250.21   35.193.2.142      80:31399/TCP   42m

$ curl "http://$(kubectl get svc -n $USER go-hellohttp-svc -o jsonpath="{.status.loadBalancer.ingress[*].ip}")/"
Hello, World

Troubleshooting

The deployment may not work in some cases despite the bazel run command succeeding because part of the work is done asynchronously. A few things to try:

• kubectl -n $USER describe svc
• kubectl -n $USER describe deploy
• kubectl -n $USER describe pod

Later

• CI
• Deployment
• Monitoring, etc

See Also

• User Guide
• Blog Post: Building a Fast Track for Software Development