Repository files navigation

Vili is an open source dashboard for managing deployments to aKubernetes cluster. It is built to:

• Manage both manual and continuous deployments
• Gate production deployments through our QA process
• Provide transparency into the current state of our infrastructure

Vili is opinionated, to be able to set it up you need to:

• use GitHub for version control
• build Docker images to ship code and tag them with the Git SHA and branch they were built from
• push these Docker images to a Docker registry
• use Kubernetes namespaces to manage environments
• use Kubernetes deployments to deploy applications
• use Slack for team messaging

Vili is a brother of Odin in Norse mythology, and he gives intelligence to the first humans.

To setup Vili on your Kubernetes cluster, follow these steps:

1. Select a domain name to host Vili under, such as vili.mydomain.com. Create anOkta app with a redirect URL that points to vili.mydomain.com/login/callback. Write down the Okta metadata url.
2. CreateDocker repositories for your applications. You may use any standard Docker registry, includingDocker Hub,quay.io, or a self-hosted registry.Amazon ECR registries are also supported.
3. Create a newFirebase app. Set the "Firebase rules" to matchthis. Write down the Firebase app's URL and secret.
4. Create a GitHub repo with a directory that holds your replication controller templates, pod templates, and environment variables following thisexample. Also create a GitHub access token following instructionshere. Write down your GitHub organization or user name, the path to the directory created above and the authentication token.
5. Create a Slackbot integration. Write down the API token from the integration settings page.
6. Create asecret in your Kubernetes cluster that stores your GitHub, Docker, Firebase, and Slack credentials following thisexample. Populate the values in the secret using the Docker, GitHub, Firebase, and Slack information you wrote down in the previous steps. Don't forget to base64 encode them as required by Kubernetes!
7. Create a deployment in your Kubernetes cluster following thisexample. Populate the environment variables using the Okta, Docker, GitHub, Firebase, and Slack information you wrote down in the previous steps.
8. Create aservice for this replication controller, and allow external access to this service under the domain name you chose in step 1.
9. If you want to integrate a Continuous Integration service with Vili, you can do so by adding CI_PROVIDER config variable with value (name of the ci provider in small letters) and other required CI parameters to your config file.
10. Currently, we are supporting integration only with CircleCI. To integrate with Circle ci, you will need below 3 parameters:

  CI_PROVIDER="circleci"  CIRCLECI_TOKEN=XXXX  CIRCLECI_BASEURL="https://circleci.com/api/v1.1/"

You will also have to add a circle job name to your kubernetes namespace's annotations to run after successful deployment which can be used to run tests or any other post deployment tasks:

  vili.environment-webhook="circle_jobname"

You are all set! Vili will use the GitHub and Docker Registry APIs to discover your apps and help you deploy them.

1. Follow the examplesample_devenv.sh to create your own environment file with relevant configration.

2. Installredis

   > brew install redis

3. Startredis

   > brew services start redis

4. Install Vili frontend node modules

   > cd /path/to/<vili-root>> npm install

5. Build Vili frontend Webpack

   > npm run build

6. Run Vili

   > go run main.go

7. Direct your browser tohttps://localhost:4001. Voila!

Environment: A namespace in Kubernetes that runs an isolated set of apps and jobs.

App: A stateless application controlled by a deployment in Kubernetes, run continuously, and deployed with no downtime.

Job: A pod in Kubernetes that runs to completion.

Template: YAML configuration files for controllers and pods, using go templates syntax for variable population.

Approval: An indication by the QA team that a certain build is deployable to prod.