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:
https://github.com/containers101/demochat

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
SERVICE NAME Demochat
REPLICAS 1
EXPOSE PORT 5000
IMAGE containers101/demochat
INTERNAL PORTS 5000

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.

codefresh_external_endpoints.png

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

codefresh_demochat_endpoint.png

Automating Demochat deployment using Codefresh pipelines

To configure the Deploy Script in the pipeline you just need to go to the tab Repositories and click on the button Pipelines of the demochat service.

codefresh_demochat_repo.png

On the next screen, you need to enable the Push to Docker registry. First integrate with the docker registry that you use for images on the Integration page and then select this docker registry in the dropdown list of the push step. This image will be used in the Deploy script.

codefresh_push_step.pnadd-g

In the next step, you need to configure the Deploy Script:

  1. Choose the option Kubernetes.
  1. Choose the cluster on which will be deployed the service.
  1. Choose the namespace.
  1. Select the service that will be redeployed.
  1. Select the branch as condition when the Deploy Script will be performed.

codefresh_deploy_script.png

Save and Build the pipeline.

codefresh_deploy_script_process.png