paralin/deploy-kubernetes

Base docker image to deploy an app into Kubernetes using azk

Initial Considerations

This is heavily experimental. Not sure if I will complete it.

Versions (tags)

Image content:

• Ubuntu 14.04 (v0.0.1) or Alpine Linux (v0.0.2 or later)
• kubelet

Configuration

The following environment variables are available for configuring the deployment using this image:

• KUBE_NAMESPACE (optional, default: active context namespace): Namespace to deploy into.
• LOCAL_PROJECT_PATH (optional, default: /azk/deploy/src): Project source code path;
• LOCAL_KUBECONFIG_PATH(optional, default: /azk/deploy/.kube/config): Path to kubeconfig.
• KUBE_CONTEXT (optional, default: default): Kube context to use from the kubeconfig file. Uses the active context on default.

Usage

Consider you want to deploy your app into a remote Kubernetes cluster and your local kubeconfig is placed at $HOME/.kube/config (the default).

Usage with azk

Example of using this image with azk:

• Add the deploy system to your Azkfile.js:

/**
 * Documentation: http://docs.azk.io/Azkfile.js
 */

// Adds the systems that shape your system
systems({
  // ...

  deploy: {
    image: {"docker": "paralin/deploy-kubernetes"},
    mounts: {
      "/azk/deploy/src":     path("."),
      "/azk/deploy/.kube":    path("#{env.HOME}/.kube"),
    },
    scalable: {"default": 0, "limit": 0},
  },
});

/**
 * Documentation: http://docs.azk.io/Azkfile.js
 */

// Adds the systems that shape your system
systems({
  example: {
    // ...
    http: {
      domains: [
        // ...
        "#{env.HOST_DOMAIN}",
        "#{env.HOST_IP}"
      ]
    },
  },

  // ...
});

• Run:

$ azk deploy

Usage with docker

To create the image paralin/deploy-kubernetes, execute the following command on the deploy-kubernetes image folder:

$ docker build -t paralin/deploy-kubernetes latest

To run the image:

$ docker run --rm --name deploy-kubernetes-run \
  -v $(pwd):/azk/deploy/src \
  -v $HOME/.kube:/azk/deploy/.kube \
  paralin/deploy-kubernetes

License

My Dockerfiles distributed under the Apache License.