Testing/CI/KubernetesRunners: Difference between revisions

From QEMU
No edit summary
No edit summary
Line 44: Line 44:
  kubectl create namespace "gitlab-runner"
  kubectl create namespace "gitlab-runner"


Create a <code>values.yaml</code> file for your runner configuration [https://docs.gitlab.com/runner/install/kubernetes.html#configuring-gitlab-runner-using-the-helm-chart]:
Create a <code>values.yaml</code> file for your runner configuration [https://docs.gitlab.com/runner/install/kubernetes.html#configuring-gitlab-runner-using-the-helm-chart]
like the snippet below.


gitlabUrl: "https://gitlab.com/"
<code>nodeSelector</code> and <code>tolerations</code> make sure the pods run on the virtual nodes
runnerRegistrationToken: ""
[https://learn.microsoft.com/en-us/azure/aks/virtual-nodes-portal#deploy-a-sample-app]
[https://docs.gitlab.com/runner/executors/kubernetes.html#configuration-example].
 
<pre>
gitlabUrl: "https://gitlab.com/"
runnerRegistrationToken: ""
runners:
  config: |
    [[runners]]
      [runners.kubernetes]
        [runners.kubernetes.node_selector]
          "kubernetes.io/role" = "agent"
          "beta.kubernetes.io/os" = "linux"
          "type" = "virtual-kubelet"
        [runners.kubernetes.node_tolerations]
          "virtual-kubelet.io/provider" = "Exists"
</pre>


Deploy the runner:
Deploy the runner:


  helm install --namespace gitlab-runner gitlab-runner -f values.yaml gitlab/gitlab-runner
  helm install --namespace gitlab-runner gitlab-runner -f values.yaml gitlab/gitlab-runner

Revision as of 10:26, 16 March 2023

To be able to run Gitlab CI jobs on a Kubernetes cluster, a Gitlab Runner must be installed [1].

Deployment

This sections documents the steps taken to deploy a GitLab Runner instance on a Azure Kubernetes cluster by using Helm [2].

Kubernetes Cluster

Create a Kubernetes cluster on Azure (AKS). Single node pool "agentpool" for the Kubernetes system pods. Enable virtual nodes [3] to have on-demand capacity for the CI workloads.

CLI

Follow the docs to Install the Azure CLI.

Alternatively, run the Azure CLI in a container [4]:

podman run -it mcr.microsoft.com/azure-cli

Install the Kubernetes CLI (kubectl) [5]:

az aks install-cli

Install the Helm CLI [6]:

curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

Sign in to Azure [7]:

az login

Connect to your Kubernetes Cluster. Open the Azure web dashboard for your cluster and push the "Connect" button. A list of commands will be displayed to connect to your cluster. Something like the following:

az account set --subscription ...
az aks get-credentials ...

Gitlab

Register the new runner [8].

Gitlab Runner

Now it's time to install the Gitlab runner with Helm [9].

Create a namespace:

kubectl create namespace "gitlab-runner"

Create a values.yaml file for your runner configuration [10] like the snippet below.

nodeSelector and tolerations make sure the pods run on the virtual nodes [11] [12].

gitlabUrl: "https://gitlab.com/"
runnerRegistrationToken: ""
runners:
  config: |
    [[runners]]
      [runners.kubernetes]
        [runners.kubernetes.node_selector]
          "kubernetes.io/role" = "agent"
          "beta.kubernetes.io/os" = "linux"
          "type" = "virtual-kubelet"
        [runners.kubernetes.node_tolerations]
          "virtual-kubelet.io/provider" = "Exists"

Deploy the runner:

helm install --namespace gitlab-runner gitlab-runner -f values.yaml gitlab/gitlab-runner