Name: gifinator
Owner: Google Cloud Platform
Description: A sample application demonstrating Kubernetes, gRPC, Go and cute Gophers demoed at Google GCP Next 2017
Created: 2017-05-01 20:59:35.0
Updated: 2018-01-03 20:15:08.0
Pushed: 2017-05-22 03:46:31.0
Homepage: https://www.youtube.com/watch?v=YiNt4kUnnIM
Size: 1066
Language: Go
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
This is a demonstration of how to build an application using Go, gRPC and Kubernetes. The application - Gifinator - creates 3D animated gifs for no obvious purpose (except to show how these technologies can be used together).
This project is a compliment to a talk given at GCP Next 2017, for a demo and a walk-through of the application and the design choices we made, you can watch the session on YouTube.
This project currently assumes an import path of github.com/GoogleCloudPlatform/gifinator.
This project relies on Glide for dependency management and optionally Goreman (a clone of the popular Foreman tool, but written in Go) to make it easy to run the services locally for testing purposes.
clone ... $GOPATH/src/github.com/GoogleCloudPlatform/gifinator
https://glide.sh/get | sh
et github.com/mattn/goreman
You will also need to install the Google Cloud SDK to build and deploy to Kubernetes.
You will also need to have created a Google Cloud Storage bucket, for exclusive use by the application. If you plan to deploy to GKE, it is suggested to create your bucket in the same project.
To run and test locally, you will also need to have Redis installed and running.
GOPATH/src/github.com/GoogleCloudPlatform/gifinator
e install
If you need to rebuild the generated code for the protos, then install protoc
and run make proto.
Configure .env as appropriate. By default it assumes everything is running on
localhost, including Redis.
ud auth application-default login # first time only
rt $(cat .env | xargs)
&& goreman start
Ignore the port numbers, as they are specified in the .env file.
If you run into the gopkg.in issue, then run:
clone https://p3.gopkg.in/yaml.v2 $GOPATH/src/gopkg.in/yaml.v2
A single image contains all three binaries, along with assets for the web-server frontend.
ud container builds submit . --config=cloudbuild.yaml
This will build and push the image to gcr.io/YOUR_PROJECT_ID/gifcreator
First create a Kubernetes cluster and make sure kubectl is installed and configured
to talk to it.
Configure the files in the k8s directory as appropriate. Mainly this will mean
adjusting the value of the GOOGLE_PROJECT_ID and GCS_BUCKET_NAME to something
appropriate for your usage.
To deploy the three services, and Redis, to the cluster for the first time, run:
ctl create -f k8s