Skip to content

RonaldGalea/gg

 
 

Repository files navigation

gg Build Status

xkcd.com/303/

Research Paper

"From Laptop to Lambda: Outsourcing Everyday Jobs to Thousands of Transient Functional Containers," in 2019 USENIX Annual Technical Conference (USENIX ATC '19).

Demo

Building FFmpeg with gg on AWS Lambda

asciicast

Tech Video

gg was presented at 2019 USENIX Annual Technical Conference (USENIX ATC '19). The talk was given on July 11, 2019.

Alt text

Build directions

Notice: If you are Docker adept, follow this instruction.

To build gg you need the following packages:

  • gcc >= 7.0
  • protobuf-compiler, libprotobuf-dev >= 3.0
  • libcrypto++-dev >= 5.6.3
  • python3
  • libcap-dev
  • libncurses5-dev
  • libboost-dev
  • libssl-dev
  • autopoint
  • help2man
  • texinfo
  • automake
  • libtool
  • pkg-config
  • libhiredis-dev
  • python3-boto3

You can install these dependencies in Ubuntu (17.04 or newer) by running:

sudo apt-get install gcc-7 g++-7 protobuf-compiler libprotobuf-dev \
                     libcrypto++-dev libcap-dev \
                     libncurses5-dev libboost-dev libssl-dev autopoint help2man \
                     libhiredis-dev texinfo automake libtool pkg-config python3-boto3

To build gg, run the following commands:

./fetch-submodules.sh
./autogen.sh
./configure
make -j$(nproc)
sudo make install

Usage

Environment Variables

To use gg, the following environment variables must be set:

  • GG_MODELPATH => absolute path to <gg-source-dir>/src/models/wrappers.
  • GG_STORAGE_URI =>
    • S3: s3://<bucket-name>/?region=<bucket-region>
    • Redis: redis://<username>:<password>@<host>[:<port>]
  • GG_LAMBDA_ROLE => the role that will be assigned to the executed Lambda. functions. Must have AmazonS3FullAccess and AWSLambdaBasicExecutionRole permissions.
  • AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY => your AWS access key
  • AWS_REGION => your AWS region, where the functions are installed

Installing the Functions

After setting the environment variables, you need to install gg functions on AWS Lambda. To do so:

cd src/remote/
make ggfunctions

Example

To build mosh using gg, first we checkout the mosh source code:

git clone https://github.com/mobile-shell/mosh

Make sure that you have all the dependencies for building mosh. In Ubuntu, you can run:

sudo apt-get install -y automake libtool g++ protobuf-compiler libprotobuf-dev \
                        libboost-dev libutempter-dev libncurses5-dev \
                        zlib1g-dev libio-pty-perl libssl-dev pkg-config

Inside the mosh directory, first you need to prepare mosh to build:

./autogen.sh
./configure

Then,

gg init # creates .gg directory
gg infer make -j$(nproc) # creates the thunks

Now, to actually compile mosh-server on AWS Lambda with 100-way parallelism, you can execute (it's important that --jobs comes before --engine):

gg force --jobs 100 --engine lambda src/frontend/mosh-server

About

The Stanford Builder

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 86.5%
  • Python 7.3%
  • Shell 2.0%
  • M4 2.0%
  • Makefile 1.9%
  • Dockerfile 0.2%
  • Perl 0.1%