How to Integrate GitLab-Ci w/ Azure Kubernetes + Kubectl + ACR for Deployments?
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:
- Inside GitLab, go to "Operations" > "Kubernetes" menu.
- Click on the "Add Kubernetes cluster" button on the top of the page
- 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>
- 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:
-
Kubernetes cluster name: It's the name of your cluster on Azure, it's in the
.kube/config
file too. -
API URL: It's the URL in the field
server
of the.kube/config
file. -
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-----
-
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 ofkubectl apply -f serviceaccount.yml
. - 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 anenvironment
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 runkubectl
commands in the cluster and executes akubectl 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 thiskubectl 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.
Necevil
Updated on June 06, 2022Comments
-
Necevil almost 2 years
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
Will update as I work through the process.