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

Deploy a combination of a Kubernetes deployments and services into a designated Kubernetes cluster and namespace.
View logs, revert deployments and get back to any point in time with just one click.
Manage multiple Kubernetes clusters and multiple namespaces in the same cluster.
Full permissions model for deployments. Each user can deploy only what he needs to deploy.
Live querying on Kubernetes to get the current status of the deployments. You can also view pods status, view logs from each pod, and restart each pod.
Full RESTful API and Java client to automate whatever you need, or deploy automatically.
Once initially deployed, you can deploy future versions of Apollo, using Apollo!

Deployment

Getting logs of a running pod

Exec into a running pod

See ongoing deployments

Get full deployment history

Set up deployment 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.

meidea/apollo