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

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

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.

2. Add your Kubernetes cluster.

3. Exit your account settings and then select Kubernetes from the left sidebar to access your Kubernetes dashboard. Click on the button Add New Service.

4. The demochat application uses a Mongo database, therefore we need to add a mongo service with the following params (see the screenshot below).

5. Then just click on the button Deploy.

6. The mongo service will appear on your Kubernetes dashboard.

7. Click on the button Add New Service to create a Demochat service.

8. 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

Accessing the Demochat service

On the Kubernetes tab you can see the demochat and mongo 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.

What to read next

• Deploy to Kubernetes - quick start
• Deploying to Kubernetes with Helm
• Manage your Kubernetes cluster