Setting up CI/CD for Docker Container Running in Kubernetes using VSTS

Artikel
05/29/2017

Context

In my last post, I covered how you can create a simple Web API, run the Web API in a Docker container and then deploy the container to a Kubernetes cluster provisioned using Azure Container Service (ACS) in Azure. You can find the full post here.

In this blog, I will cover how CI/CD can be implemented so that the sample Web API can be deployed automatically as soon as a change is made to the Web API code. To create the Web API code with Docker support, follow the section “Creating a simple web API with Docker Support using Visual Studio” in my last post here. This blog assumes you have a VSTS account setup and a Team Project created. You can create a VSTS account for free here. It also assumes that the sample API code is checked in to the Team Project version control.

Pre-requisites

Some tasks we will be using to set up CI/CD don’t come out of the box with VSTS. Instead, you will need to install them from the VSTS Marketplace. The following extensions need to be installed:

Docker Integration
Kubernetes extension

Setting up Continuous Integration

Login to the Team Project in VSTS where the code is checked-in
Tap Build and Release tab and then click on Builds
Click New definition button
Click on empty process link
Add Docker Compose task from the Docker integration extension installed from Marketplace. Set Docker Compose File field to docker-compose.ci.build.yml. Set Command field to up

Add another Docker Compose task from the Docker integration extension installed. Set Docker Compose File field to docker-compose.yml. Set Command field to build

Add Docker step from the Docker integration extension. For Docker Registry Connection field, click the plus sign (+) and you will be prompted to enter your Docker registry credentials. VSTS uses those credentials to push the generated Docker image. Set Action field to Push an image. Set image name to xyz/sampleapi:latest. Make sure you replace “xyz” with your actual Docker repo name

Add Copy and Publish Build Artifacts task and configure it as shown below
Save and queue a build by clicking the Save & queue button. For the Agent queue field, select Hosted Linux Preview option

Click Queue and the build should be queued and executed once an agent is available

Setting up Continuous Deployment

Now that we have a build setup, we can set up a release that can deploy the application to our Kubernetes cluster. The following are the steps to do so

Create a deploy file called yml with the content below and check it in to the repository:

 apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: sampleapi-deployment
spec:
  replicas: 3
  template:
    metadata:
      labels:
        app: sampleapi
    spec:
      containers:
      - name: sampleapi
        image: xyz/sampleapi:latest
        ports:
        - containerPort: 80

Download kubectl from here and check it in to the repository
Tab on Build & Release and click Releases
Click on New Definition
Select Empty as the release template and click Next

Check Continuous Deployment option
Click on Add Tasks
Select Kubernetes Apply Task. Click on Add next to k8s end point field and fill out the information for your Kubernetes cluster with information similar to below

For Kubeconfig field, set it to the content from the config file inside .kube directory generated when the az acs kubernetes get-credentials is run as show in the previous post

Click OK to return to the task
Set the YAML file and kubectl binary as shown below

Click on Run on agent and make sure you select Hosted Linux Preview
Click save icon and queue a release and this should conclude setting up Continuous Deployment.

Note: if you make a change to the code, the image version number will need to be updated so that Kubernetes can trigger a deployment. One way to do this is to include a placeholder in the sampleapi.yml as well docker-compose.yml files and then replace these placeholders with actual version numbers for each build during build time. A task such as Replace Tokens can be used to accomplish this substitution.

We have just walked through how to setup CI/CD for a Web API with Docker support running on a Kubernetes cluster. I hope this was informative.

Please leave us your feedback.

Comments

Anonymous
July 19, 2017
Great guide, thanks! One question though: how would you go about getting unit tests to run during the CI stage?

Freigeben über