setup-vcluster

This is a GitHub Action to install the vcluster CLI. Windows, Mac, and Linux runners are supported.

Usage

This action will install the vCluster CLI for use in job steps. The default behavior installs the latest release from vCluster Releases. Subsequent steps may run any vcluster CLI command.

To avoid leaking your Loft access key onto GitHub runners, this action will remove the ~/.vcluster directory at the end of the job.

Example: Use a specific vCluster version

name: loft version
on:
  push:
    branches:
      - 'main'
jobs:
  whoami:
    runs-on: ubuntu-latest
    steps:
      - name: Install vCluster CLI
        uses: loft-sh/setup-vcluster@main
        with:
          version: v0.16.0
          kubectl-install: false
      - name: Show Version
        run: vcluster --version

Install kubectl

Options are provided to install kubectl. Many GitHub runners now come with kubectl pre-installed, however this allows for controlling the version of kubectl if desired.

Example: Install the latest vCluster CLI, and install a specific kubectl version

name: vcluster version
on:
  push:
    branches:
      - 'main'
jobs:
  whoami:
    runs-on: ubuntu-latest
    steps:
      - name: Install vCluster CLI
        uses: loft-sh/setup-vcluster@main
        with:
          kubectl-install: true
          kubectl-version: v1.28.2
      - name: Show vCluster Version
        run: vcluster --version
      - name: Show kubectl Version
        run: kubectl --version --client

Customizing

inputs

The following inputs can be used as step.with keys.

Name	Type	Description
version	String	The version of vcluster CLI to install. See Loft Releases for available versions. Defaults to latest.
kubectl-install	Boolean	Install kubectl if not already installed. Defaults to true.
kubectl-version	String	The version of the kubectl to install. Defaults to latest stable version.