Example - Deploy demochat to Kubernetes cluster

An end-to-end example for Kubernetes deployment

In this example we will deploy our demochat application to Kubernetes. demochat requires two services to run:

  1. MongoDB
  2. demochat webserver that is implemented in Node and can be found at https://github.com/containers101/demochat

We will perfom the following steps:

  1. Build the Docker image for demochat
  2. Deploy the demochat service to a Kubernetes cluster
  3. Access the running demochat service
  4. Automate demochat deployment using a Codefresh pipeline
Demochat source code

The Demochat repository can be found and forked from here:

Building the Docker image for Demochat

Become familiar with basic Codefresh pipelines as explained in the quick start guide and then:

  1. Add your forked demochat repo in Codefresh (use the url above to find the repo).
  2. Choose the branch for your first build (in this case master).
  3. Select how you would like to setup your repository. In this case, our repo already has a Dockerfile, so we will select the middle option.
  4. Clicking on Build button will trigger a regular build.
  5. When the docker image will be created, go to the tab Images to find the image containers101/demochat

More info about how to add, build and push docker image you can find in the readme of repository https://github.com/containers101/demochat

Deploying the Demochat service to a Kubernetes cluster

  1. Go to your Account Configuration, by clicking on Account Settings on the left sidebar. On the first section called Integrations click the Configure button next to Kubernetes.
  1. Add your Kubernetes cluster.

Codefresh integrations

  1. Exit your account settings and then select Kubernetes from the left sidebar to access your Kubernetes dashboard. Click on the button Add New Service.
  1. The demochat application uses a Mongo database, therefore we need to add a mongo service with the following params (see the screenshot below).

Deploy mongo service

Deploy mongo service
  1. Then just click on the button Deploy.
  1. The mongo service will appear on your Kubernetes dashboard.
  1. Click on the button Add New Service to create a Demochat service.
  1. Use the screenshot below to specify the parameters of Demochat service.
Parameter Value
CLUSTER choose one of your clusters
NAMESPACE choose the namespace in the dropdown list
IMAGE containers101/demochat

Configure mongo service

Configure mongo service

Accessing the Demochat service

On the Kubernetes tab you can see the demochat and mongo services.

Kubernetes Services

Kubernetes Services

The Demochat application is now successfully deployed! You can see the external endpoints of this service in the service view and access the application using its endpoint and port.


Click on the external endpoint and your browser window will open to show the running application.


Automating Demochat deployment using Codefresh pipelines

For automated Kubernetes deployments check the documentation for

  1. The dedicated deploy step in a pipeline.
  2. The cf-deploy-kubernetes step in a pipeline. This can also perform simple templating on Kubernetes manifests.
  3. Using a freestyle step with custom kubectl commands.
  4. Using The Helm package manager. See the Helm quick start guide.