Prow: Streamlined Kubernetes Development

NOTE: Prow is experimental and does not have a stable release yet.

Prow is a tool for developers to create cloud-native applications on Kubernetes.

Usage

NOTE: These instructions are temporary until there is an official binary release.

Here's an example of installing Prow and creating an application:

$ go version
go version go1.7 linux/amd64
$ # install prowd
$ helm init
$ export IMAGE_PREFIX=bacongobbler
$ make info
Build tag:       git-abc1234
Registry:        quay.io
Immutable tag:   quay.io/bacongobbler/prowd:git-abc1234
Mutable tag:     quay.io/bacongobbler/prowd:canary
$ make bootstrap docker-build docker-push
$ cat chart/values.yaml | grep 'registry\|name'
  registry: quay.io
  name: deis/prowd
$ helm install ./chart --namespace prow --set image.name=${IMAGE_PREFIX}/prowd
$ make build && export PATH=$PWD/bin:$PATH
$ cd tests/testdata/example-dockerfile-http
$ prow up
--> Building Dockerfile
--> Pushing 127.0.0.1:5000/example-dockerfile-http:fc8c34ba4349ce3771e728b15ead2bb4c81cb9fd
--> Deploying to Kubernetes
    Release "example-dockerfile-http" does not exist. Installing it now.
--> code:DEPLOYED
$ helm list
NAME                      REVISION   UPDATED                     STATUS      CHART
example-dockerfile-http   1          Tue Jan 24 15:04:27 2017    DEPLOYED    example-dockerfile-http-1.0.0
$ kubectl get po
NAME                                       READY     STATUS             RESTARTS   AGE
example-dockerfile-http-3666132817-m2pkr   1/1       Running            0          30s

NOTE: CLI usage will look like this when it is completed.

Start from a source code repository and let Prow create the Kubernetes packaging:

$ cd my-app
$ ls
app.py
$ prow create --pack=python
--> Created ./charts/my-app
--> Created ./charts/my-app/Dockerfile
--> Ready to sail

Now start it up!

$ prow up
--> Building Dockerfile
--> Pushing my-app:latest
--> Deploying to Kubernetes
--> code:DEPLOYED

That's it! You're now running your Python app in a Kubernetes cluster.

Behind the scenes, Prow handles the heavy lifting:

• Builds a container image from application source code
• Pushes the image to a registry
• Creates a Helm chart for the image
• Installs the chart to Kubernetes, deploying the application

After deploying, you can run prow up again to create new releases when application source code has changed. Or you can let Prow continuously rebuild your application.

Hacking on Prow

The easiest way to hack on Prow is to deploy changes... Using Prow. Check it out!

$ helm list
NAME                    REVISION        UPDATED                         STATUS          CHART
warped-nightingale      1               Wed Feb  8 10:29:19 2017        DEPLOYED        prowd-0.1.0
$ make build docker-binary
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o ./rootfs/bin/prowd -a -installsuffix cgo -tags '' -ldflags ' -X github.com/deis/prow/pkg/version.Version= -X github.com/deis/prow/pkg/version.GitCommit=d46a18200576d6ba3007ed26efb647ffd86303ba -X github.com/deis/prow/pkg/version.GitTreeState=clean' github.com/deis/prow/cmd/prowd
$ ./bin/prow up --app warped-nightingale
--> Building Dockerfile
--> Pushing 127.0.0.1:5000/warped-nightingale:6f3b53003dcbf43821aea43208fc51455674d00e
--> Deploying to Kubernetes
--> code:DEPLOYED

Features

• Prow is language-agnostic
• Prow works with any Kubernetes cluster that supports Helm
• Charts that Prow creates can be edited to suit your needs
• Charts can be packaged for delivery to your ops team