Build Status

Apollo

What is Apollo?

Apollo is a simple, lightweight, Continuous Deployment (CD) solution on top of Kubernetes. Apollo can integrate with any existing building process you might have in place. All you need to do is notify it of a ready artifact, and that's it.

Apollo also provides restricted access on top of Kubernetes. Each user has fine-grained permissions, to ensure safe deployments.

Please refer to the Wiki for more extensive documentation.

Main Features

Deployment

Apollo Deployment

Getting logs of a running pod

Apollo Logs

Exec into a running pod

Apollo Shell

See ongoing deployments

Apollo Ongoing Deployments

Get full deployment history

Apollo Deployments History

Set up deployment blockers

Apollo Deployments Blockers

Run it

Apollo requires a HOCON format configuration file to get all of its resources. Configurations can be supplied as a Filesystem path or as a Consul Key.

Configuration example:

apollo {
  db {  # Self explanatory
    port = 3306
    host = "..."
    user = "apollo"
    password = "..."
    schema = "apollo"
  }

  api {
    listen = "0.0.0.0"  # Where should apollo backend listen
    port = 8081  # And on which port
    secret = "SuperTestingSecret"  # Secret to encrypt websessions with
  }

  kubernetes {
    monitoringFrequencySeconds = 5  # How frequent should the apollo's kubernetes monitoring thread check the deployment statuses
  }

  scm {
    githubLogin = ""  # Github user (in case you need private repositories access)
    githubOauthToken = ""  # Access token created in your user settings. Should have view access for private repos
  }
}

Under examples you can find a simple Docker Compose to help you set it up locally

cd examples/
docker-compose up -d

Contributing

Fork away, commit, and send a pull request.