How to Integrate GitLab-Ci w/ Azure Kubernetes + Kubectl + ACR for Deployments?

Necevil picture Necevil · Jun 7, 2018 · Viewed 8.4k times · Source

Our previous GitLab based CI/CD utilized an Authenticated curl request to a specific REST API endpoint to trigger the redeployment of an updated container to our service, if you use something similar for your Kubernetes based deployment this Question is for you.

More Background

We run a production site / app (Ghost blog based) on an Azure AKS Cluster. Right now we manually push our updated containers to a private ACR (Azure Container Registry) and then update from the command line with Kubectl.

That being said we previously used Docker Cloud for our orchestration and fully integrated re-deploying our production / staging services using GitLab-Ci.

That GitLab-Ci integration is the goal, and the 'Why' behind this question.

My Question

Since we previously used Docker Cloud (doh, should have gone K8s from the start) how should we handle the fact that GitLab-Ci was able to make use of Secrets created the Docker Cloud CLI and then authenticate with the Docker Cloud API to trigger actions on our Nodes (ie. re-deploy with new containers etc).

While I believe we can build a container (to be used by our GitLab-Ci runner) that contains Kubectl, and the Azure CLI, I know that Kubernetes also has a similar (to docker cloud) Rest API that can be found here (https://kubernetes.io/docs/tasks/access-application-cluster/access-cluster) — specifically the section that talks about connecting WITHOUT Kubectl appears to be relevant (as does the piece about the HTTP REST API).

My Question to anyone who is connecting to an Azure (or potentially other managed Kubernetes service):

How does your Ci/CD server authenticate with your Kubernetes service provider's Management Server, and then how do you currently trigger an update / redeployment of an updated container / service?

If you have used the Kubernetes HTTP Rest API to re-deploy a service your thoughts are particularly value-able!

Kubernetes Resources I am Reviewing

  1. How should I manage deployments with kubernetes
  2. Kubernetes Deployments

Will update as I work through the process.

Answer

lmcarreiro picture lmcarreiro · Jun 9, 2018

Creating the integration

I had the same problem of how to integrate the GitLab CI/CD with my Azure AKS Kubernetes cluster. I created this question because I was having some error when I tried to add my Kubernetes cluester info into GitLab.

How to integrate them:

  1. Inside GitLab, go to "Operations" > "Kubernetes" menu.
  2. Click on the "Add Kubernetes cluster" button on the top of the page
  3. You will have to fill some form fields, to get the content that you have to put into these fields, connect to your Azure account from the CLI (you need Azure CLI installed on your PC) using az login command, and then execute this other command to get the Kubernetes cluster credentials: az aks get-credentials --resource-group <resource-group-name> --name <kubernetes-cluster-name>
  4. The previous command will create a ~/.kube/config file, open this file, the content of the fields that you have to fill in the GitLab "Add Kubernetes cluster" form are all inside this .kube/config file

These are the fields:

  1. Kubernetes cluster name: It's the name of your cluster on Azure, it's in the .kube/config file too.
  2. API URL: It's the URL in the field server of the .kube/config file.
  3. CA Certificate: It's the field certificate-authority-data of the .kube/config file, but you will have to base64 decode it.

After you decode it, it must be something like this:

-----BEGIN CERTIFICATE-----
...
some base64 strings here
...
-----END CERTIFICATE-----
  1. Token: It's the string of hexadecimal chars in the field token of the .kube/config file (it might also need to be base 64 decoded?). You need to use a token belonging to an account with cluster-admin privileges, so GitLab can use it for authenticating and installing stuff on the cluster. The easiest way to achieve this is by creating a new account for GitLab: create a YAML file with the service account definition (an example can be seen here under Create a gitlab service account in the default namespace) and apply it to your cluster by means of kubectl apply -f serviceaccount.yml.
  2. Project namespace (optional, unique): I leave it empty, don't know yet for what or where this namespace can be used.

Click in "Save" and it's done. Your GitLab project must be connected to your Kubernetes cluster now.

Deploy

In your deploy job (in the pipeline), you'll need some environment variables to access your cluster using the kubectl command, here is a list of all the variables available:

https://docs.gitlab.com/ee/user/project/clusters/index.html#deployment-variables

To have these variables injected in your deploy job, there are some conditions:

  • You must have added correctly the Kubernetes cluster into your GitLab project, menu "Operations" > "Kubernetes" and these steps that I described above
  • Your job must be a "deployment job", in GitLab CI, to be considered a deployment job, your job definition (in your .gitlab-ci.yml) must have an environment key (take a look at the line 31 in this example), and the environment name must match the name you used in menu "Operations" > "Environments".

Here are an example of a .gitlab-ci.yml with three stages:

  • Build: it builds a docker image and push it to gitlab private registry
  • Test: it doesn't do anything yet, just put an exit 0 to change it later
  • Deploy: download a stable version of kubectl, copy the .kube/config file to be able to run kubectl commands in the cluster and executes a kubectl cluster-info to make sure it is working. In my project I didn't finish to write my deploy script to really execute a deploy. But this kubectl cluster-info command is executing fine.

Tip: to take a look at all the environment variables and their values (Jenkins has a page with this view, GitLab CI doesn't) you can execute the command env in the script of your deploy stage. It helps a lot to debug a job.