gitlab-runner-kubevirt

A Gitlab Runner custom executor for running jobs in VMs on kubernetes

Usage

Before you begin, make sure that KubeVirt has been installed to the cluster where you want to run these VM jobs.

Manual Configuration

Add this configuration to your runner:

[[runners]]
name = "kubevirt"
executor = "custom"

  [runners.custom]
  config_exec = "/bin/gitlab-runner-kubevirt"
  config_args = ["config"]
  prepare_exec = "/bin/gitlab-runner-kubevirt"
  prepare_args = [
    "prepare",
    <prepare config flags ...>
  ]
  run_exec = "/bin/gitlab-runner-kubevirt"
  run_args = [
    "run",
    "--shell", "bash",
    <run config flags ...>
  ]
  cleanup_exec = "/bin/gitlab-runner-kubevirt"
  cleanup_args = ["cleanup"]

Various aspects of the virtual machines can be

Using the gitlab-runner helm chart

The gitlab-runner-kubevirt executor can be used with the official gitlab-runner helm chart. Simply add the following to the values:

image: ghcr.io/snaipe/gitlab-runner-kubevirt:main

runners:
  executor: custom
  config: |
    [[runners]]
    name = "kubevirt"
    executor = "custom"

      [runners.custom]
      config_exec = "/bin/gitlab-runner-kubevirt"
      config_args = ["config"]
      prepare_exec = "/bin/gitlab-runner-kubevirt"
      prepare_args = ["prepare"]
      run_exec = "/bin/gitlab-runner-kubevirt"
      run_args = ["run", "--shell", "bash"]
      cleanup_exec = "/bin/gitlab-runner-kubevirt"
      cleanup_args = ["cleanup"]

Examples

Setting up a Windows runner with 2 CPUs and 4GB memory