Skip to content
ALPHA: Scheduler plugin for deploying applications to kubernetes
Branch: master
Clone or download
Latest commit 5229433 Aug 8, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
subcommands feat: add scheduler-kubernetes:rolling-update command Jul 3, 2019
templates fix: ensure namespaces are created when in use Jun 13, 2019
.gitignore Initial commit Apr 10, 2019 feat: support liveness and readiness healthchecks Aug 7, 2019
commands chore: shfmt May 28, 2019
dependencies chore: shfmt May 28, 2019
install feat: silence curl and add logging Jul 1, 2019
internal-functions chore: add a title to the rolling restart Jul 3, 2019
plugin.toml Release 0.3.0 Aug 8, 2019
post-create chore: shfmt May 28, 2019
report chore: shfmt May 28, 2019
scheduler-app-status fix: ensure namespace creation is quiet for certain calls Jun 21, 2019
scheduler-deploy feat: support liveness and readiness healthchecks Aug 7, 2019
scheduler-is-deployed revert: switch back to kubedog for status tracking Jul 1, 2019
scheduler-logs revert: switch back to kubedog for status tracking Jul 1, 2019
scheduler-logs-failed chore: shfmt May 28, 2019
scheduler-post-delete revert: switch back to kubedog for status tracking Jul 1, 2019
scheduler-run chore: shfmt May 28, 2019
scheduler-tags-create chore: shfmt May 28, 2019
scheduler-tags-destroy chore: shfmt May 28, 2019


A Dokku plugin to integrate with kubernetes.


  • The dokku-registry plugin should be installed and configured for your application
  • A configured kubectl (/home/dokku/.kube/config) that can talk to your cluster


You can install this plugin by issuing the command:

dokku plugin:install

After the plugin has successfully been installed you need to install the plugin's dependencies by running the command:

dokku plugin:install-dependencies


Set the scheduler to kubernetes. This can be done per-app or globally:

# globally
dokku config:set --global DOKKU_SCHEDULER=kubernetes

# per-app
dokku config:set APP DOKKU_SCHEDULER=kubernetes

You also need to ensure your kubectl has the correct context specified:

kubectl config use-context YOUR_NAME

And configure your registry:

dokku registry:set APP server

Assuming your Dokku installation can push to the registry and your kubeconfig is valid, Dokku will deploy the application against the cluster.

The namespace in use for a particular app can be customized using the scheduler-kubernetes:set command. This will apply to all future invocations of the plugin, and will not modify any existing resources. The scheduler-kubernetes will create the namespace via a kubectl apply.

dokku scheduler-kubernetes:set APP namespace test

If deploying from a private docker registry and the cluster needs does not have open access to the registry, an imagePullSecrets value can be specified. This will be injected into the kubernetes deployment spec at deploy time.

dokku scheduler-kubernetes:set APP imagePullSecrets registry-credential

See this doc for more details on creating an imagePullSecrets secret file.

For deployments that use a rollingUpdate for rollouts, a rollingUpdate may be triggered at a later date via the scheduler-kubernetes:rolling-update command.

dokku scheduler-kubernetes:rolling-update APP

Health checks for the app may be configured in app.json, based on Kubernetes liveness and readiness probes. All Kubernetes options that can occur within a Probe object are supported, though syntax is JSON rather than YAML. The variable $APP may be used to represent the app name.

If a process type is not configured for a given probe type (liveness or readiness), any probe of the same type for the "*" default process type is used instead.

Here (click the triangle to expand) is an example JSON for Kubernetes health checks.

	"healthchecks": {
		"web": {
			"readiness": {
				"httpGet": {
					"path": "/{{ $APP }}/readiness_check",
					"port": 5000
				"initialDelaySeconds": 5,
				"periodSeconds": 5
		"*": {
			"liveness": {
				"exec": {
					"command": ["/bin/pidof", "/start"]
				"initialDelaySeconds": 5,
				"periodSeconds": 5
			"readiness": {
				"httpGet": {
					"path": "web processes override this.",
					"port": 5000
				"initialDelaySeconds": 5,
				"periodSeconds": 5


  • Dockerfile deploys are not currently supported.
  • Each Procfile entry will be turned into a kubernetes Deployment object.
  • The web process will also create a Service object.
  • All created Kubernetes objects are tracked to completion via kubedog.
  • Templates for Deployment and Service objects are hardcoded in the plugin.
  • Environment variables are set plaintext in the deployment object.
  • Resource limits and requests are supported from the resource plugin (Kubernetes requests are Dokku reservations).
  • The Dokku commands run, enter, and logs:failed are not supported.
  • A custom nginx configuration - or a different proxy plugin implementation - will be needed in order to talk to the Kubernetes Service upstream.
  • Custom docker-options are not supported.
You can’t perform that action at this time.