Welcome to Starter

Starter is an open-source command line tool to generate a Dockerfile and a service.yml file from arbitrary source code. The service.yml file is a Cloud 66 service definition file which is used to define the service configuration on a stack.

Welcome to Starter

Starter works in the same way as BuildPacks do, but only generates the above mentioned files; the image compile step happens on BuildGrid. Starter does not require any additional third party tools or frameworks to work (it’s compiled as a Go executable).

Starter supports Procfiles and generates a service in service.yml for each item in the Procfile. It’s highly advised to use a Procfile to define your own service commands, as otherwise, Starter will only detect the web service.

To use Starter on a different folder, you can use the p option:

$ starter -p /my/project

For more options, please see:

$ starter help

Starter can generate a Dockerfile , docker-compose.yml and a Cloud 66 specific service.yml for you:

Dockerfile — a Docker specification text document that contains all the commands a user could call on the command line to assemble an image (more compatible with development environments)

docker-compose.yml — a Docker specification file for making it easy to run your Dockerized application on your machine and mimic the Docker infrastructure. Of course without all the extra ops stuff you need thanks to running Docker in production with Cloud 66 (more compatible with development environments)

service.yml — a Cloud 66 service definition file, which is used to define the service configurations on a stack (more compatible with production environments).

Deploying your app to your servers

Once you have the docker-compose.yml and Dockerfile generated, you can open them up in your favourite text editor for inspection or modifications:

$ atom Dockerfile
$ atom docker-compose.yml

The docker-compose.yml file is a good start to run your containerized application in production. Depending on your target platform, you need to adjust the settings or translate the docker-compose.yml in a specific service configuration for your target platform.

Deploy on Cloud 66

Once done, you can now use these files to build and deploy your application on Cloud 66 (you’ll need a free Cloud 66 account for this).