gifinator

fork of https://github.com/GoogleCloudPlatform/gifinator to run locally and use minio for storage instead of gcs. look at TODO.md for what's left to be done. look at ARCHITECTURE.md for how the code is structured.

running (for development)

the following should be run in the order they are listed and each one in a different terminal

docker

this is the least painful way to develop but still sub-optimal

configure name resolution

add the following in /etc/hosts

127.0.0.1   minio
127.0.1.1   minio

build local docker image

run docker build -t giftest . and replace the value of IMG in the rundocker.sh script with giftest

start containers

run scripts/rundocker.sh from the root of the repo to start all the required containers

create bucket and load assets

go to http://localhost:9001 and log in using the credentials minioaccesskeyid and miniosecretaccesskey then create a bucket named gifbucket and load all the assets in gifcreator/scene to it

visit web frontend

access http://localhost:8090 using a web browser, fill in the text, select one of the 3 options, click Create and wait

stop all containers

run scripts/stopdocker.sh

manually

this is kind of a pain and there are plans to improve it

redis (port 6379) and minio (port 9000)

from the root of the repo, run scripts/rundeps.sh

render (port 8080)

this one is pretty simple, use go run render.go

gifcreator (worker port 8081, server port 8082)

go into its directory and run ../scripts/rungifcreator.sh

frontend (port 8090)

also pretty simple, from inside its directory run ../scripts/runfront.sh

create bucket and load assets

go to http://localhost:9001 and log in using the credentials minioaccesskeyid and miniosecretaccesskey then create a bucket named gifbucket and load all the assets in gifcreator/scene to it

visit web page

access http://localhost:8090 using a web browser, fill in the text, select one of the 3 options, click Create and wait

running (for production)

there are kubernetes manifests for it in here in my infra repository

documentation

env vars for each service are listed below

redis

see official docs

minio

see official docs

render

Variable	Description	Default Value
RENDER_PORT	port the service will run at	8080
MINIO_NAME	minio server domain name	localhost
MINIO_PORT	minio server port number	9000
MINIO_BUCKET	minio bucket to be used	gifbucket
MINIO_KEY	minio access key	minioaccesskeyid
MINIO_SECRET	minio secret key	miniosecretaccesskey

gifcreator (server mode)

Variable	Description	Default Value
GIFCREATOR_PORT	port the service will run at	8082
SCENE_PATH	path to find files for gif creation	/scene
RENDER_NAME	renderer domain name	localhost
RENDER_PORT	renderer port number	8080
REDIS_NAME	redis server domain name	localhost
REDIS_PORT	redis server port number	6379
MINIO_NAME	minio server domain name	localhost
MINIO_PORT	minio server port number	9000
MINIO_BUCKET	minio bucket to be used	gifbucket
MINIO_KEY	minio access key	minioaccesskeyid
MINIO_SECRET	minio secret key	miniosecretaccesskey

gifcreator (worker mode)

Variable	Description	Default Value
GIFCREATOR_PORT	port the service will run at	8081
SCENE_PATH	path to find files for gif creation	/tmp/scene
RENDER_NAME	renderer domain name	localhost
RENDER_PORT	renderer port number	8080
REDIS_NAME	redis server domain name	localhost
REDIS_PORT	redis server port number	6379
MINIO_NAME	minio server domain name	localhost
MINIO_PORT	minio server port number	9000
MINIO_BUCKET	minio bucket to be used	gifbucket
MINIO_KEY	minio access key	minioaccesskeyid
MINIO_SECRET	minio secret key	miniosecretaccesskey

frontend

Variable	Description	Default Value
FRONTEND_PORT	port the service will run at	8090
FRONTEND_TEMPLATES_DIR	directory for html templates	/templates
GIFCREATOR_NAME	gifcreator server domain name	localhost
GIFCREATOR_PORT	gifcreator server port number	8082

legal stuff

the original is here and its license and legal stuff apply, I'm not trying to steal anything