GitHub - loft-sh/setup-vind: GitHub Action to provision Kubernetes clusters via vCluster Docker driver (vind)

GitHub Action to provision Kubernetes clusters via vCluster's Docker driver (vind). Drop-in replacement for setup-kind.

Usage

jobs:
  e2e:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: loft-sh/setup-vind@v1
        with:
          version: v0.31.0
          name: my-cluster
      - run: kubectl get nodes

With Kubernetes version

- uses: loft-sh/setup-vind@v1
  with:
    kubernetes-version: "1.35.0"

With config file

- uses: loft-sh/setup-vind@v1
  with:
    config: hack/vcluster.yaml

Multi-cluster setup

- uses: loft-sh/setup-vind@v1
  with:
    name: platform
- uses: loft-sh/setup-vind@v1
  with:
    name: agent

Inputs

Input	Default	Description
`version`	`latest`	vCluster CLI version to install
`name`	`vind`	Cluster name
`config`		Path to vcluster.yaml values file (repo-relative)
`kubernetes-version`		Kubernetes version for the cluster
`skipClusterDeletion`	`false`	Skip cluster deletion in post step
`skipClusterLogsExport`	`false`	Skip log export in post step

How it works

Main step: installs vCluster CLI → sets Docker driver (vcluster use driver docker) → creates cluster (vcluster create)

Post step: exports container logs as GitHub artifact → deletes cluster (vcluster delete)

Migrating from setup-kind

setup-kind	setup-vind	Notes
`version: v0.30.0`	`version: v0.31.0`	vCluster CLI version, not KinD
`image: kindest/node:v1.35.0`	`kubernetes-version: "1.35.0"`	No node image needed
`config: kind.yaml`	`config: vcluster.yaml`	Different config format
`kind load docker-image`	(not needed)	Docker images available natively

License

Apache-2.0 — see LICENSE.